PHP 怎样用不可变日期对象避免链式修改

把共享的基准日期保留为 DateTimeImmutable，并显式接收 modify() 等调整方法返回的新对象，就能避免某次日期计算顺手改变其他分支的输入。不可变并不是禁止链式调用：可以链式派生，只是原实例不被这些调整方法改写，最终结果必须保存或返回。

官方方法说明：https://www.php.net/manual/en/datetimeimmutable.modify.php。

关注的是值语义，不是又一种日期写法

日期常常同时传给提醒、截止时间和展示模块。如果其中一个模块原地调整日期，其他模块看到的值也可能随之变化。选择不可变对象的意义，是让每次调整成为一个明确的新值，减少调用者之间对“谁改过它”的依赖。

这是一项既有 PHP 能力，不是近期新发布功能；这里没有采用率或热度数据。是否值得引入，应看项目有没有共享日期、多分支派生和隐式修改问题，而不是把不可变当成所有日期代码的统一答案。

为什么复制变量名没有隔离对象

以一个原创场景为例：订单创建后，提醒日期加两天，截止日期加五天，二者都应基于同一个创建日期。如果使用可变 DateTime，普通变量赋值并不会自动复制实例，两个变量可能持有同一对象标识。

modify('+2 days');

// 这里 base 也已改变；不要把 reminder 当成独立日期
echo $base->format('Y-m-d H:i:s');

上述示例预期显示四月十二日，不是原来的四月十日。这是语义推演，本文未执行代码。问题并不只存在于链式调用：只调用一次可变方法也能修改共享对象。DateTime 官方说明也指出修改方法会改变实例，需要隔离时可克隆，或者使用不可变类型。参考：https://www.php.net/manual/en/class.datetime.php。

提醒与截止日期应从同一基准独立派生

改用不可变类型后，让 base、reminder 和 deadline 各自表达不同业务含义。下面的 UTC 固定输入避开了当前时间和机器默认时区造成的演示差异；示例只讨论对象是否被改写，不替代真实业务的日历规则。

modify('+2 days');
$deadline = $base->modify('+5 days');

// 链式派生是允许的；setTime 作用于前一个返回的新对象
$deadlineAtClose = $deadline->setTime(18, 0);

echo $base->format('Y-m-d H:i:s') . PHP_EOL;
echo $reminder->format('Y-m-d H:i:s') . PHP_EOL;
echo $deadlineAtClose->format('Y-m-d H:i:s') . PHP_EOL;

预期 base 为四月十日九点，reminder 为四月十二日九点，deadlineAtClose 为四月十五日十八点。deadline 本身仍保持四月十五日九点。这里的关键不是创建了多少变量，而是所有需要保留的派生值都明确接收了返回对象。

如果写成 $base->modify('+2 days')->modify('+5 days')，得到的是累计增加七天的派生值，而不是两个独立分支。不可变保证不原地修改基准，不会猜测“后面五天”究竟是相对原点还是相对中间值。

最大的迁移风险是丢弃返回值

旧代码可能习惯调用调整方法后继续使用原变量。把类名替换为 DateTimeImmutable 而不改赋值方式，可能使调整结果完全没有被使用。建议明确写出结果名称，或者在确实不再需要旧值时将新对象赋回原变量。重新赋值变量并不等于原对象被修改。

不可变也不负责纠正非法日期表达式、月末规则或时区选择。PHP 8.3 起，面向对象的 modify 遇到非法表达式会抛出 DateMalformedStringException；旧版本曾使用警告并返回 false。跨版本项目要按运行版本设计错误处理，不能把任意外部字符串直接接进长链，也不能把所有失败默默转换为原日期。

先在边界转换，再明确函数返回类型

收益较明显的地方，是一个日期会传入多个计算函数的业务层。外部库仍要求 DateTime 时，不必一次重写所有接口，可先在输入边界创建不可变副本，让内部计算保持同一契约，再在确有需要的输出位置适配。

modify('+2 days');
}

$reminder = buildReminder($anchor);

createFromMutable 创建包含同一日期时间及时区信息的新不可变实例，不修改原来的 DateTime。不要把它理解成两者持续同步：之后旧对象再变更，不会自动重算已产生的派生日期。官方转换说明：https://www.php.net/manual/en/datetimeimmutable.createfrommutable.php。

采用效果看基准与分支是否独立

适合保留的回归断言包括：计算前后基准格式化值一致；改变两个独立分支的调用顺序不改变各自结果；业务函数返回的对象被实际使用；旧输入对象没有被转换动作修改。本文只给出检查建议，不声称已运行测试或获得性能改进。

还需要 clone 吗？对本文展示的不可变调整方法，接收新返回值即可，不必为隔离调整先克隆。还能链式调用吗？可以，但链条表达累计派生，末尾结果要接收。DateTimeInterface 就能保证不可变吗？不能把同时接受可变和不可变实现的宽接口当成不可变承诺；需要这一约束时应在边界归一化并明确函数类型。

最终取舍是：用不可变实例守住原始输入，用命名清楚的返回值表达业务日期，用测试守住分支独立性。它能减少共享修改的隐患，但日期规则本身仍要由业务明确。