1. 什么是 Pimple？为什么需要它？

Pimple 是一个轻量级的 PHP 依赖注入容器（Dependency Injection Container），由 Symfony 框架创始人 Fabien Potencier 开发。与臃肿的 DI 容器不同，Pimple 提供极简解决方案，可轻松集成到任何项目中而无需额外开销。该库实现了服务定位器模式，并提供简洁的 API 来管理对象及其依赖关系。

Pimple 的核心目标是简化 PHP 应用中的依赖管理。您无需手动使用 new 创建对象并传递给构造函数，只需在容器中注册服务，然后按名称调用即可。容器会自动解析依赖关系，按需创建单例（singleton）或每次新建实例（factory），并管理其生命周期。这使代码更加模块化、可测试且易于维护。

Pimple 非常适合中小型项目，无需 Symfony DI 或 PHP-DI 的完整功能。它不使用注解，无需复杂配置，支持 PHP 5.3 及以上版本。该库广泛用于 Silex（微框架）及其他注重简洁与速度的 PHP 项目。

2. 安装方法

通过 Composer（PHP 标准包管理器）安装 Pimple。在终端中执行：

composer require pimple/pimple

安装后，在 PHP 文件中引入 Composer 自动加载器：

require_once __DIR__ . '/vendor/autoload.php';

如果尚未创建 composer.json，请新建：

{
    "require": {
        "pimple/pimple": "^3.5"
    }
}

3. 快速上手——最小工作示例

创建文件 index.php，添加以下代码：

<?php
require_once __DIR__ . '/vendor/autoload.php';

use Pimple\Container;

// 创建容器
$container = new Container();

// 定义简单服务（闭包）
$container['greeting'] = function ($c) {
    return 'Hello, World!';
};

// 定义带参数的服务
$container['personal_greeting'] = function ($c) {
    return function ($name) use ($c) {
        return 'Hello, ' . $name . '!';
    };
};

// 获取服务
echo $container['greeting'] . "\n"; // Hello, World!
echo $container['personal_greeting']('Alice') . "\n"; // Hello, Alice!

// 定义对象服务
class Logger {
    public function log($message) {
        echo "[LOG] $message\n";
    }
}

$container['logger'] = function ($c) {
    return new Logger();
};

$container['logger']->log('Application started');

运行脚本：php index.php。您将看到三条输出信息。此示例演示了如何在容器中注册和获取服务。

4. 核心方法与类

4.1. Pimple\Container::__construct()

签名： public function __construct(array $values = [])

说明： 创建容器实例。可传入预定义值/服务数组。

$container = new Container([
    'db.host' => 'localhost',
    'db.name' => 'test'
]);

4.2. offsetSet($id, $value)（通过 [] 的魔术方法）

签名： public function offsetSet($id, $value): void

图书馆中也有

在 Go (Golang) 中使用 Markdown：库、解析与转换 ZXing Kotlin 完整指南：QR码与条形码扫描库教程 Reqwest for Rust：完整指南与示例 Java 密码学：加密与哈希——完整指南 GraphQL在PHP中的应用：webonyx/graphql-php与Lighthouse库构建API