避免 Carbon 时间操作中的引用问题：copy() 方法详解

Carbon 作为 PHP 中一个功能强大的日期时间处理库，在 Laravel 等框架中被广泛使用。它提供了丰富的方法来简化日期时间的创建、格式化和计算。然而，在使用 Carbon 对象进行时间操作时，一个常见的误解和由此引发的问题是，许多修改日期时间的方法（例如 setTime、addDay、subMonth 等）实际上是直接修改了当前 Carbon 实例，而不是返回一个新的 Carbon 实例。这种“可变性”行为如果不被正确理解和处理，可能导致意料之外的结果，尤其是在尝试从同一个基础日期派生出多个具有不同时间的变量时。

Carbon 对象的引用行为解析

在 PHP 中，对象通常是通过引用进行传递和操作的。当我们将一个对象赋值给另一个变量时，这两个变量实际上指向了内存中的同一个对象。Carbon 对象也不例外。当你在一个 Carbon 实例上调用 setTime(hour, minute) 方法时，这个方法会直接修改当前对象的小时和分钟部分，并且返回的仍然是当前对象的引用。

考虑以下场景，我们有一个基础的 Carbon 日期对象 $date，然后我们尝试从它派生出两个具有不同时间的变量 $this-youjiankuohaophpcntemp_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。这是因为：

1. $this->temp_mon_start = $date->setTime(8, 0); 这行代码执行后，$date 对象本身的时间被修改为 8:00，并且 $this->temp_mon_start 也指向了这个被修改后的 $date 对象。
2. 接着，$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 实例，这个新实例与原始对象具有相同的值，但它们在内存中是完全独立的。

AI建筑知识问答

用人工智能ChatGPT帮你解答所有建筑问题

22

查看详情

修改后的代码示例如下：

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 的独立副本，它们各自的时间修改互不影响。

注意事项与最佳实践

1. 可变性是 Carbon 的特性： 并非所有日期时间库都采取这种可变性设计（例如 PHP 内置的 DateTimeImmutable 类就是不可变的）。理解 Carbon 的这一特性是正确使用的关键。
2. 不仅限于 setTime： 任何修改 Carbon 实例的方法，如 addDay()、subMonth()、startOfDay()、endOfWeek() 等，都具有相同的可变性。当你需要基于一个现有 Carbon 实例进行操作，并且希望保留原始实例或创建多个独立的修改版本时，都应该优先考虑使用 copy()。
3. 链式调用： copy() 方法可以很自然地与 Carbon 的其他方法进行链式调用，使得代码更加简洁和易读。
4. 性能考量： copy() 会创建新的对象实例，这会带来轻微的性能开销。但在大多数应用场景中，这种开销是微不足道的，并且为了代码的正确性和可维护性，使用 copy() 是非常值得的。只有在极端性能敏感的循环中，才需要仔细权衡。
5. 养成良好习惯： 在处理 Carbon 对象时，如果你的意图是创建一个新的、独立的时间点，而不是修改现有时间点，那么就应该条件反射地想到使用 copy()。

总结

Carbon 库的强大功能伴随着其对象可变性的特性。理解 setTime 等方法直接修改原对象而非返回新实例的行为，是避免在日期时间操作中引入隐蔽 bug 的关键。通过在需要创建独立日期时间实例时主动使用 copy() 方法，开发者可以有效管理 Carbon 对象的引用关系，确保每个时间变量都拥有其独立的生命周期和状态，从而编写出更加健壮和可预测的日期时间处理代码。掌握这一技巧，将大大提升你在 Laravel 或其他 PHP 项目中处理日期时间的效率和准确性。

以上就是避免 Carbon 时间操作中的引用问题：copy() 方法详解的详细内容，更多请关注php中文网其它相关文章！