PHP反射机制：动态获取函数与方法的参数类型列表

<?php

namespace App\Http\Controllers;

use App\Http\Requests\LoginRequest;
use stdClass;

class AuthController
{
    public function store(LoginRequest $request, int $id, ?string $name = null, stdClass|array $data = [], bool $active = true)
    {
        // ... 方法实现 ...
    }

    public function show(int $id, string $slug): void
    {
        // ... 方法实现 ...
    }
}

// 假设 LoginRequest 类存在
class LoginRequest {}

?>

<?php

namespace App\Http\Controllers;

use App\Http\Requests\LoginRequest;
use ReflectionMethod;
use ReflectionNamedType;
use ReflectionUnionType;
use ReflectionIntersectionType;
use stdClass;

// 假设 LoginRequest 类存在
class LoginRequest {}

class AuthController
{
    public function store(LoginRequest $request, int $id, ?string $name = null, stdClass|array $data = [], bool $active = true)
    {
        // ... 方法实现 ...
    }

    public function show(int $id, string $slug): void
    {
        // ... 方法实现 ...
    }
}

/**
 * 获取指定方法或函数的参数类型列表。
 *
 * @param string $callableName 格式为 'ClassName::methodName' 或 'functionName'。
 * @return array 一个包含参数类型字符串的数组。
 * @throws \ReflectionException 如果方法或函数不存在。
 */
function get_arg_types(string $callableName): array
{
    $types = [];

    if (str_contains($callableName, '::')) {
        // 反射类方法
        [$className, $methodName] = explode('::', $callableName);
        $reflector = new ReflectionMethod($className, $methodName);
    } else {
        // 反射独立函数
        // 这里为了简化，只处理方法。如需处理函数，需使用 ReflectionFunction
        throw new \InvalidArgumentException("Invalid callable name format. Expected 'ClassName::methodName'.");
    }

    foreach ($reflector->getParameters() as $parameter) {
        $type = $parameter->getType(); // 获取 ReflectionType 对象

        if ($type === null) {
            // 参数没有声明类型
            $types[] = 'mixed'; // 或者 'no_type'
        } elseif ($type instanceof ReflectionNamedType) {
            // 单一命名类型 (int, string, ClassName等)
            $typeName = $type->getName();
            // 如果是可空类型，例如 ?string，getType() 仍然返回 ReflectionNamedType
            // 但 isNullable() 会是 true
            $types[] = ($type->allowsNull() && $typeName !== 'mixed') ? '?' . $typeName : $typeName;
        } elseif ($type instanceof ReflectionUnionType) {
            // 联合类型 (TypeA|TypeB)
            $unionTypes = array_map(fn($t) => $t->getName(), $type->getTypes());
            $types[] = implode('|', $unionTypes);
        } elseif ($type instanceof ReflectionIntersectionType) {
            // 交叉类型 (TypeA&TypeB) - PHP 8.1+
            $intersectionTypes = array_map(fn($t) => $t->getName(), $type->getTypes());
            $types[] = implode('&', $intersectionTypes);
        } else {
            // 未知类型处理，理论上不应该发生
            $types[] = 'unknown_type';
        }
    }

    return $types;
}

// --------------------- 测试 ---------------------
try {
    echo "AuthController::store() 参数类型:\n";
    $storeArgTypes = get_arg_types('App\Http\Controllers\AuthController::store');
    print_r($storeArgTypes);
    /* 预期输出:
    Array
    (
        [0] => App\Http\Requests\LoginRequest
        [1] => int
        [2] => ?string
        [3] => stdClass|array
        [4] => bool
    )
    */

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

    // 尝试获取不存在的方法
    // get_arg_types('App\Http\Controllers\AuthController::nonExistentMethod');

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

?>

<?php

function calculateSum(int $a, int $b): int
{
    return $a + $b;
}

?>

<?php
// ... (之前的 get_arg_types 函数，已修改为支持独立函数) ...

try {
    echo "\ncalculateSum() 参数类型:\n";
    $sumArgTypes = get_arg_types('calculateSum'); // 假设 get_arg_types 已支持函数名
    print_r($sumArgTypes);
    /* 预期输出:
    Array
    (
        [0] => int
        [1] => int
    )
    */
} catch (\ReflectionException $e) {
    echo "反射错误: " . $e->getMessage() . "\n";
} catch (\InvalidArgumentException $e) {
    echo "参数错误: " . $e->getMessage() . "\n";
}

?>