PHP get_declared_interfaces 怎样列出当前已声明的接口名称

直接调用无参数的 get_declared_interfaces()，就能取得当前脚本中已经声明的接口名称数组。需要可读名单时，排序后遍历即可。它枚举的是当前运行上下文已经认识的接口，不会递归扫描项目目录，也不会把依赖包中尚未加载的所有接口自动列出来。

当诊断代码里找不到预期接口时，先区分“文件存在”“能被自动加载”和“现在已经声明”三个状态，再决定是否检查应用启动位置。下面按最小写法、筛选变体和完整片段展开，示例面向 PHP 8.x，未将示例代码当成实际运行记录。

PHP 官方地址：https://www.php.net/

最小配方：读取并逐行显示

每行是一个接口名称，而不是接口对象、文件路径或接口方法集合。列表可能同时包含 PHP 内部接口和业务代码声明的接口，因此不要把总数量直接理解成项目接口数量，也不要按固定下标取某个接口。排序是展示处理，不会改变接口声明。

筛选变体：只看业务命名空间

若只关心自己的代码，可以用完整命名空间前缀筛选。前缀末尾保留反斜杠，避免把相近命名空间误算进来。这里假定项目采用 DemoApp\Contracts\ 作为业务约定；它不是 PHP 自带的命名空间。

array_filter() 会保留原键，使用 array_values() 将结果整理成连续索引，便于后续作为列表输出。strncmp() 在这里采用区分大小写的文本比较，是项目筛选规则，不是对 PHP 接口名称语义的重新定义；若项目命名不统一，应先明确比较规则。

为什么安装了依赖却没有列出接口

自动加载器提供的是按需加载机制，不是“注册后就立即声明所有文件”。因此，只引入自动加载入口后马上枚举，和执行了实际业务初始化后枚举，可能得到不同结果。名单中没有某个接口，不能直接推断文件丢失或依赖未安装。

若只需要知道某个接口目前是否已经定义，可以使用 interface_exists($name, false)。第二个参数关闭自动加载，让这个判断保持“只观察当前声明”的含义。

省略第二个参数时，interface_exists() 默认允许自动加载，判断本身就可能改变之后的声明名单。如果要比较两个初始化阶段，应在相同入口、相同加载策略下采样，避免一边查询一边主动加载导致观察对象变化。

已声明、自动加载与内部接口的区别

命名空间适合筛选业务范围，反射则可以区分内部实现与用户定义。对返回名单里的名称创建 ReflectionClass，再调用 isInternal()，即可按这一属性分类。它返回 true 时表示内部定义，并不表示“属于当前项目”。

isInternal()) {
        $userDefined[] = $name;
    }
}
sort($userDefined, SORT_STRING);

用户定义接口还可能来自第三方依赖，所以 !isInternal() 不能替代业务命名空间筛选。需要“业务接口”名单时，可以同时使用来源分类与前缀规则，但仍应注明这是已声明集合的子集，不是项目的完整静态索引。

整理成可复用的输出片段

下面把“当前已声明、非内部、指定前缀”的需求封装为小函数。它不负责加载依赖，不隐式 include 文件，也不把诊断名单当作插件注册机制。调用点应放在需要观察的应用初始化阶段之后。

isInternal()) {
            $result[] = $name;
        }
    }
    sort($result, SORT_STRING);
    return $result;
}

// 调用方处理参数错误；正常空列表表示没有匹配的已声明接口。
try {
    $names = declaredBusinessInterfaces('DemoApp\\Contracts\\');
    foreach ($names as $name) {
        echo $name, PHP_EOL;
    }
} catch (InvalidArgumentException $error) {
    error_log($error->getMessage());
    exit(1);
}

返回值能直接当接口实例使用吗？

不能。数组元素是名称字符串；接口本身也不能被直接实例化。

为什么不同入口显示不同数量？

可能是执行阶段、加载代码和运行环境不同。比较时应记录入口与初始化位置，不把差异自动解释成错误。

能用它找出项目里所有接口文件吗？

不能。运行时声明名单与磁盘源码索引是不同任务；不要为了补齐名单盲目加载全部文件，文件加载可能带来额外行为。

参考官方文档：已声明接口枚举、接口存在性判断、自动加载机制、内部定义判断。