PurHur · Jul 22, 2026 · Jul 22, 2026
diff --git a/docs/bootstrap-inventory.md b/docs/bootstrap-inventory.md
diff --git a/lib/Func/PHP.php b/lib/Func/PHP.php
@@ -11,6 +11,7 @@
 
 use PHPCompiler\Compiler\AttributeEntry;
 use PHPCompiler\Compiler\DeprecatedMetadata;
+use PHPCompiler\Compiler\SourceLocation;
 use PHPCompiler\Func;
 use PHPCompiler\Frame;
 use PHPCompiler\Block;
@@ -21,6 +22,8 @@ final class PHP extends Func {
     public Block $block;
     /** #[\Deprecated] metadata when declared on this function/method (#3569). */
     public ?DeprecatedMetadata $deprecated = null;
+    /** Compile-time docblock + declaration site for ReflectionFunction (#22144 / #7358). */
+    public ?SourceLocation $sourceLocation = null;
     /** @var list<\PHPCompiler\Compiler\ParameterMetadata> */
     public array $parameterMetadata = [];
     /** @var list<string> */

diff --git a/lib/VM.php b/lib/VM.php
@@ -5541,6 +5541,7 @@ private function runFramesInner(): int
                         ? $op->block1->func->name
                         : '{closure}';
                     $closureFunc = new Func\PHP($funcName, $op->block1);
+                    $closureFunc->sourceLocation = $op->sourceLocation;
                     if ([] !== $op->parameterMetadata) {
                         $closureFunc->parameterMetadata = $op->parameterMetadata;
                     }
@@ -5622,6 +5623,7 @@ private function runFramesInner(): int
                         throw new \LogicException("Duplicate function definition for $lcname()");
                     }
                     $func = new Func\PHP($name, $op->block1);
