PSR-11 规范定义了 PHP 依赖注入容器的标准接口。这一标准化使得库能够从任何容器实现中检索服务，从而提升不同框架和库之间的互操作性。
理解依赖注入容器 (DIC)
依赖注入容器负责：
- 管理服务定义
- 创建服务实例
- 解析依赖项
- 管理对象生命周期
容器接口示例
立即学习“PHP免费学习笔记（深入）”；
<code class="php"><?php
namespace jonesrussell\phpfigguide\psr11;
interface ContainerInterface
{
/**
* 通过标识符查找容器中的条目并返回。
*
* @param string $id
* @return mixed
* @throws NotFoundExceptionInterface
* @throws ContainerExceptionInterface
*/
public function get($id);
/**
* 如果容器可以为给定的标识符返回条目，则返回 true。
*
* @param string $id
* @return bool
*/
public function has($id);
}
?></code>
基本实现
以下是一个符合 PSR-11 标准的简单依赖注入容器实现示例 (代码略，此处省略了实现细节，仅保留说明)。
高级用法
-
依赖注册服务: 可以注册依赖于其他服务的服务。例如，一个需要数据库连接的
UserService可以这样设置：
<code class="php"><?php
class DatabaseConnection {
public function connect() {
return "数据库已连接!";
}
}
class UserService {
private DatabaseConnection $db;
public function __construct(DatabaseConnection $db) {
$this->db = $db;
}
public function getUser() {
return "用户数据来自 " . $this->db->connect();
}
}
// 使用示例
$container = new SimpleContainer(); // 假设 SimpleContainer 是一个容器实现
$container->set('database', new DatabaseConnection());
$container->set('userservice', new UserService($container->get('database')));
$userService = $container->get('userservice');
echo $userService->getUser(); // 输出：用户数据来自 数据库已连接!
?></code>
- 使用工厂函数: 可以使用工厂函数注册服务，允许更复杂的实例化逻辑：
<code class="php"><?php
$container->set('userservice', function (ContainerInterface $c) {
return new UserService($c->get('database'));
});
// 使用示例
$userService = $container->get('userservice');
echo $userService->getUser(); // 输出：用户数据来自 数据库已连接!
?></code>
实际应用示例
- 服务注册:
<code class="php"><?php
// 定义服务
$container = new Container(); // 假设 Container 是一个容器实现
// 简单值
$container->set('api.key', 'secret-key-123');
// 工厂函数
$container->set('database', function (ContainerInterface $container) {
return new PDO(
$container->get('db.dsn'),
$container->get('db.user'),
$container->get('db.pass')
);
});
// 依赖服务
$container->set('userrepository', function (ContainerInterface $container) {
return new UserRepository($container->get('database'));
});
?></code>
- 服务检索:
<code class="php"><?php
class UserController
{
private UserRepository $users;
public function __construct(ContainerInterface $container)
{
$this->users = $container->get('userrepository');
}
}
?></code>
框架集成示例 (Laravel)
(代码略，此处省略了 Laravel 集成代码示例，仅保留说明)
最佳实践
-
服务解析: 避免使用服务定位器模式，而应使用显式依赖注入。
-
容器配置: 使用配置驱动的服务定义，而不是运行时服务定义。
后续
下一篇文章将探讨 PSR-14 (事件调度程序接口)。
资源
- 官方 PSR-11 规范
- PHP-DI 文档
