本文详解 PHP 命名空间类“Class not found”错误的根本原因，重点指出 glob() 路径解析依赖当前工作目录的问题，并提供基于绝对路径的可靠自动加载实现方案。
本文详解 php 命名空间类“class not found”错误的根本原因，重点指出 `glob()` 路径解析依赖当前工作目录的问题，并提供基于绝对路径的可靠自动加载实现方案。
在使用 PHP 命名空间配合手动自动加载（如 autoload.php）时，一个极易被忽视却高频出现的问题是：glob() 函数默认基于当前工作目录（Current Working Directory, CWD）解析路径，而非相对于脚本文件本身。这直接导致 autoload.php 中的 glob("Classes/*Utility.php") 在不同执行上下文中匹配失败——即使文件物理存在，也无法被正确包含，最终触发 Class "Verification\VerificationUtility" not found 的致命错误。
你已通过 get_included_files() 确认 VerificationUtility.php 实际被加载（运行 autoload.php 独立脚本时成功），但该文件在 Verification.php 中被 include 时却失效，这正是路径相对性引发的典型不一致行为。
✅ 正确做法：始终使用绝对路径
将 autoload.php 中的 glob() 调用改为基于 __DIR__（即 autoload.php 所在目录）构建绝对路径：
<?php
// assets/php/autoload.php
$classesDir = __DIR__ . '/Classes';
foreach (glob($classesDir . '/*Utility.php') as $filename) {
require_once $filename; // 推荐使用 require_once 替代 include_once，语义更明确
}同时，修正 Verification.php 中的命名空间声明与引用逻辑（注意：use 语句必须在 namespace 声明之后、任何可执行代码之前）：
立即学习“PHP免费学习笔记（深入）”；
<?php namespace Verification; // ✅ 正确：使用 __DIR__ 获取当前脚本所在目录，再向上定位 autoload.php require_once dirname(__DIR__) . '/autoload.php'; // ✅ 正确：use 语句置于命名空间后、代码前 use Verification\VerificationUtility as Utility; // ✅ 现在可安全实例化 echo (new Utility())->test();
⚠️ 关键注意事项：
- include/require 路径必须是绝对路径或相对于当前工作目录的有效路径；__DIR__ 是最可靠的锚点。
- use 别名仅影响当前文件的类引用语法，不参与类加载过程；类是否能被找到，完全取决于文件是否已被 require/include。
- 避免在命名空间内执行 include 操作后再声明 use —— 虽然语法允许，但易造成逻辑混乱和 IDE 识别异常。
- 生产环境强烈推荐迁移到 PSR-4 自动加载标准，配合 Composer 管理，彻底规避手动路径维护风险。
通过统一使用 __DIR__ 构建路径，你的自动加载器将具备确定性行为，不再受 CLI 工作目录或 Web 服务器请求路径的影响，从根本上解决命名空间类“找不到”的问题。
