PHP反射机制：获取函数或方法参数类型列表的实用指南

<?php

class Controller {} // 假设基类存在
class LoginRequest {} // 假设请求类存在

class AuthController extends Controller {
   /**
    * 处理用户登录请求。
    *
    * @param LoginRequest $request 登录请求对象
    * @param int $id 用户ID
    * @return void
    */
   public function store(LoginRequest $request, int $id) {
      // 业务逻辑代码...
   }

   /**
    * 另一个带有更多类型提示的示例方法。
    *
    * @param string $name 用户名
    * @param ?int $age 可选年龄
    * @param array|null $options 选项数组或null
    * @param mixed ...$tags 任意数量的标签
    * @return void
    */
   public function anotherMethod(string $name, ?int $age, array|null $options, ...$tags) {
       // ...
   }
}

?>

<?php

// 引入上述定义的类
// class Controller {}
// class LoginRequest {}
// class AuthController extends Controller { ... }

/**
 * 获取指定类方法的参数类型列表。
 *
 * @param string $methodString 格式为 "ClassName::methodName" 的方法字符串。
 * @return array 包含参数类型名称的数组。
 * @throws InvalidArgumentException 如果类或方法不存在。
 */
function get_arg_types(string $methodString): array
{
    // 解析类名和方法名
    $parts = explode('::', $methodString);
    if (count($parts) !== 2) {
        throw new InvalidArgumentException("Invalid method string format. Expected 'ClassName::methodName'.");
    }
    [$className, $methodName] = $parts;

    // 检查类和方法是否存在
    if (!class_exists($className)) {
        throw new InvalidArgumentException("Class '{$className}' not found.");
    }
    if (!method_exists($className, $methodName)) {
        throw new InvalidArgumentException("Method '{$methodName}' not found in class '{$className}'.");
    }

    // 创建 ReflectionMethod 实例
    $reflectionMethod = new ReflectionMethod($className, $methodName);
    // 获取所有参数的 ReflectionParameter 实例
    $parameters = $reflectionMethod->getParameters();
    $argTypes = [];

    // 遍历每个参数以提取类型信息
    foreach ($parameters as $parameter) {
        $type = $parameter->getType(); // 返回 ReflectionType 或 null

        if ($type === null) {
            // 参数没有类型声明
            $argTypes[] = 'mixed';
        } else {
            // 处理 PHP 8.0+ 的联合类型 (UnionType) 和 PHP 8.1+ 的交集类型 (IntersectionType)
            if ($type instanceof ReflectionUnionType || $type instanceof ReflectionIntersectionType) {
                $typeNames = array_map(fn($t) => $t->getName(), $type->getTypes());
                $separator = ($type instanceof ReflectionUnionType ? '|' : '&');
                $argTypes[] = implode($separator, $typeNames);
            } elseif ($type instanceof ReflectionNamedType) {
                // 处理 PHP 7.0+ 的命名类型 (NamedType)，如 int, string, ClassName
                $typeName = $type->getName();
                // 如果需要，可以根据 allowsNull() 判断是否为可空类型，并添加 '?' 前缀
                // if ($type->allowsNull() && $typeName !== 'null') {
                //     $typeName = '?' . $typeName;
                // }
                $argTypes[] = $typeName;
            } else {
                // 针对未来 ReflectionType 的实现，提供一个通用字符串表示
                $argTypes[] = (string) $type;
            }
        }
    }
    return $argTypes;
}

// --- 使用示例 ---

echo "获取 AuthController::store() 方法的参数类型：\n";
print_r(get_arg_types('AuthController::store'));
/* 预期输出:
Array
(
    [0] => LoginRequest
    [1] => int
)
*/

echo "\n获取 AuthController::anotherMethod() 方法的参数类型：\n";
print_r(get_arg_types('AuthController::anotherMethod'));
/* 预期输出 (取决于 PHP 版本和具体实现，以下是 PHP 8.1+ 示例):
Array
(
    [0] => string
    [1] => int
    [2] => array|null
    [3] => array // 可变参数通常被识别为数组
)
*/

// 尝试获取不存在的方法或类的类型
try {
    get_arg_types('NonExistentClass::someMethod');
} catch (InvalidArgumentException $e) {
    echo "\n错误: " . $e->getMessage() . "\n"; // 输出: Class 'NonExistentClass' not found.
}

try {
    get_arg_types('AuthController::nonExistentMethod');
} catch (InvalidArgumentException $e) {
    echo "\n错误: " . $e->getMessage() . "\n"; // 输出: Method 'nonExistentMethod' not found in class 'AuthController'.
}

?>