PHP ReflectionParameter 怎样区分默认常量与普通默认值

PHP 中要区分参数的默认常量与普通默认值，先调用 isDefaultValueAvailable() 确认默认值存在，再调用 isDefaultValueConstant() 判断来源；是常量时读取 getDefaultValueConstantName()，需要实际值时再使用 getDefaultValue()。不能仅凭实际值反推声明中是否引用了常量。

官方文档：https://www.php.net/manual/en/class.reflectionparameter.php

先保存默认值的来源信息

例如一个内部接口文档工具，要把请求大小上限显示成常量名称，但旧实现只保存整数。即使读取到了正确数字，也丢掉了“这个数字来自哪个常量”的信息。之后常量值调整，文档就容易继续显示旧字面量。

在元数据模型中，至少区分默认值是否可用、是否为常量、常量名称和解析后的值。默认值为 null 与没有默认值也应分别记录，不要只放一个可能为空的 value 字段。

用同值参数观察常量和字面量的区别

下面定义一个项目常量，并让两个参数最终都取100。示例只分析当前文件中明确声明的函数，不动态载入外部脚本，也不会调用被分析函数。

getParameters() as $parameter) {
    $meta = [
        'name' => $parameter->getName(),
        'has_default' => false,
        'is_constant' => false,
        'constant_name' => null,
        'value' => null,
    ];

    // 必填参数没有可读取默认值，先处理这一分支。
    if (!$parameter->isDefaultValueAvailable()) {
        var_export($meta);
        echo PHP_EOL;
        continue;
    }

    $meta['has_default'] = true;
    try {
        // 用反射提供的来源标识判断，不比较默认值是否等于常量值。
        $meta['is_constant'] = $parameter->isDefaultValueConstant();
        if ($meta['is_constant']) {
            $meta['constant_name'] = $parameter->getDefaultValueConstantName();
        }
        $meta['value'] = $parameter->getDefaultValue();
    } catch (Throwable $error) {
        // 单个参数读取失败时保留错误资料，不把异常伪装成默认值 null。
        $meta['error_type'] = get_class($error);
    }

    var_export($meta);
    echo PHP_EOL;
}

按示例声明，limit 来自 PAGE_LIMIT，fallback 则使用普通整数；两者的值虽然一致，来源不同。required 的 has_default 为 false，而 note 有一个可用的 null 默认值。这里描述的是示例预期，不是实际运行输出。

把读取失败与正常空值分别处理

不要直接对每个参数调用 getDefaultValue，然后把异常统一转换为 null。这样一来，必填参数、读取失败以及显式 null 默认值会变成同一条记录，调用方无法判断哪一种情况需要处理。

isOptional 回答参数是否可选，不是“能否读取默认值”的替代检查。需要默认值资料时，仍然使用 isDefaultValueAvailable。内部函数的反射信息也应按实际返回结果处理，不要假定每种可选参数都一定能提供相同的默认值元数据。

把元数据读取限制在可信代码里

反射工具的保护对象包括扫描进程本身，以及最终输出的文档。只允许扫描项目明确选择的函数或类；不要根据请求参数直接拼接文件路径并 include 一个未知 PHP 文件。加载文件会执行文件级代码，反射并不是把任意脚本变成安全资料的隔离层。

常量名称读取后只是元数据，不需要通过 eval 把它拼成表达式再次执行。生成 HTML 文档时，参数名、常量名和格式化后的值都应做相应转义。记录错误时保留有用的类型与目标标识，面向公开页面则避免泄露本地路径和无关配置。

明确反射能够保留的范围

这些 API 适合区分直接的常量默认值与普通默认值，不是任意 PHP 默认表达式的源码还原器。遇到复合表达式，不应假设它能完整列出表达式引用的所有常量；如果业务需要保留原始表达式、注释或书写形式，应在受控源码上采用相应解析方案。

两个默认值相等就能认为声明相同吗？不能，来源标识与实际值是不同维度。只需要显示常量名时必须读取实际值吗？不必，按用途减少不必要读取即可。日志应该只存一段参数字符串吗？建议保留结构化字段，再分别生成展示文本，便于定位默认值缺失或读取失败。

常量名接口参考：https://www.php.net/manual/en/reflectionparameter.getdefaultvalueconstantname.php