如何使用spl_autoload_register为同一命名空间注册多个目录

看起来你遇到的问题是同一命名空间下的文件分散在不同目录，现有自动加载逻辑只会认最后一个目录，导致找不到文件对吧？别担心，我们只需要调整一下自动加载函数的逻辑，让它遍历所有可能的目录来查找文件，就能解决这个问题。

核心思路很简单：把所有包含该命名空间文件的目录整理到一个数组里，当自动加载触发时，逐个遍历这些目录，检查对应路径下的文件是否存在，找到就加载它。

具体实现步骤： #

1. 整理所有目标目录
   把你原来JSON里的目录和新添加的目录都合并到一个数组中，比如：

   // 从原有JSON文件读取已注册的目录
   $autoloadConfig = json_decode(file_get_contents('你的自动加载配置.json'), true);
   $originalDirs = $autoloadConfig['directories'];
   
   // 新增的存放同一命名空间文件的目录
   $newDirs = [
       __DIR__ . '/src/new-dir-1',
       __DIR__ . '/vendor/third-party/new-dir-2'
   ];
   
   // 合并所有目录，得到完整的搜索列表
   $allNamespaceDirs = array_merge($originalDirs, $newDirs);
   

2. 编写支持多目录的自动加载函数
   注册一个新的自动加载函数，让它遍历上面的目录数组，逐个查找文件：

   spl_autoload_register(function ($className) use ($allNamespaceDirs) {
       // 将命名空间的反斜杠转换为系统对应的目录分隔符
       $classFilePath = str_replace('\\', DIRECTORY_SEPARATOR, $className) . '.php';
       
       // 遍历每一个目录，检查文件是否存在
       foreach ($allNamespaceDirs as $dir) {
           $fullFilePath = $dir . DIRECTORY_SEPARATOR . $classFilePath;
           
           // 确认文件存在且可读取，就加载它
           if (file_exists($fullFilePath) && is_readable($fullFilePath)) {
               require_once $fullFilePath;
               // 找到文件后直接返回，无需继续遍历其他目录
               return;
           }
       }
       
       // 可选：如果所有目录都没找到文件，这里可以抛出异常提示
       // throw new \RuntimeException("无法找到类 {$className}，已检查所有注册目录");
   });
   

几个需要注意的点： #

• 用use ($allNamespaceDirs)把目录数组传入匿名函数，这样函数内部才能访问到这些目录列表
• 遍历目录时，只要找到存在的文件就立即加载并返回，避免不必要的遍历
• 如果你原来的自动加载函数还需要保留，记得不要覆盖它——SPL自动加载栈是支持多个函数的，新注册的函数会和原来的一起生效，不过建议把多目录逻辑整合到一个函数里，这样逻辑更清晰

这样调整后，自动加载函数就会依次检查所有你注册的目录，不管同一命名空间的文件在哪个目录下，只要目录在数组里，就能被找到并加载啦。

备注：内容来源于stack exchange，提问作者Chris