Merge branch 'PHP-8.1' into PHP-8.2

* PHP-8.1:
  [ci skip] NEWS
  [ci skip] NEWS
  Add tests
  Fix phpGH-8932: Provide a way to get the called-scope of closures (php#9299)

Author: arnaud-lb

ext/reflection/php_reflection.c

@@ -1701,6 +1701,28 @@ ZEND_METHOD(ReflectionFunctionAbstract, getClosureScopeClass)
 }
 /* }}} */
 
+/* {{{ Returns the called scope associated to the closure */
+ZEND_METHOD(ReflectionFunctionAbstract, getClosureCalledClass)
+{
+	reflection_object *intern;
+
+	if (zend_parse_parameters_none() == FAILURE) {
+		RETURN_THROWS();
+	}
+	GET_REFLECTION_OBJECT();
+	if (!Z_ISUNDEF(intern->obj)) {
+		zend_class_entry *called_scope;
+		zend_function *closure_func;
+		zend_object *object;
+		if (Z_OBJ_HANDLER(intern->obj, get_closure)
+		 && Z_OBJ_HANDLER(intern->obj, get_closure)(Z_OBJ(intern->obj), &called_scope, &closure_func, &object, 1) == SUCCESS
+		 && closure_func && (called_scope || closure_func->common.scope)) {
+			zend_reflection_class_factory(called_scope ? (zend_class_entry *) called_scope : closure_func->common.scope, return_value);
+		}
+	}
+}
+/* }}} */
+
 /* {{{ Returns an associative array containing the closures lexical scope variables */
 ZEND_METHOD(ReflectionFunctionAbstract, getClosureUsedVariables)
 {

ext/reflection/php_reflection.stub.php

@@ -54,6 +54,9 @@ public function getClosureThis(): ?object {}
     /** @tentative-return-type */
     public function getClosureScopeClass(): ?ReflectionClass {}
 
+    /** @tentative-return-type */
+    public function getClosureCalledClass(): ?ReflectionClass {}
+
     public function getClosureUsedVariables(): array {}
 
     /** @tentative-return-type */

ext/reflection/php_reflection_arginfo.h

@@ -0,0 +1,108 @@
+--TEST--
+GH-8932 (Provide a way to get the called-scope of closures)
+--FILE--
+<?php
+class A {
+    public static function __callStatic($name, $args) {
+        echo static::class.'::'.$name, "\n";
+    }
+
+    public function __call($name, $args) {
+        echo static::class.'->'.$name, "\n";
+    }
+
+    public static function b() {
+        echo static::class.'::b', "\n";
+    }
+
+
+    public function c() {
+        echo static::class.'->c', "\n";
+    }
+
+    public function makeClosure() {
+        return function () {
+            echo static::class.'::{closure}'."\n";
+        };
+    }
+}
+
+class B extends A {}
+
+$c = ['B', 'b'];
+$d = \Closure::fromCallable($c);
+$r = new \ReflectionFunction($d);
+var_dump($r->getClosureCalledClass());
+$d();
+
+$c = [new B(), 'c'];
+$d = \Closure::fromCallable($c);
+$r = new \ReflectionFunction($d);
+var_dump($r->getClosureCalledClass());
+$d();
+
+$c = ['B', 'd'];
+$d = \Closure::fromCallable($c);
+$r = new \ReflectionFunction($d);
+var_dump($r->getClosureCalledClass());
+$d();
+
+$c = [new B(), 'e'];
+$d = \Closure::fromCallable($c);
+$r = new \ReflectionFunction($d);
+var_dump($r->getClosureCalledClass());
+$d();
+
+$c = ['A', 'b'];
+$d = \Closure::fromCallable($c);
+$r = new \ReflectionFunction($d);
+var_dump($r->getClosureCalledClass());
+$d();
+
+$b = new B();
+$d = $b->makeClosure();
+$r = new \ReflectionFunction($d);
+var_dump($r->getClosureCalledClass());
+$d();
+
+$d = function () {
+    echo "{closure}\n";
+};
+$r = new \ReflectionFunction($d);
+var_dump($r->getClosureCalledClass());
+$d();
+
+?>
+--EXPECTF--
+object(ReflectionClass)#%d (1) {
+  ["name"]=>
+  string(1) "B"
+}
+B::b
+object(ReflectionClass)#%d (1) {
+  ["name"]=>
+  string(1) "B"
+}
+B->c
+object(ReflectionClass)#%d (1) {
+  ["name"]=>
+  string(1) "B"
+}
+B::d
+object(ReflectionClass)#%d (1) {
+  ["name"]=>
+  string(1) "B"
+}
+B->e
+object(ReflectionClass)#%d (1) {
+  ["name"]=>
+  string(1) "A"
+}
+A::b
+object(ReflectionClass)#%d (1) {
+  ["name"]=>
+  string(1) "B"
+}
+B::{closure}
+NULL
+{closure}