PHP 8.6 的 clamp() 函数可以把一个值限制在指定的最小值与最大值之间。
它的签名如下:
clamp(mixed $value, mixed $min, mixed $max): mixed
clamp() 接收三个参数:$value、$min、$max,然后判断 $value 是否在 $min 与 $max(包含边界)之间。
小于最小值:如果 $value 小于 $min,返回 $min。
大于最大值:如果 $value 大于 $max,返回 $max。
在范围内:如果 $value 位于 $min 与 $max 之间,返回 $value。
异常情况:如果 min > max,或者 min/max 为 NAN,会抛出 ValueError。
下面是一个最简单的示例:
$value1 = clamp(15, 10, 20); // 返回 15
$value2 = clamp(5, 10, 20); // 返回 10
$value3 = clamp(25, 10, 20); // 返回 20
小趣闻:很久以前我就写过一个自定义的 clamp 函数,当作项目里的工具函数来用。
使用命名参数的 clamp()
clamp() 配合命名参数会更直观,而且还能重新排序参数。
$brightness = clamp(min: 0, value: $brightness, max: 100);
真实场景用法
下面是一些 clamp() 的实用场景。
用户输入:把百分比限制在 0 到 100
$percentage = clamp($percentage, 0, 100);
UI 滑块:把音量限制在 0 到 10
$volume = clamp($volume, 0, 10);
分页:把页码限制在第一页与最后一页之间
$page = clamp((int)$_GET['page'] ?? 1, 1, $totalPages);
限流:避免突发请求数超过上限
$requests = clamp($requests, 0, $maxBurst);
日期:确保预订日期在允许窗口内
$date = new DateTimeImmutable($input);
$start = new DateTimeImmutable('2025-08-15');
$end = new DateTimeImmutable('2025-09-15');
$clamped = clamp($date, $start, $end); // 会按情况返回 start/end/date
几何:把角度限制在 0 到 90
$angle = clamp($angle, 0, 90);
字符串(按字典序):把标签限制在 “c” 到 “g”
$tag = clamp($tag, "c", "g");
总结
PHP 8.6 的 clamp() 函数虽然简单,但非常实用:它能帮你用一种更干净、清晰的方式对值进行边界约束。
无论你在处理用户输入、配置、UI 参数,还是任何需要把值限制在某个区间的场景,clamp() 都能让代码更直观。
想了解更多,可以阅读关于 clamp() 的 RFC。