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

new

usmanhalalit/viocon

usmanhalalit/viocon

usmanhalalit/viocon

composer.json

<pre class="brush:php;toolbar:false;">{
    "require": {
        "usmanhalalit/viocon": "1.0.*@dev"
    }
}

composer install

<pre class="brush:php;toolbar:false;">// 创建一个容器实例
$container = new \Viocon\Container();

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

DatabaseConnection

UserService

<pre class="brush:php;toolbar:false;">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

<pre class="brush:php;toolbar:false;">// 假设我们有一个配置类
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. 只会输出一次)

usmanhalalit/viocon

<pre class="brush:php;toolbar:false;">// 假设这是我们的模拟数据库连接
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

setInstance

DatabaseConnection

UserService

usmanhalalit/viocon

usmanhalalit/viocon