ZF3/Apigility迁移Laminas/ApiTools：控制器工厂加载失败求助

1. 修复PSR-4命名空间大小写不匹配 #

你的composer.json里配置的PSR-4规则是"Emma\\": "module/emma/src/"，但代码中工厂类的命名空间用的是小写emma\V1\Rpc\Ping。PSR-4 自动加载器是大小写敏感的，这直接导致autoloader无法定位到你的类文件。

修正方案：

• 统一命名空间大小写，推荐将代码中的命名空间改为大写开头：

  <?php
  namespace Emma\V1\Rpc\Ping; // 把小写emma改为Emma
  
  use Interop\Container\ContainerInterface;
  use Laminas\ServiceManager\Factory\FactoryInterface; // 补充接口引入
  
  class PingControllerFactory implements FactoryInterface
  {
      public function __invoke(ContainerInterface $container, $requestedName, array $options = null)
      {
          return new PingController(); // 同步修改PingController的命名空间
      }
  }
  

• 同时更新module.config.php中的工厂配置：

  'controllers' => [
      'factories' => [
          ...
          'Emma\V1\Rpc\Ping\Controller' => \Emma\V1\Rpc\Ping\PingControllerFactory::class,
          ...
      ]
  ...
  

2. 补全FactoryInterface的引入 #

你的工厂类实现了FactoryInterface但未引入该接口定义，会导致PHP无法识别这个接口。必须在工厂类顶部添加：

use Laminas\ServiceManager\Factory\FactoryInterface;

3. 重新生成Composer自动加载映射 #

修改composer.json或命名空间后，必须重新生成autoloader映射，确保Composer能正确索引你的类：

composer dump-autoload

4. 验证模块目录结构 #

确保文件路径严格匹配PSR-4规则：

module/emma/src/V1/Rpc/Ping/
├── PingController.php
└── PingControllerFactory.php

其中PingController.php的命名空间也需要同步改为Emma\V1\Rpc\Ping。

内容的提问来源于stack exchange，提问作者Vincent Adhenet