php 8.6可以用time\duration统一表达重试等待时长,通过工厂方法创建对象,用add()和multiplyby()计算,再比较并限制上限。它表示固定经过时间,适合毫秒级退避;日历月份和跨夏令时日期仍应使用dateinterval与日期对象。截至11月18日8.6仍处于发布前阶段,以下代码用于具备对应接口的8.6测试环境。

Time\Duration区分固定时长与日历间隔,运算返回新对象。
把单位留在创建位置
<?php
declare(strict_types=1);
use Time\Duration;
function retryDelay(int $attempt): Duration
{
if ($attempt < 0 || $attempt > 10) {
throw new InvalidArgumentException('attempt必须在0到10之间');
}
$base = Duration::fromSeconds(1);
$step = Duration::fromMilliseconds(100);
$delay = $base->add($step->multiplyBy(2 ** $attempt));
return min($delay, Duration::fromSeconds(30));
}
foreach ([0, 1, 4, 10] as $attempt) {
$delay = retryDelay($attempt);
printf("%d: %d.%09d秒\n", $attempt, $delay->seconds, $delay->nanoseconds);
}保存为delay.php,用目标8.6解释器执行。按上述公式,四个间隔分别为1.1秒、1.2秒、2.6秒和30秒。限制attempt的范围避免指数无限增大;30秒是应用选择的上限,并非Duration类型自身的最大范围。
不修改原对象,也不直接使用加减运算符
add()、sub()和multiplyBy()返回新的Duration;需要保存计算结果,不能调用后仍读取旧对象。类型支持大小比较,可直接用于min();普通算术运算符不受支持。工厂最大单位是小时,不能把日历中的“一天”或“一月”无条件当成固定秒数。

seconds与nanoseconds保存绝对量,negative单独保存符号。
传给等待函数前处理符号与中断
seconds和nanoseconds本身非负,负号单独保存在negative。把任意Duration传给time_nanosleep()前,应先拒绝negative为true的值;本例只使用非负输入。等待函数还可能被信号中断,调用方应根据其返回的剩余秒数和纳秒数决定是否继续等待,不能把调用返回等同于业务重试已经完成。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
超过类型可表示范围的计算会抛出Time\TimeException。迁移旧代码时先标明原有数字的毫秒、微秒或秒单位,再分别替换工厂方法;只把整数换成对象而不核对原单位,会保留原来的时间错误。
立即学习“PHP免费学习笔记(深入)”;


















