Zend Framework 3 Model工厂未触发及多数据库配置读取咨询

一、ModelFactory未被调用的可能原因 #

你配置的ModelFactory没触发，大概率是以下几个原因之一：

• 直接实例化Model而非通过ServiceManager获取：如果代码里是直接new MasterModel()，而不是从容器中获取（比如$container->get(\sf\ZfCommons\Model\MasterModel::class)），Factory完全不会执行。Zend Framework的ServiceManager只会在你通过它请求服务时，才会调用对应的Factory。
• 配置类名存在拼写错误：检查module.config.php中factories数组的键名和Factory类名是否完全匹配（包括命名空间），比如是否写错了MasterModel的命名空间，或者ModelFactory的类名。
• 模块未正确启用：确认你的模块已经在config/application.config.php的modules数组中注册，否则模块配置不会被加载，ServiceManager也不会识别你的Factory配置。

二、从配置文件读取数据库参数并设置适配器的实现方式 #

步骤1：将数据库配置移到配置文件中 #

推荐把数据库配置放在config/autoload/local.php（本地环境配置）或者module.config.php中，这样更灵活且便于维护：

// config/autoload/local.php
return [
    'db' => [
        'sys' => [
            'driver' => 'Pdo_Mysql',
            'hostname' => 'localhost',
            'database' => 'db1',
            'username' => 'root',
            'password' => 'password',
            'charset' => 'utf8'
        ],
        'user_client' => [
            'driver' => 'Pdo_Mysql',
            'hostname' => 'localhost',
            'database' => 'db2',
            'username' => 'root',
            'password' => 'password',
            'charset' => 'utf8'
        ]
    ]
];

步骤2：修改MasterModel，通过构造函数注入依赖 #

不要在MasterModel的构造函数中硬编码适配器，而是通过构造函数接收适配器实例：

namespace sf\ZfCommons\Model;
use Zend\Db\Sql\Sql;
use Zend\Db\Adapter\Adapter;

class MasterModel extends AbstractModel {
    public $db;
    public $dbSys;
    public $dbUserClient;

    // 通过构造函数注入两个数据库适配器
    public function __construct(Adapter $dbSys, Adapter $dbUserClient) {
        $this->dbSys = $dbSys;
        $this->dbUserClient = $dbUserClient;

        // 根据TBL_PLACE选择默认数据库
        if ($this::TBL_PLACE == 'user_client') {
            $this->db = $this->dbUserClient;
        } else {
            $this->db = $this->dbSys;
        }
        $this->sql = new Sql($this->db);
    }
}

步骤3：更新ModelFactory，从容器获取适配器 #

我们可以先把数据库适配器注册为独立服务，再在Factory中注入到MasterModel：

首先在module.config.php中注册适配器服务：

'service_manager' => [
    'factories' => [
        \sf\ZfCommons\Model\MasterModel::class => \sf\ZfCommons\Model\ModelFactory::class,
        // 注册系统数据库适配器
        'DbSysAdapter' => function(\Interop\Container\ContainerInterface $container) {
            $config = $container->get('config');
            return new \Zend\Db\Adapter\Adapter($config['db']['sys']);
        },
        // 注册用户客户端数据库适配器
        'DbUserClientAdapter' => function(\Interop\Container\ContainerInterface $container) {
            $config = $container->get('config');
            return new \Zend\Db\Adapter\Adapter($config['db']['user_client']);
        }
    ],
],

然后修改ModelFactory，注入适配器：

namespace sf\ZfCommons\Model;
use Interop\Container\ContainerInterface;
use Zend\ServiceManager\Factory\FactoryInterface;

class ModelFactory implements FactoryInterface {
    public function __invoke(ContainerInterface $container, $requestedName, array $options = null) {
        echo "############# ModelFactory #################";
        
        // 从容器中获取预定义的适配器
        $dbSys = $container->get('DbSysAdapter');
        $dbUserClient = $container->get('DbUserClientAdapter');
        
        // 实例化Model并注入依赖
        $service = (null === $options) 
            ? new $requestedName($dbSys, $dbUserClient) 
            : new $requestedName($dbSys, $dbUserClient, $options);
        
        return $service->setServiceManager($container);
    }
}

三、其他获取配置的方式 #

除了通过$container->get('config')直接获取全局配置外，还有几种常见方式：

• 配置分片注入：如果只需要某一部分配置，可以在Factory中提取后注入，比如只把db配置传给Model，而不是整个全局配置数组。
• 封装ConfigService：可以封装一个专门的ConfigService类负责读取和管理配置，将其注册到容器中，再在Model或Factory中注入使用，这种方式适合复杂项目的配置管理。
• 模块级配置：如果数据库配置属于当前模块，可以在module.config.php中单独定义，然后通过容器获取，适合模块内的独立配置场景。

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