PHP反射：动态获取函数/方法参数类型列表

<?php

class AuthController extends Controller {
   public function store(LoginRequest $request, int $id, ?string $name = null, array|null $options = null) {
      // ...
   }
}

// 实例化ReflectionMethod
$reflectionMethod = new ReflectionMethod('AuthController', 'store');

$parameters = $reflectionMethod->getParameters();
// $parameters 将是一个 ReflectionParameter 对象的数组

// 假设 $parameter 是一个 ReflectionParameter 实例
$type = $parameter->getType();

if ($type === null) {
    // 参数没有类型提示
    $typeName = 'mixed'; // 或者你可以选择其他表示方式，如 'unknown'
} elseif ($type instanceof ReflectionUnionType || $type instanceof ReflectionIntersectionType) {
    // PHP 8+ 的联合类型或交叉类型
    $typeNames = [];
    foreach ($type->getTypes() as $unionOrIntersectionType) {
        $typeNames[] = $unionOrIntersectionType->getName();
    }
    // 根据类型是联合还是交叉，用 | 或 & 连接
    $typeName = implode($type instanceof ReflectionUnionType ? '|' : '&', $typeNames);
} else {
    // 标准的命名类型（ReflectionNamedType）
    $typeName = $type->getName();
    // 检查是否允许为null，并在类型前添加 '?'
    if ($type->allowsNull() && $typeName !== 'null') { // 'null'类型本身不需要加'?'
        $typeName = '?' . $typeName;
    }
}

<?php

// 模拟依赖和控制器类
class LoginRequest { /* ... */ }
class Controller { /* ... */ }

class AuthController extends Controller {
   public function store(LoginRequest $request, int $id, ?string $name = null, array|null $options = null) {
      // 示例方法体
   }

   public function anotherMethod(string $param1, $param2, bool $flag = false) {
       // $param2 没有类型提示
   }

   public static function staticMethod(float $value) {
       // 静态方法
   }
}

/**
 * 获取指定方法的所有参数类型列表。
 *
 * @param string $methodString 格式如 'ClassName::methodName'
 * @return array 一个包含参数类型名称的数组
 * @throws ReflectionException 如果类或方法不存在
 */
function get_arg_types(string $methodString): array
{
    // 分割类名和方法名
    if (strpos($methodString, '::') === false) {
        throw new ReflectionException("Invalid method string format. Expected 'ClassName::methodName'.");
    }
    list($className, $methodName) = explode('::', $methodString);

    // 检查类是否存在
    if (!class_exists($className)) {
        throw new ReflectionException("Class '{$className}' not found.");
    }

    try {
        // 实例化 ReflectionMethod
        $reflectionMethod = new ReflectionMethod($className, $methodName);
    } catch (ReflectionException $e) {
        throw new ReflectionException("Method '{$methodName}' not found in class '{$className}'. " . $e->getMessage(), 0, $e);
    }

    $paramTypes = [];
    foreach ($reflectionMethod->getParameters() as $parameter) {
        $type = $parameter->getType();
        $typeName = '';

        if ($type === null) {
            // 参数没有类型提示，使用 'mixed' 表示
            $typeName = 'mixed';
        } elseif ($type instanceof ReflectionUnionType || $type instanceof ReflectionIntersectionType) {
            // 处理 PHP 8+ 的联合类型或交叉类型
            $unionOrIntersectionTypeNames = [];
            foreach ($type->getTypes() as $subType) {
                $unionOrIntersectionTypeNames[] = $subType->getName();
            }
            // 根据类型是联合还是交叉，用 | 或 & 连接
            $typeName = implode($type instanceof ReflectionUnionType ? '|' : '&', $unionOrIntersectionTypeNames);
        } else {
            // 处理标准命名类型 (ReflectionNamedType)
            $typeName = $type->getName();
            // 如果类型允许为 null (即使用了 ? 前缀，且类型本身不是 'null')，则添加 '?'
            if ($type->allowsNull() && $typeName !== 'null') {
                $typeName = '?' . $typeName;
            }
        }
        $paramTypes[] = $typeName;
    }
    return $paramTypes;
}

// 示例用法：
try {
    echo "AuthController::store() 参数类型列表:\n";
    print_r(get_arg_types('AuthController::store'));
    /* 预期输出:
    Array
    (
        [0] => LoginRequest
        [1] => int
        [2] => ?string
        [3] => array|null
    )
    */

    echo "\nAuthController::anotherMethod() 参数类型列表:\n";
    print_r(get_arg_types('AuthController::anotherMethod'));
    /* 预期输出:
    Array
    (
        [0] => string
        [1] => mixed
        [2] => bool
    )
    */

    echo "\nAuthController::staticMethod() 参数类型列表:\n";
    print_r(get_arg_types('AuthController::staticMethod'));
    /* 预期输出:
    Array
    (
        [0] => float
    )
    */

    // 尝试获取不存在的方法的参数类型
    // echo "\n尝试获取不存在的方法:\n";
    // print_r(get_arg_types('AuthController::nonExistentMethod'));

} catch (ReflectionException $e) {
    echo "错误: " . $e->getMessage() . "\n";
}

?>