Carbon 作为 PHP 中一个功能强大的日期时间处理库，在 Laravel 等框架中被广泛使用。它提供了丰富的方法来简化日期时间的创建、格式化和计算。然而，在使用 Carbon 对象进行时间操作时，一个常见的误解和由此引发的问题是，许多修改日期时间的方法（例如 setTime、addDay、subMonth 等）实际上是直接修改了当前 Carbon 实例，而不是返回一个新的 Carbon 实例。这种“可变性”行为如果不被正确理解和处理，可能导致意料之外的结果，尤其是在尝试从同一个基础日期派生出多个具有不同时间的变量时。
Carbon 对象的引用行为解析
在 PHP 中，对象通常是通过引用进行传递和操作的。当我们将一个对象赋值给另一个变量时，这两个变量实际上指向了内存中的同一个对象。Carbon 对象也不例外。当你在一个 Carbon 实例上调用 setTime(hour, minute) 方法时，这个方法会直接修改当前对象的小时和分钟部分，并且返回的仍然是当前对象的引用。
考虑以下场景，我们有一个基础的 Carbon 日期对象 $date，然后我们尝试从它派生出两个具有不同时间的变量 $this->temp_mon_start 和 $this->temp_mon_end：
use Carbon\Carbon;
// 假设 $date 是一个 Carbon 实例，例如 Carbon::now()
$date = Carbon::parse('2021-11-15 12:34:56');
$this->temp_mon_start = $date->setTime(8, 0); // 设置为 8:00
$this->temp_mon_end = $date->setTime(3, 0); // 设置为 3:00
// 打印这两个变量以观察其值
dd($this->temp_mon_start, $this->temp_mon_end);根据直觉，我们可能期望 $this->temp_mon_start 应该是 2021-11-15 08:00:00，而 $this->temp_mon_end 应该是 2021-11-15 03:00:00。然而，实际的输出结果会是：
date: 2021-11-15 03:00:00.0 Asia/Singapore (+08:00) date: 2021-11-15 03:00:00.0 Asia/Singapore (+08:00)
这个结果表明，两个变量最终都指向了 2021-11-15 03:00:00。这是因为：
- $this->temp_mon_start = $date->setTime(8, 0); 这行代码执行后，$date 对象本身的时间被修改为 8:00，并且 $this->temp_mon_start 也指向了这个被修改后的 $date 对象。
- 接着，$this->temp_mon_end = $date->setTime(3, 0); 这行代码再次在 同一个 $date 对象上调用 setTime，将其时间修改为 3:00。此时，$date 对象的时间变为 3:00，而 $this->temp_mon_start 和 $this->temp_mon_end 都仍然指向这个 $date 对象，因此它们都显示为 3:00。
解决方案：使用 copy() 方法创建独立实例
为了避免这种引用问题，确保每个变量都拥有一个独立的 Carbon 实例，我们应该在进行修改操作之前，先使用 Carbon 提供的 copy() 方法创建一个原始对象的副本。copy() 方法会返回一个全新的 Carbon 实例，这个新实例与原始对象具有相同的值，但它们在内存中是完全独立的。
修改后的代码示例如下：
use Carbon\Carbon;
// 假设 $date 是一个 Carbon 实例
$date = Carbon::parse('2021-11-15 12:34:56');
// 先复制 $date，然后在新副本上设置时间
$this->temp_mon_start = $date->copy()->setTime(8, 0);
// 再次复制 $date，然后在新副本上设置时间
$this->temp_mon_end = $date->copy()->setTime(3, 0);
// 打印这两个变量以观察其值
dd($this->temp_mon_start, $this->temp_mon_end);现在，dd() 的输出将符合我们的预期：
date: 2021-11-15 08:00:00.0 Asia/Singapore (+08:00) date: 2021-11-15 03:00:00.0 Asia/Singapore (+08:00)
通过在每次需要基于 $date 创建一个独立且可修改的时间变量时调用 copy()，我们确保了 $this->temp_mon_start 和 $this->temp_mon_end 分别是 $date 的独立副本，它们各自的时间修改互不影响。
注意事项与最佳实践
- 可变性是 Carbon 的特性： 并非所有日期时间库都采取这种可变性设计（例如 PHP 内置的 DateTimeImmutable 类就是不可变的）。理解 Carbon 的这一特性是正确使用的关键。
- 不仅限于 setTime： 任何修改 Carbon 实例的方法，如 addDay()、subMonth()、startOfDay()、endOfWeek() 等，都具有相同的可变性。当你需要基于一个现有 Carbon 实例进行操作，并且希望保留原始实例或创建多个独立的修改版本时，都应该优先考虑使用 copy()。
- 链式调用： copy() 方法可以很自然地与 Carbon 的其他方法进行链式调用，使得代码更加简洁和易读。
- 性能考量： copy() 会创建新的对象实例，这会带来轻微的性能开销。但在大多数应用场景中，这种开销是微不足道的，并且为了代码的正确性和可维护性，使用 copy() 是非常值得的。只有在极端性能敏感的循环中，才需要仔细权衡。
- 养成良好习惯： 在处理 Carbon 对象时，如果你的意图是创建一个新的、独立的时间点，而不是修改现有时间点，那么就应该条件反射地想到使用 copy()。
总结
Carbon 库的强大功能伴随着其对象可变性的特性。理解 setTime 等方法直接修改原对象而非返回新实例的行为，是避免在日期时间操作中引入隐蔽 bug 的关键。通过在需要创建独立日期时间实例时主动使用 copy() 方法，开发者可以有效管理 Carbon 对象的引用关系，确保每个时间变量都拥有其独立的生命周期和状态，从而编写出更加健壮和可预测的日期时间处理代码。掌握这一技巧，将大大提升你在 Laravel 或其他 PHP 项目中处理日期时间的效率和准确性。
