告别“意大利面条式”代码：如何使用usmanhalalit/viocon优雅管理PHP依赖

PHPz

发布时间：2025-08-27 13:46:17

832人浏览过

来源于php中文网

原创

可以通过一下地址学习composer：学习地址

在日常的php开发中，我们常常会遇到这样的场景：一个核心业务逻辑类，需要依赖数据库连接、日志记录器、缓存服务等多个外部组件。如果我们在业务逻辑类内部直接

new

出这些依赖，代码就会变得紧密耦合。举个例子，如果数据库连接方式变了，或者我想在单元测试时用一个模拟的数据库连接来代替真实的，就会非常麻烦。这不仅让代码难以理解和维护，也让单元测试变得举步维艰。

为了解决这个问题，我一直在寻找一个既简单又灵活的解决方案。市面上有很多功能强大的依赖注入（DI）容器，但有些对于我的轻量级项目来说显得过于庞大和复杂。直到我遇到了

usmanhalalit/viocon

。

usmanhalalit/viocon

是一个为PHP设计的简单而灵活的依赖注入容器（或称服务容器）。它的核心思想是帮助我们解耦代码中的依赖关系，并能在运行时轻松地替换这些依赖，尤其在测试场景下，这简直是神器！

为什么选择

usmanhalalit/viocon

？

轻量级且灵活： 它不像一些大型框架自带的DI容器那样功能臃肿，
```
viocon
```
专注于核心的依赖注入功能，使用起来非常直观。
解耦代码： 通过将依赖的创建和管理交给容器，你的业务逻辑类不再需要关心如何实例化它的依赖，只需声明自己需要什么。
提高可测试性： 在测试时，你可以轻松地用模拟对象（Mock Object）替换真实的依赖，确保你的测试只关注业务逻辑本身，而不是外部组件的行为。

如何使用

usmanhalalit/viocon

解决问题

首先，你需要通过 Composer 将

usmanhalalit/viocon

添加到你的项目中。在

composer.json

文件中添加以下内容：

{
    "require": {
        "usmanhalalit/viocon": "1.0.*@dev"
    }
}

然后运行

composer install

。

立即学习“PHP免费学习笔记（深入）”；

1. 初始化容器

// 创建一个容器实例
$container = new \Viocon\Container();

// 也可以选择创建一个类别名，方便静态调用
// new \Viocon\Container('AppContainer');
// 之后就可以这样使用：\AppContainer::set(...);

2. 绑定依赖：让容器知道如何创建对象

假设我们有一个

DatabaseConnection

类，并且

UserService

依赖它。

XPaper Ai

AI撰写论文、开题报告生成、AI论文生成器尽在XPaper Ai论文写作辅助指导平台

下载

class DatabaseConnection
{
    private $connectionInfo;

    public function __construct(string $connectionInfo)
    {
        $this->connectionInfo = $connectionInfo;
        echo "DatabaseConnection created with: " . $connectionInfo . "\n";
    }

    public function query(string $sql): string
    {
        return "Executing query: " . $sql . " on " . $this->connectionInfo;
    }
}

class UserService
{
    private $db;

    public function __construct(DatabaseConnection $db)
    {
        $this->db = $db;
    }

    public function getUser(int $id): string
    {
        return $this->db->query("SELECT * FROM users WHERE id = " . $id);
    }
}

// 绑定 DatabaseConnection 到容器，并提供构造函数参数
$container->set(DatabaseConnection::class, function ($connectionInfo) {
    return new DatabaseConnection($connectionInfo);
});

// 绑定 UserService，容器会自动解析其依赖 DatabaseConnection
$container->set(UserService::class, UserService::class);

// 从容器中构建 UserService 实例
// 容器会先解析 DatabaseConnection，然后将其实例注入到 UserService 的构造函数中
$userService = $container->build(UserService::class, ['my_prod_db_info']);

echo $userService->getUser(1);
// 输出:
// DatabaseConnection created with: my_prod_db_info
// Executing query: SELECT * FROM users WHERE id = 1 on my_prod_db_info

可以看到，

UserService

自身并不知道

DatabaseConnection

是如何被创建的，它只声明了自己需要一个

DatabaseConnection

实例。容器负责将正确的实例注入进去。

3. 使用单例模式

对于一些应该全局唯一的服务（如配置、日志），我们可以将其注册为单例。

// 假设我们有一个配置类
class Config
{
    public $settings = [];
    public function __construct() {
        $this->settings = ['app_name' => 'My Awesome App'];
        echo "Config instance created.\n";
    }
}

// 将 Config 注册为单例
$container->setSingleton(Config::class, Config::class);

$config1 = $container->build(Config::class);
$config2 = $container->build(Config::class);

echo $config1->settings['app_name'] . "\n";
echo ($config1 === $config2 ? "Both are the same Config instance.\n" : "They are different Config instances.\n");
// 输出:
// Config instance created.
// My Awesome App
// Both are the same Config instance.
// (Config instance created. 只会输出一次)

4. 运行时替换依赖（Mocking for Tests）

这是

usmanhalalit/viocon

最强大的特性之一，特别适用于单元测试。你可以轻松地用一个模拟对象替换掉容器中注册的真实依赖。

// 假设这是我们的模拟数据库连接
class MockDatabaseConnection extends DatabaseConnection
{
    public function __construct()
    {
        // 模拟连接信息
        parent::__construct('mock_db_info');
        echo "MockDatabaseConnection created.\n";
    }

    public function query(string $sql): string
    {
        // 返回模拟数据，而不是真正执行查询
        return "Mocked result for query: " . $sql;
    }
}

// 假设在测试环境中，我们想要替换 DatabaseConnection
// 注意：这里我们使用 setInstance 来替换已经注册的绑定
$mockDb = new MockDatabaseConnection();
$container->setInstance(DatabaseConnection::class, $mockDb);

$testUserService = $container->build(UserService::class);

echo $testUserService->getUser(5);
// 输出:
// MockDatabaseConnection created.
// Mocked result for query: SELECT * FROM users WHERE id = 5

通过