利用PHP Reflection API获取函数/方法参数类型列表

$reflectionMethod = new ReflectionMethod('ClassName', 'methodName');
// 或者对于一个对象实例
// $object = new ClassName();
// $reflectionMethod = new ReflectionMethod($object, 'methodName');

$parameters = $reflectionMethod->getParameters();

foreach ($parameters as $parameter) {
    $type = $parameter->getType();
    if ($type === null) {
        // 参数没有类型提示
        echo "Parameter '{$parameter->getName()}' has no type hint.\n";
    } else {
        // 获取类型名称
        echo "Parameter '{$parameter->getName()}' has type: " . $type->getName() . "\n";
        // 对于联合/交叉类型，可以使用 $type->__toString()
    }
}

<?php

// 模拟的控制器基类和请求类
class Controller {}
class LoginRequest {}

class AuthController extends Controller {
   /**
    * 示例方法，包含不同类型的参数。
    *
    * @param LoginRequest $request 一个自定义类类型的请求对象。
    * @param int $id 一个整数ID。
    * @param string $name 一个字符串，带有默认值。
    * @param ?array $options 一个可空的数组。
    * @param string|int $unionType 一个联合类型参数 (PHP 8.0+)。
    */
   public function store(
       LoginRequest $request,
       int $id,
       string $name = 'default',
       ?array $options = null,
       string|int $unionType = 0
   ) {
      // 方法体
   }

   public function show(int $id, string $slug) {
       // 方法体
   }

   public function withoutTypes($param1, $param2) {
       // 方法体
   }
}

/**
 * 获取指定方法或函数的参数类型列表。
 *
 * @param string $callable 格式为 'ClassName::methodName' 或 'functionName'。
 * @return array 包含参数类型名称的数组。
 * @throws ReflectionException 如果方法或函数不存在。
 */
function get_arg_types(string $callable): array
{
    $parts = explode('::', $callable);
    $reflection = null;

    try {
        if (count($parts) === 2) {
            // 类方法
            $className = $parts[0];
            $methodName = $parts[1];
            $reflection = new ReflectionMethod($className, $methodName);
        } else {
            // 普通函数
            $functionName = $callable;
            $reflection = new ReflectionFunction($functionName);
        }
    } catch (ReflectionException $e) {
        // 捕获反射异常，例如类、方法或函数不存在
        throw new ReflectionException("无法反射 '{$callable}': " . $e->getMessage(), 0, $e);
    }

    $argTypes = [];
    foreach ($reflection->getParameters() as $parameter) {
        $type = $parameter->getType();
        if ($type === null) {
            // 参数没有类型提示，可以标记为 'mixed' 或 'null'
            $argTypes[] = 'mixed';
        } else {
            // 获取类型名称。对于联合/交叉类型，getName() 会返回其字符串表示。
            // 例如：'LoginRequest', 'int', 'string', 'array', 'string|int'
            $argTypes[] = $type->getName();
        }
    }

    return $argTypes;
}

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

    echo "\n--- AuthController::show() 参数类型 ---\n";
    $showArgTypes = get_arg_types('AuthController::show');
    print_r($showArgTypes);
    /* 预期输出:
    Array
    (
        [0] => int
        [1] => string
    )
    */

    echo "\n--- AuthController::withoutTypes() 参数类型 (无类型提示) ---\n";
    $noTypeArgs = get_arg_types('AuthController::withoutTypes');
    print_r($noTypeArgs);
    /* 预期输出:
    Array
    (
        [0] => mixed
        [1] => mixed
    )
    */

    // 尝试反射一个不存在的方法，会抛出 ReflectionException
    // echo "\n--- 尝试反射不存在的方法 ---\n";
    // get_arg_types('AuthController::nonExistentMethod');

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

?>