Phalcon不内置运行时自动切换数据源机制，需手动注册多个DB服务、动态调用setConnectionService或connection参数指定连接，并注意事务隔离、连接复用及元数据缓存问题。
Phalcon 支持多数据库连接，但框架本身不提供“运行时自动切换数据源”的内置机制。要实现动态切换（比如按用户、租户或请求参数切换数据库），需手动管理多个 Phalcon\Db\Adapter\Pdo\* 实例，并在模型或服务层按需注入对应连接。
1. 配置多个数据库连接
在 DI 容器中注册多个数据库服务，每个服务对应一个独立的 PDO 连接：
// app/config/services.php
use Phalcon\Db\Adapter\Pdo\Mysql;
$di->set('dbTenantA', function () {
return new Mysql([
'host' => '192.168.1.10',
'username' => 'user_a',
'password' => 'pass_a',
'dbname' => 'tenant_a_db',
'charset' => 'utf8mb4'
]);
});
$di->set('dbTenantB', function () {
return new Mysql([
'host' => '192.168.1.11',
'username' => 'user_b',
'password' => 'pass_b',
'dbname' => 'tenant_b_db',
'charset' => 'utf8mb4'
]);
});
2. 动态绑定数据库到模型
Phalcon 模型可通过 setConnectionService() 在运行时指定使用哪个 DB 服务名。关键点是：该方法必须在查询前调用，且对当前实例生效（非全局）：
- 每次查询前显式设置，避免连接复用错误
- 推荐封装成基类或 Trait 统一处理
- 不建议在
initialize()中硬编码，否则无法动态切换
// app/models/User.php
use Phalcon\Mvc\Model;
class User extends Model
{
public function setDbConnection($serviceKey)
{
$this->setConnectionService($serviceKey);
return $this;
}
}
// 使用示例
$userA = (new User())->setDbConnection('dbTenantA')->findFirst(1);
$userB = (new User())->setDbConnection('dbTenantB')->findFirst(1);
3. 基于请求上下文自动切换（如租户 ID）
在控制器或中间件中解析租户标识（如子域名、Header、路由参数），再注入对应 DB 到模型或服务：
- 从
$this->request->getHeader('X-Tenant-ID')或$this->router->getParams()获取标识 - 映射标识到预注册的 DB 服务名（如
tenant-001 → dbTenantA） - 将选定的服务名传递给模型或封装的 Repository 类
// app/controllers/IndexController.php
class IndexController extends Controller
{
public function showAction()
{
$tenantId = $this->request->getHeader('X-Tenant-ID') ?: 'default';
$dbService = $this->tenantDbMap[$tenantId] ?? 'dbDefault';
$user = User::find([
'conditions' => 'id = ?0',
'bind' => [1],
'connection' => $dbService // Phalcon 4.3+ 支持 query() 和 find() 的 connection 参数
]);
// 或使用实例方式（兼容旧版本）
$user = (new User())->setDbConnection($dbService)->findFirst(1);
}
}
4. 注意事项与避坑点
动态切换数据库容易引发隐性问题，需特别注意：
-
事务不跨库：Phalcon 的
TransactionManager默认绑定单个连接，切库后需手动管理事务边界 - 连接未释放风险：频繁创建新连接（而非复用 DI 中注册的服务）会导致资源耗尽，务必复用 DI 实例
- 模型元数据缓存冲突：不同库若表结构不一致，启用元数据缓存时可能读错字段，建议按连接隔离缓存前缀
-
Phalcon 5 已移除
setConnectionService()：升级后需改用find()/findFirst()的connection选项或自定义 Query 实例