+                    $func->sourceLocation = $op->sourceLocation;
                     $func->deprecated = $op->deprecatedMetadata;
                     if ([] !== $op->parameterMetadata) {
                         $func->parameterMetadata = $op->parameterMetadata;

diff --git a/lib/VM/Builtin/ReflectionFunctionGetDocComment.php b/lib/VM/Builtin/ReflectionFunctionGetDocComment.php
@@ -0,0 +1,34 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PHPCompiler\VM\Builtin;
+
+use PHPCompiler\ext\standard\VmReflection;
+use PHPCompiler\Frame;
+use PHPCompiler\VM\ReflectionSupport;
+
+/** ReflectionFunction::getDocComment() — VM (#22144, ext/reflection/php_reflection.c). */
+final class ReflectionFunctionGetDocComment extends VmClassMethod
+{
+    public function __construct()
+    {
+        parent::__construct('getDocComment');
+    }
+
+    public function execute(Frame $frame): void
+    {
+        $ctx = VmReflection::requireContext($frame);
+        $receiver = ReflectionSupport::requireReflectionFunction($frame, $frame->calledArgs[0]);
+        if (null === $frame->returnVar) {
+            return;
+        }
+        if (ReflectionSupport::isReflectionInternalFunction($receiver)) {
+            $frame->returnVar->bool(false);
+
+            return;
+        }
+        $loc = ReflectionSupport::functionSourceLocation($ctx, $receiver);
+        ReflectionSupport::returnDocComment($frame->returnVar, $loc?->docComment);
+    }
+}
diff --git a/lib/VM/Builtin/ReflectionFunctionGetEndLine.php b/lib/VM/Builtin/ReflectionFunctionGetEndLine.php
@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PHPCompiler\VM\Builtin;
+
+use PHPCompiler\ext\standard\VmReflection;
+use PHPCompiler\Frame;
+use PHPCompiler\VM\ReflectionSupport;
+
+/** ReflectionFunction::getEndLine() — VM (#22144, ext/reflection/php_reflection.c). */
+final class ReflectionFunctionGetEndLine extends VmClassMethod
+{
+    public function __construct()
+    {
+        parent::__construct('getEndLine');
+    }
+
+    public function execute(Frame $frame): void
+    {
+        $ctx = VmReflection::requireContext($frame);
+        $receiver = ReflectionSupport::requireReflectionFunction($frame, $frame->calledArgs[0]);
+        ReflectionSupport::returnFunctionEndLine(
+            $frame->returnVar,
+            ReflectionSupport::functionSourceLocation($ctx, $receiver),
+            ReflectionSupport::isReflectionInternalFunction($receiver)
+        );
+    }
+}
diff --git a/lib/VM/Builtin/ReflectionFunctionGetFileName.php b/lib/VM/Builtin/ReflectionFunctionGetFileName.php
@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PHPCompiler\VM\Builtin;
+
+use PHPCompiler\ext\standard\VmReflection;
+use PHPCompiler\Frame;
+use PHPCompiler\VM\ReflectionSupport;
+
+/** ReflectionFunction::getFileName() — VM (#22144, ext/reflection/php_reflection.c). */
+final class ReflectionFunctionGetFileName extends VmClassMethod
+{
+    public function __construct()
+    {
+        parent::__construct('getFileName');
+    }
+
+    public function execute(Frame $frame): void
+    {
+        $ctx = VmReflection::requireContext($frame);
+        $receiver = ReflectionSupport::requireReflectionFunction($frame, $frame->calledArgs[0]);
+        ReflectionSupport::returnFunctionFileName(
+            $frame->returnVar,
+            ReflectionSupport::functionSourceLocation($ctx, $receiver),
+            ReflectionSupport::isReflectionInternalFunction($receiver)
+        );
+    }
+}
diff --git a/lib/VM/Builtin/ReflectionFunctionGetNamespaceName.php b/lib/VM/Builtin/ReflectionFunctionGetNamespaceName.php
@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PHPCompiler\VM\Builtin;
+
+use PHPCompiler\Frame;
+use PHPCompiler\VM\ReflectionSupport;
+
+/** ReflectionFunction::getNamespaceName() — VM (#22144, ext/reflection/php_reflection.c). */
+final class ReflectionFunctionGetNamespaceName extends VmClassMethod
+{
+    public function __construct()
+    {
+        parent::__construct('getNamespaceName');
+    }
+
+    public function execute(Frame $frame): void
+    {
+        $receiver = ReflectionSupport::requireReflectionFunction($frame, $frame->calledArgs[0]);
+        if (null !== $frame->returnVar) {
+            $frame->returnVar->string(ReflectionSupport::functionNamespaceNameFromReflection($receiver));
+        }
+    }
+}
diff --git a/lib/VM/Builtin/ReflectionFunctionGetShortName.php b/lib/VM/Builtin/ReflectionFunctionGetShortName.php
@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PHPCompiler\VM\Builtin;
+
+use PHPCompiler\Frame;
+use PHPCompiler\VM\ReflectionSupport;
+
+/** ReflectionFunction::getShortName() — VM (#22144, ext/reflection/php_reflection.c). */
+final class ReflectionFunctionGetShortName extends VmClassMethod
+{
+    public function __construct()
+    {
+        parent::__construct('getShortName');
+    }
+
+    public function execute(Frame $frame): void
+    {
+        $receiver = ReflectionSupport::requireReflectionFunction($frame, $frame->calledArgs[0]);
+        if (null !== $frame->returnVar) {
+            $frame->returnVar->string(ReflectionSupport::functionShortNameFromReflection($receiver));
+        }
+    }
+}
diff --git a/lib/VM/Builtin/ReflectionFunctionGetStartLine.php b/lib/VM/Builtin/ReflectionFunctionGetStartLine.php
@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PHPCompiler\VM\Builtin;
+
+use PHPCompiler\ext\standard\VmReflection;
+use PHPCompiler\Frame;
+use PHPCompiler\VM\ReflectionSupport;
+
+/** ReflectionFunction::getStartLine() — VM (#22144, ext/reflection/php_reflection.c). */
+final class ReflectionFunctionGetStartLine extends VmClassMethod
+{
+    public function __construct()
+    {
+        parent::__construct('getStartLine');
+    }
+
+    public function execute(Frame $frame): void
+    {
+        $ctx = VmReflection::requireContext($frame);
+        $receiver = ReflectionSupport::requireReflectionFunction($frame, $frame->calledArgs[0]);
+        ReflectionSupport::returnFunctionStartLine(
+            $frame->returnVar,
+            ReflectionSupport::functionSourceLocation($ctx, $receiver),
+            ReflectionSupport::isReflectionInternalFunction($receiver)
+        );
+    }
+}
diff --git a/lib/VM/Builtin/ReflectionFunctionInNamespace.php b/lib/VM/Builtin/ReflectionFunctionInNamespace.php
@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PHPCompiler\VM\Builtin;
+
+use PHPCompiler\Frame;
+use PHPCompiler\VM\ReflectionSupport;
+
+/** ReflectionFunction::inNamespace() — VM (#22144, ext/reflection/php_reflection.c). */
+final class ReflectionFunctionInNamespace extends VmClassMethod
+{
+    public function __construct()
+    {
+        parent::__construct('inNamespace');
+    }
+
+    public function execute(Frame $frame): void
+    {
+        $receiver = ReflectionSupport::requireReflectionFunction($frame, $frame->calledArgs[0]);
+        if (null !== $frame->returnVar) {
+            $frame->returnVar->bool(ReflectionSupport::functionInNamespaceFromReflection($receiver));
+        }
+    }
+}
diff --git a/lib/VM/BuiltinClasses.php b/lib/VM/BuiltinClasses.php
@@ -254,6 +254,13 @@
 use PHPCompiler\VM\Builtin\ReflectionFunctionGetAttributes;
 use PHPCompiler\VM\Builtin\ReflectionFunctionGetExtension;
 use PHPCompiler\VM\Builtin\ReflectionFunctionGetExtensionName;
+use PHPCompiler\VM\Builtin\ReflectionFunctionGetFileName;
+use PHPCompiler\VM\Builtin\ReflectionFunctionGetDocComment;
+use PHPCompiler\VM\Builtin\ReflectionFunctionGetEndLine;
+use PHPCompiler\VM\Builtin\ReflectionFunctionGetStartLine;
+use PHPCompiler\VM\Builtin\ReflectionFunctionGetNamespaceName;
+use PHPCompiler\VM\Builtin\ReflectionFunctionGetShortName;
+use PHPCompiler\VM\Builtin\ReflectionFunctionInNamespace;
 use PHPCompiler\VM\Builtin\ReflectionFunctionGetName;
 use PHPCompiler\VM\Builtin\ReflectionFunctionGetNamedArguments;
 use PHPCompiler\VM\Builtin\ReflectionFunctionGetNumberOfParameters;
@@ -1095,6 +1102,13 @@ private static function registerReflection(Context $ctx): void
                 'isvariadic' => new ReflectionFunctionIsVariadic(),
                 'getextensionname' => new ReflectionFunctionGetExtensionName(),
                 'getextension' => new ReflectionFunctionGetExtension(),
+                'getfilename' => new ReflectionFunctionGetFileName(),
+                'getdoccomment' => new ReflectionFunctionGetDocComment(),
+                'getstartline' => new ReflectionFunctionGetStartLine(),
+                'getendline' => new ReflectionFunctionGetEndLine(),
+                'getnamespacename' => new ReflectionFunctionGetNamespaceName(),
+                'getshortname' => new ReflectionFunctionGetShortName(),
+                'innamespace' => new ReflectionFunctionInNamespace(),
                 'getclosurethis' => new ReflectionFunctionGetClosureThis(),
                 'getclosure' => new ReflectionFunctionGetClosure(),
                 'getclosurescopeclass' => new ReflectionFunctionGetClosureScopeClass(),

diff --git a/lib/VM/ReflectionSupport.php b/lib/VM/ReflectionSupport.php
@@ -2722,6 +2722,127 @@ public static function methodSourceLocation(ClassEntry $entry, string $methodLc)
         return $entry->methodSourceLocations[$methodLc] ?? null;
     }
 
