PHP 8.4 support

.github/workflows/continuous-integration.yml

@@ -24,6 +24,7 @@ jobs:
         php-version:
           - "8.2"
           - "8.3"
+          - "8.4"
         operating-system:
           - "ubuntu-latest"
           - "windows-latest"
@@ -67,6 +68,7 @@ jobs:
         php-version:
           - "8.2"
           - "8.3"
+          - "8.4"
         operating-system:
           - "ubuntu-latest"
 
@@ -107,6 +109,7 @@ jobs:
         dependencies:
           - "locked"
         php-version:
+          # Throws deprecated errors on 8.4
           - "8.3"
         operating-system:
           - "ubuntu-latest"
@@ -148,6 +151,7 @@ jobs:
         dependencies:
           - "locked"
         php-version:
+            # Does not work on 8.4
           - "8.3"
         operating-system:
           - "ubuntu-latest"
@@ -192,7 +196,7 @@ jobs:
         dependencies:
           - "locked"
         php-version:
-          - "8.3"
+          - "8.4"
         operating-system:
           - "ubuntu-latest"
           - "windows-latest"
@@ -234,7 +238,7 @@ jobs:
         dependencies:
           - "locked"
         php-version:
-          - "8.3"
+          - "8.4"
         operating-system:
           - "ubuntu-latest"
 
@@ -268,7 +272,7 @@ jobs:
         dependencies:
           - "locked"
         php-version:
-          - "8.3"
+          - "8.4"
         operating-system:
           - "ubuntu-latest"
           - "windows-latest"
@@ -347,7 +351,7 @@ jobs:
         dependencies:
           - "locked"
         php-version:
-          - "8.3"
+          - "8.4"
         operating-system:
           - "ubuntu-latest"
 

composer.json

@@ -3,7 +3,7 @@
     "description": "Better Reflection - an improved code reflection API",
     "license": "MIT",
     "require": {
-        "php": "~8.2.0 || ~8.3.2",
+        "php": "~8.2.0 || ~8.3.2 || ~8.4.1",
         "ext-json": "*",
         "jetbrains/phpstorm-stubs": "2024.2",
         "nikic/php-parser": "^5.3.1"

phpstan.neon

@@ -25,6 +25,10 @@ parameters:
         - phar://%currentWorkingDirectory%/test/unit/Fixture/autoload.phar/vendor/autoload.php
 
     ignoreErrors:
+        -
+            identifier: class.notFound
+            message: '#(unknown class|invalid type) PropertyHookType#'
+
         -
             identifier: missingType.generics
         -

psalm-baseline.xml

@@ -144,11 +144,15 @@
       <code><![CDATA[getEndLine]]></code>
       <code><![CDATA[getEndLine]]></code>
       <code><![CDATA[getEndLine]]></code>
+      <code><![CDATA[getEndLine]]></code>
+      <code><![CDATA[getReturnType]]></code>
+      <code><![CDATA[getStartLine]]></code>
       <code><![CDATA[getStartLine]]></code>
       <code><![CDATA[getStartLine]]></code>
       <code><![CDATA[getStartLine]]></code>
       <code><![CDATA[getStartLine]]></code>
       <code><![CDATA[getStmts]]></code>
+      <code><![CDATA[getStmts]]></code>
       <code><![CDATA[getSubNodeNames]]></code>
       <code><![CDATA[traverse]]></code>
     </ImpureMethodCall>
@@ -201,14 +205,22 @@
     <ImpureMethodCall>
       <code><![CDATA[__invoke]]></code>
       <code><![CDATA[classExists]]></code>
+      <code><![CDATA[createFromNode]]></code>
       <code><![CDATA[getEndLine]]></code>
       <code><![CDATA[getStartLine]]></code>
+      <code><![CDATA[getStmts]]></code>
+      <code><![CDATA[getStmts]]></code>
       <code><![CDATA[isPrivate]]></code>
+      <code><![CDATA[isPrivateSet]]></code>
       <code><![CDATA[isProtected]]></code>
+      <code><![CDATA[isProtectedSet]]></code>
+      <code><![CDATA[isPublic]]></code>
       <code><![CDATA[isPublic]]></code>
       <code><![CDATA[isReadonly]]></code>
       <code><![CDATA[isStatic]]></code>
       <code><![CDATA[traitExists]]></code>
+      <code><![CDATA[traverse]]></code>
+      <code><![CDATA[traverse]]></code>
     </ImpureMethodCall>
   </file>
   <file src="src/Reflection/ReflectionType.php">

src/Reflection/Adapter/Exception/NotImplementedBecauseItTriggersAutoloading.php

@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Roave\BetterReflection\Reflection\Adapter\Exception;
+
+class NotImplementedBecauseItTriggersAutoloading extends NotImplemented
+{
+    public static function create(): self
+    {
+        return new self('Not implemented because it triggers autoloading');
+    }
+}

src/Reflection/Adapter/ReflectionAttribute.php

@@ -5,14 +5,18 @@
 namespace Roave\BetterReflection\Reflection\Adapter;
 
 use Attribute;
+use OutOfBoundsException;
 use ReflectionAttribute as CoreReflectionAttribute;
 use Roave\BetterReflection\Reflection\ReflectionAttribute as BetterReflectionAttribute;
 
+use function sprintf;
+
 /** @template-extends CoreReflectionAttribute<object> */
 final class ReflectionAttribute extends CoreReflectionAttribute
 {
     public function __construct(private BetterReflectionAttribute $betterReflectionAttribute)
     {
+        unset($this->name);
     }
 
     /** @psalm-mutation-free */
@@ -44,14 +48,24 @@ public function getArguments(): array
         return $this->betterReflectionAttribute->getArguments();
     }
 
+    /** @return never */
     public function newInstance(): object
     {
-        throw new Exception\NotImplemented('Not implemented');
+        throw Exception\NotImplementedBecauseItTriggersAutoloading::create();
     }
 
     /** @return non-empty-string */
     public function __toString(): string
     {
         return $this->betterReflectionAttribute->__toString();
     }
+
+    public function __get(string $name): mixed
+    {
+        if ($name === 'name') {
+            return $this->betterReflectionAttribute->getName();
+        }
+
+        throw new OutOfBoundsException(sprintf('Property %s::$%s does not exist.', self::class, $name));
+    }
 }

