DeepCopy 库需手动配置才能可靠处理循环引用、闭包等复杂情况；安装后须引入 autoload、正确使用命名空间，并针对闭包、资源、单例依赖等显式设置过滤策略，否则易报错或行为异常。
DeepCopy 库能可靠地处理循环引用、闭包、资源、私有属性等棘手情况，比 clone 或 unserialize(serialize($obj)) 更安全——但直接 composer require myclabs/deep-copy 后不配置就用，大概率会遇到 Serialization of Closure is not allowed 或属性丢失。
安装后必须手动启用 DeepCopy 类自动加载
Composer 安装成功只是第一步。DeepCopy 不提供全局函数或静态入口，所有操作都基于 DeepCopy\DeepCopy 类实例。若忘记 require 'vendor/autoload.php' 或未在 PSR-4 环境中正确引入命名空间，会报 Class 'DeepCopy\DeepCopy' not found。
实操建议：
- 确认
vendor/autoload.php已在入口文件（如index.php）顶部require - 使用前加
use DeepCopy\DeepCopy;，或全程用完整命名空间$copier = new \DeepCopy\DeepCopy(); - 检查
composer.json中"myclabs/deep-copy"是否出现在require区块且版本号 ≥ 1.10（旧版对 PHP 8+ 支持不佳）
默认行为不复制闭包和资源，需显式配置策略
DeepCopy 默认跳过 Closure 和 resource 类型，否则抛出 Serialization of 'Closure' is not allowed。这不是 bug，是设计上的保守策略。如果你的对象里有事件监听器、回调属性或数据库连接句柄，必须提前告诉 DeepCopy 怎么处理它们。
立即学习“PHP免费学习笔记（深入）”；
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
实操建议：
- 跳过闭包：用
$copier->addFilter(new \DeepCopy\Filter\KeepFilter(), new \DeepCopy\Matcher\PropertyMatcher('callback')); - 深拷贝可序列化的闭包（PHP 7.4+）：需配合
DeepCopy\Filter\ReplaceFilter+ 自定义回调，但多数场景应避免拷贝闭包 - 资源（如
fopen()返回值）无法真正“拷贝”，只能设为null或用KeepFilter保留原引用——根据业务逻辑决定是否合理
处理循环引用时，ignoreMatcher 和 keepMatcher 的选择很关键
当对象图中存在 A→B→A 这类引用，DeepCopy 默认能检测并避免无限递归。但如果你误用 IgnoreFilter 替代 KeepFilter，会导致本该共享的依赖被切断，引发后续逻辑异常（比如两个副本各自持有一个独立的 logger 实例，而非共用同一个）。
实操建议：
- 对「应当保持单例语义」的依赖（如日志器、配置容器），用
KeepFilter+PropertyMatcher或ClassMatcher - 对「纯粹为导航临时存在」的反向引用（如
User有$posts，Post又有$author），用IgnoreFilter更安全 - 测试时打印
spl_object_id($original->logger)和spl_object_id($copy->logger)，确认是否符合预期
真正难的不是调用 $copier->copy($obj)，而是想清楚哪些引用该断、哪些该留、哪些根本不能碰——尤其是当对象嵌套了 Doctrine Entity、Laravel Request 或自定义魔术方法时，一个没配对的 Filter 就会让副本在运行时悄悄偏离预期。