+    /**
+     * ReflectionFunction source metadata — Func\PHP::$sourceLocation or ClosureState (#22144).
+     */
+    public static function functionSourceLocation(Context $ctx, ObjectEntry $reflection): ?SourceLocation
+    {
+        $state = $reflection->reflectionClosureState;
+        if (null !== $state) {
+            $func = $state->func;
+            if ($func instanceof Func\PHP && null !== $func->sourceLocation) {
+                return $func->sourceLocation;
+            }
+            if ('' !== $state->definitionFile || $state->definitionLine > 0) {
+                return new SourceLocation(
+                    null,
+                    $state->definitionLine,
+                    $state->definitionLine,
+                    $state->definitionFile
+                );
+            }
+
+            return null;
+        }
+        if ($reflection->reflectionIsInternalFunction) {
+            return null;
+        }
+        $name = self::functionNameFromReflection($reflection);
+        $func = $ctx->functions[strtolower($name)] ?? null;
+        if ($func instanceof Func\PHP) {
+            return $func->sourceLocation;
+        }
+
+        return null;
+    }
+
+    /**
+     * ReflectionFunction::getShortName() — php-src suffix after last backslash; closures → {closure} (#22144).
+     */
+    public static function functionShortNameFromReflection(ObjectEntry $reflection): string
+    {
+        $state = $reflection->reflectionClosureState;
+        if (null !== $state && $state->isUserClosure()) {
+            return '{closure}';
+        }
+
+        return self::globalConstantShortName(self::functionNameFromReflection($reflection));
+    }
+
+    /**
+     * ReflectionFunction::getNamespaceName() — php-src prefix before last backslash (#22144).
+     */
+    public static function functionNamespaceNameFromReflection(ObjectEntry $reflection): string
+    {
+        $state = $reflection->reflectionClosureState;
+        if (null !== $state && $state->isUserClosure()) {
+            // Named display is {anonymous}#N without NS; Zend uses declaring namespace.
+            // Prefer Func name when it is Demo\{closure}-shaped; else empty until tracked.
+            $name = $state->func->getName();
+            if (str_contains($name, '\\')) {
+                return self::globalConstantNamespaceName($name);
+            }
+
+            return '';
+        }
+
+        return self::globalConstantNamespaceName(self::functionNameFromReflection($reflection));
+    }
+
+    /** ReflectionFunction::inNamespace() — php-src (#22144). */
+    public static function functionInNamespaceFromReflection(ObjectEntry $reflection): bool
+    {
+        return '' !== self::functionNamespaceNameFromReflection($reflection);
+    }
+
+    /**
+     * ReflectionFunction::{getFileName,getStartLine,getEndLine} — false for internals / missing (#22144).
+     */
+    public static function returnFunctionFileName(?Variable $returnVar, ?SourceLocation $location, bool $isInternal): void
+    {
+        if (null === $returnVar) {
+            return;
+        }
+        if ($isInternal || null === $location) {
+            $returnVar->bool(false);
+
+            return;
+        }
+        $file = $location->filename;
+        if ('' === $file || 'unknown' === $file) {
+            $returnVar->bool(false);
+
+            return;
+        }
+        $returnVar->string($file);
+    }
+
+    public static function returnFunctionStartLine(?Variable $returnVar, ?SourceLocation $location, bool $isInternal): void
+    {
+        if (null === $returnVar) {
+            return;
+        }
+        if ($isInternal || null === $location || $location->startLine <= 0) {
+            $returnVar->bool(false);
+
+            return;
+        }
+        $returnVar->int($location->startLine);
+    }
+
+    public static function returnFunctionEndLine(?Variable $returnVar, ?SourceLocation $location, bool $isInternal): void
+    {
+        if (null === $returnVar) {
+            return;
+        }
+        if ($isInternal || null === $location || $location->endLine <= 0) {
+            $returnVar->bool(false);
+
+            return;
+        }
+        $returnVar->int($location->endLine);
+    }
+
     public static function propertySourceLocation(Context $ctx, ClassEntry $entry, string $property): ?SourceLocation
     {
         $lc = strtolower($property);

diff --git a/prelinked/bootstrap-gen0/.bootstrap_lowering_source.sha b/prelinked/bootstrap-gen0/.bootstrap_lowering_source.sha
@@ -1 +1 @@
-bad85658802e26cc4d82f8982208ad5d4f8ebaa472a20405e0dbc264116b27ec
+d2903f20d992e1d2964b512eb44b5ca36f713cd12f9fedb62b1440097e30af52
Original file line number	Diff line number	Diff line change
		@@ -1 +1 @@
		bad85658802e26cc4d82f8982208ad5d4f8ebaa472a20405e0dbc264116b27ec
		d2903f20d992e1d2964b512eb44b5ca36f713cd12f9fedb62b1440097e30af52