src/Reflection/Adapter/ReflectionClass.php

@@ -33,6 +33,20 @@
  */
 final class ReflectionClass extends CoreReflectionClass
 {
+    /**
+     * @internal
+     *
+     * @see CoreReflectionClass::SKIP_INITIALIZATION_ON_SERIALIZE_COMPATIBILITY
+     */
+    public const SKIP_INITIALIZATION_ON_SERIALIZE_COMPATIBILITY = 8;
+
+    /**
+     * @internal
+     *
+     * @see CoreReflectionClass::SKIP_DESTRUCTOR
+     */
+    public const SKIP_DESTRUCTOR_COMPATIBILITY = 16;
+
     public function __construct(private BetterReflectionClass|BetterReflectionEnum $betterReflectionClass)
     {
         unset($this->name);
@@ -435,19 +449,78 @@ public function isInstance(object $object): bool
         return $this->betterReflectionClass->isInstance($object);
     }
 
+    /** @return never */
     public function newInstance(mixed ...$args): self
     {
-        throw new Exception\NotImplemented('Not implemented');
+        throw Exception\NotImplementedBecauseItTriggersAutoloading::create();
     }
 
+    /** @return never */
     public function newInstanceWithoutConstructor(): object
     {
-        throw new Exception\NotImplemented('Not implemented');
+        throw Exception\NotImplementedBecauseItTriggersAutoloading::create();
     }
 
+    /** @return never */
     public function newInstanceArgs(array|null $args = null): object
     {
-        throw new Exception\NotImplemented('Not implemented');
+        throw Exception\NotImplementedBecauseItTriggersAutoloading::create();
+    }
+
+    /**
+     * @param int-mask-of<self::SKIP_*> $options
+     *
+     * @return never
+     */
+    public function newLazyGhost(callable $initializer, int $options = 0): object
+    {
+        throw Exception\NotImplementedBecauseItTriggersAutoloading::create();
+    }
+
+    /**
+     * @param int-mask-of<self::SKIP_*> $options
+     *
+     * @return never
+     */
+    public function newLazyProxy(callable $factory, int $options = 0): object
+    {
+        throw Exception\NotImplementedBecauseItTriggersAutoloading::create();
+    }
+
+    /** @return never */
+    public function markLazyObjectAsInitialized(object $object): object
+    {
+        throw Exception\NotImplementedBecauseItTriggersAutoloading::create();
+    }
+
+    /** @return never */
+    public function getLazyInitializer(object $object): callable|null
+    {
+        throw Exception\NotImplementedBecauseItTriggersAutoloading::create();
+    }
+
+    /** @return never */
+    public function initializeLazyObject(object $object): object
+    {
+        throw Exception\NotImplementedBecauseItTriggersAutoloading::create();
+    }
+
+    /** @return never */
+    public function isUninitializedLazyObject(object $object): bool
+    {
+        throw Exception\NotImplementedBecauseItTriggersAutoloading::create();
+    }
+
+    /** @param int-mask-of<self::SKIP_*> $options */
+    public function resetAsLazyGhost(object $object, callable $initializer, int $options = 0): never
+    {
+        throw Exception\NotImplementedBecauseItTriggersAutoloading::create();
+    }
+
+    /** @param int-mask-of<self::SKIP_*> $options */
+    public function resetAsLazyProxy(object $object, callable $factory, int $options = 0): never
+    {
+        throw Exception\NotImplementedBecauseItTriggersAutoloading::create();
     }
 
     /** @psalm-mutation-free */
@@ -566,7 +639,11 @@ public function implementsInterface(CoreReflectionClass|string $interface): bool
         return $this->betterReflectionClass->implementsInterface($realInterfaceName);
     }
 
-    /** @psalm-mutation-free */
+    /**
+     * @return never
+     *
+     * @psalm-mutation-free
+     */
     public function getExtension(): CoreReflectionExtension|null
     {
         throw new Exception\NotImplemented('Not implemented');

src/Reflection/Adapter/ReflectionClassConstant.php

@@ -160,6 +160,11 @@ public function isEnumCase(): bool
         return $this->betterClassConstantOrEnumCase instanceof BetterReflectionEnumCase;
     }
 
+    public function isDeprecated(): bool
+    {
+        return $this->betterClassConstantOrEnumCase->isDeprecated();
+    }
+
     public function __get(string $name): mixed
     {
         if ($name === 'name') {