ProxyManager版本升级指南与重大变更解析

ProxyManager版本升级指南与重大变更解析

ProxyManager 🎩✨🌈 OOP Proxy wrappers/utilities - generates and manages proxies of your objects 项目地址: https://gitcode.com/gh_mirrors/pr/ProxyManager

项目概述

ProxyManager是一个强大的PHP代理对象生成库，它能够动态创建各种类型的代理对象，包括延迟加载代理、访问控制代理等。本文主要针对ProxyManager不同版本间的重大变更进行详细解析，帮助开发者顺利完成版本升级。

2.0.0版本重大变更

环境要求变化

1. PHP版本要求提升：现在必须使用PHP 7.0或更高版本才能运行ProxyManager
2. HHVM兼容性：不再保证对HHVM的兼容性，因为HHVM尚未完全支持PHP 7特性

类型系统升级

ProxyManager 2.0.0全面采用了PHP 7的类型系统特性：

1. 严格标量类型提示：所有类和接口方法参数都添加了严格的类型声明
2. 返回类型声明：所有方法都添加了返回类型声明

升级影响：如果你继承了ProxyManager\命名空间下的任何类或实现了相关接口，必须修改代码以适应新的方法签名。

代理生成策略变更

1. 默认行为变化：不再默认将代理类写入磁盘，而是使用EvaluatingGeneratorStrategy进行内存评估
2. 生产环境调整：如需保持文件写入行为，需要显式配置生成策略

幽灵对象(Ghost Objects)重构

幽灵对象实现被完全重写，带来以下变化：

1. 延迟加载触发机制：现在通过属性访问（包括私有和公有）触发延迟加载，而非公共API访问
2. 性能优化：新版实现提供了更好的支持和性能表现

兼容性建议：虽然这不是严格意义上的破坏性变更，但建议检查应用中是否依赖幽灵对象的特定行为。

其他重要变更

1. 自动生成策略：当找不到代理类时，ProxyManager会自动尝试生成，忽略原有设置
2. API移除：
   • 移除了ProxyManager\Configuration#setAutoGenerateProxies()方法
   • 移除了ProxyManager\Version::VERSION常量，改用getVersion()方法
3. 私有属性处理：现在能正确处理私有属性，通过友元类访问代理状态不再需要特殊处理
4. 构造函数支持：不再支持PHP 4风格的构造函数

1.0.0版本说明

1.0.0版本与0.5.0版本完全兼容，没有引入破坏性变更。

0.5.0版本重要变更

1. 生成Hydrator移除：生成的Hydrator功能已分离为独立项目
2. __get()方法行为变更：
   • 当同时定义public function __get($name)和公有属性时
   • 在对象初始化期间无法通过引用获取公有属性
3. 代理自动生成策略：
   • 如果代理类无法自动加载，工厂将始终尝试自动生成
   • 相关配置方法变为无操作并被弃用

0.4.0版本变更

1. 类名变形器接口增强：
   • 添加了可选的$options参数
   • 允许参数化生成的类名
2. 生成Hydrator调整：
   • 不再有构造函数参数
   • 所需的反射实例化现在在Hydrator内部处理

0.3.x系列版本变更

0.3.4

• 新增支持为接口生成代理

0.3.3

• 引入了生成的Hydrator功能

0.3.2

• 为延迟加载代理的初始化器添加了可选的引用参数
• 允许以更低开销取消初始化器

0.3.0重大重构

1. 依赖变更：
   • 移除了对jms/cg的依赖
   • 改用Zend\Code进行代码生成
2. 接口增强：
   • 添加了isProxyClassName()方法
3. 自动加载器变更：
   • 构造函数签名变化，新增类名变形器参数
4. 生成策略接口：
   • 使用新的生成策略接口替代旧接口
5. 代码生成逻辑：
   • 完全重写了代码生成逻辑
   • 基于ProxyManager\ProxyGenerator的代码需要重写

0.2.0版本变更

• 初始化器签名变更：调整了延迟加载代理初始化器的参数顺序

升级建议

1. 版本选择：根据你的PHP版本选择合适的ProxyManager版本
2. 逐步升级：建议按照版本顺序逐步升级，而非直接跨越大版本
3. 测试验证：升级后务必进行全面测试，特别是涉及代理对象行为的部分
4. 生产环境：特别注意代理生成策略的变化对生产环境性能的影响

通过理解这些版本间的变更点，开发者可以更顺利地完成ProxyManager的升级工作，同时充分利用新版本带来的性能改进和功能增强。

ProxyManager 🎩✨🌈 OOP Proxy wrappers/utilities - generates and manages proxies of your objects 项目地址: https://gitcode.com/gh_mirrors/pr/ProxyManager