PHP-DI 7.0 迁移指南：从6.x版本升级的关键变化

PHP-DI 7.0 迁移指南：从6.x版本升级的关键变化

【免费下载链接】PHP-DI The dependency injection container for humans 项目地址: https://gitcode.com/gh_mirrors/ph/PHP-DI

还在为PHP-DI 6.x到7.0的升级而头疼？本文为你提供最完整的迁移指南，一文解决所有兼容性问题！

读完本文你将获得：

• ✅ PHP版本要求变化详解
• ✅ 注解到属性的完整迁移方案
• ✅ 容器创建API的重大变更
• ✅ 内部架构变化的应对策略
• ✅ 实战代码示例和对比表格

🚀 PHP版本要求升级

PHP-DI 7.0 要求 PHP 8.0 或更高版本。如果你的项目还在使用旧版本PHP，可以继续使用PHP-DI 6.x。

🔄 容器创建方式简化

PHP-DI 7.0 引入了更简洁的容器创建方式，不再强制使用 ContainerBuilder 类。

6.x 版本创建方式

// PHP-DI 6.x
$builder = new \DI\ContainerBuilder();
$container = $builder->build();

7.0 版本新方式

// PHP-DI 7.0 - 简洁创建
$container = new \DI\Container();

// 带定义的创建方式
$container = new \DI\Container([
    \Psr\Log\LoggerInterface::class => \DI\get(MyLogger::class),
]);

废弃方法迁移

- $container = \DI\ContainerBuilder::buildDevContainer();
+ $container = new \DI\Container();

🎯 注解(@Inject)到属性(#[Inject])的迁移

这是最重要的变化！PHP-DI 7.0 使用原生PHP 8属性替代了phpdoc注解。

迁移对比表格

特性	PHP-DI 6.x (注解)	PHP-DI 7.0 (属性)
语法	/** @Inject */	#[Inject]
类型声明	phpdoc @var	PHP原生类型
性能	反射解析注解	原生属性支持
配置	useAnnotations(true)	useAttributes(true)

完整迁移示例

6.x 版本代码

// 容器配置
$containerBuilder = new \DI\ContainerBuilder;
$containerBuilder->useAnnotations(true);

// 类定义
class UserService
{
    /**
     * @Inject
     * @var UserRepository
     */
    private $repository;

    /**
     * @Inject
     * @param LoggerInterface $logger
     */
    public function setLogger($logger)
    {
    }
}

7.0 版本代码

// 容器配置
$containerBuilder = new \DI\ContainerBuilder;
$containerBuilder->useAttributes(true);

// 类定义 - 必须导入属性类
use DI\Attribute\Inject;

class UserService
{
    #[Inject]
    private UserRepository $repository;

    #[Inject]
    public function setLogger(LoggerInterface $logger)
    {
    }
}

属性使用详解

use DI\Attribute\Inject;

class ExampleService
{
    // 基础属性注入
    #[Inject]
    private Dependency $dependency;

    // 指定具体条目注入
    #[Inject('db.host')]
    private string $dbHost;

    // 构造函数参数注入
    public function __construct(
        #[Inject('cache.service')] CacheInterface $cache
    ) {
    }

    // 方法注入
    #[Inject]
    public function initialize(Config $config)
    {
    }

    // 参数级别注入
    #[Inject]
    public function process(
        Request $request, 
        #[Inject('auth.token')] string $token
    ) {
    }
}

⚙️ 容器配置变化

启用属性支持的配置

$builder = new \DI\ContainerBuilder();
$builder->useAttributes(true); // 启用属性支持
$builder->useAutowiring(true); // 自动装配仍然可用

$container = $builder->build();

生产环境配置

$builder = new \DI\ContainerBuilder();
$builder->enableCompilation(__DIR__ . '/var/cache');
$builder->writeProxiesToFile(true, __DIR__ . '/var/proxies');
$builder->useAttributes(true);

$container = $builder->build();

🔧 内部架构变化

如果你扩展或重写了PHP-DI的内部类，需要注意以下变化：

自动装配实现变更

定义源(Definition Source)优化

PHP-DI 7.0 对定义解析进行了重构，提升了对PHP 8特性的支持：

• 更好的类型系统集成
• 改进的属性解析性能
• 增强的编译容器支持

🚨 迁移检查清单

必须完成的项目

•  升级PHP到8.0+
•  替换所有 @Inject 注解为 #[Inject] 属性
•  更新容器配置：useAnnotations(true) → useAttributes(true)
•  移除 ContainerBuilder::buildDevContainer() 调用

推荐完成的项目

•  将phpdoc @var 类型提示改为PHP原生类型声明
•  检查所有自定义扩展类是否兼容新API
•  更新CI/CD管道中的PHP版本要求

验证步骤

•  运行完整的测试套件
•  检查编译容器功能是否正常
•  验证代理生成是否正常工作

💡 常见问题解答

Q: 我可以混合使用注解和属性吗？

A: 不可以。PHP-DI 7.0 只支持属性，必须完全迁移。

Q: 属性注入的性能如何？

A: 由于是PHP 8原生特性，属性注入比注解解析更快，特别是在编译容器中。

Q: 如果我有大量现有代码需要迁移？

A: 可以逐步迁移：

1. 先升级PHP版本
2. 然后逐个模块迁移注解到属性
3. 最后更新容器配置

Q: 属性注入支持哪些PHP 8特性？

A: 支持所有PHP 8特性：联合类型、构造函数属性提升、只读属性等。

🎉 迁移收益

完成迁移后，你将获得：

• 更好的性能: 原生属性支持减少反射开销
• 更强的类型安全: PHP 8的类型系统集成
• 更现代的代码库: 符合PHP 8最佳实践
• 更好的IDE支持: 属性提供更好的代码补全和静态分析

📋 总结

PHP-DI 7.0 的迁移虽然涉及一些破坏性变更，但带来的现代化收益是值得的。关键变化包括：

1. PHP版本要求提升到8.0+
2. 注解全面迁移到PHP 8属性
3. 容器创建API简化
4. 内部架构优化支持现代PHP特性

遵循本指南的步骤，你可以平稳地从PHP-DI 6.x升级到7.0，享受现代化依赖注入容器带来的所有好处。

---

下一步行动:

1. 检查当前PHP版本是否符合要求
2. 使用搜索工具查找所有 @Inject 注解
3. 制定分模块迁移计划
4. 更新CI/CD配置和文档

记得在迁移过程中充分测试，确保业务逻辑不受影响！

【免费下载链接】PHP-DI The dependency injection container for humans 项目地址: https://gitcode.com/gh_mirrors/ph/PHP-DI