PHP-DI扩展安装与配置教程

本文澄清了一个常见误区：phpenv 并非 PHP-DI 的安装工具，PHP-DI 实际是纯 PHP 的 Composer 包（php-di/php-di），而非需编译加载的原生扩展；正确做法仅需确保 phpenv 管理的 PHP 版本兼容且 Composer 可用，然后执行 `composer require php-di/php-di`，并使用 `ContainerBuilder` 运行时构建容器——彻底摒弃已废弃的 `php-di/composer`、预编译逻辑和过时配置，同时提醒开发者注意 OPcache 启用、PHP 版本匹配及依赖清理等关键兼容性断点，助你避开迁移陷阱，快速启用 PHP-DI 6.x 的现代化依赖注入能力。

phpenv 本身不提供 PHP-DI 扩展安装功能

phpenv 是 PHP 版本管理工具，不是扩展管理器，它不负责安装、启用或配置任何 PHP 扩展（包括 php-di/php-di）。你看到的“phpEnv 安装 PHP-DI 扩展”是一种常见误解——PHP-DI 不是 PHP 扩展（即非 .so/.dll 形式），而是一个纯 PHP 的 Composer 包。它不需要编译、不修改 PHP 运行时、也不依赖 phpenv 的任何 hook 或插件。

真正要做的只有两件事：确保当前 phpenv 激活的 PHP 版本能运行 Composer，然后用 Composer 安装 php-di/php-di。

• 先确认当前 PHP 版本可用：php -v 和 which php 应指向 ~/.phpenv/versions/8.3.13/bin/php 这类路径
• 确认 composer 命令可用且版本 ≥ 2.5（PHP-DI 6.x 要求）
• 在项目根目录执行：composer require php-di/php-di
• 不要运行 composer require php-di/composer —— 这个包已废弃，会直接破坏自动装配

为什么 php-di/composer 会导致 Class not found 错误

错误信息如 Class 'DI\Composer\Compiler' not found 不是环境没配好，而是你明确引入了一个 PHP-DI 6.x 根本不认识的类。这个类只存在于早已停止维护的 php-di/composer（4.x 时代产物），它试图在 composer install 阶段生成容器代码，但 PHP-DI 6.x 已完全移除该机制，改用运行时反射+ContainerBuilder 动态构建。

• php-di/composer 的 extra.php-di 配置字段在 PHP-DI 6.x 中被完全忽略
• 即使强制安装，也会与 php-di/php-di 的命名空间和类加载规则冲突
• Composer 报 could not resolve package 往往是因为它检测到版本约束矛盾（比如要求 PHP

PHP-DI 容器初始化必须绕过旧教程的“编译”幻觉

很多迁移项目残留着类似这样的错误写法：$container = (new Compiler())->compile(...) 或在 composer.json 里写 "php-di": { "definitions": "config/di.php" }。这些在 PHP-DI 6.x 下全部无效，也不会报错，只是默默不工作。

正确初始化只需三行 PHP 代码（无额外配置、无预编译步骤）：

use DI\ContainerBuilder;

$builder = new ContainerBuilder();
$builder->addDefinitions(__DIR__ . '/config/di.php'); // 可选：显式定义
$container = $builder->build();

• 不调用 compile()、不生成缓存文件、不依赖 php-di/composer
• 如果用自动装配（autowiring），甚至不需要 addDefinitions()，直接 $container->get(SomeService::class) 即可
• 注意：若用 php-di/invoker 支持 @Inject 注解，需单独 composer require php-di/invoker，但 php-di/annotations 已废弃

容易被忽略的兼容性断点

最麻烦的从来不是“怎么装”，而是旧文档留下的隐性依赖。比如某 CI 脚本里写了 phpenv global 7.4，但项目实际需要 PHP 8.2+ 才能跑通 PHP-DI 的类型反射；又或者 php.ini 关闭了 opcache.enable，导致自动装配性能骤降却无提示。

务必检查：

• php -m | grep opcache —— PHP-DI 6.x 强烈依赖 OPcache 加速反射
• composer show php-di/php-di 确认版本是 ^6.0，而非 ^5.4 或 ^4.0
• 删除所有 vendor/php-di/composer 目录及 composer.lock 中相关条目后重装

本篇关于《PHP-DI扩展安装与配置教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！