php 8.6的clamp($value, $min, $max)可以把分页数量限制在允许区间,但应先把外部输入校验为整数,再调用clamp()。该函数沿用php比较规则,不负责判断输入是否是合法页数,也不会统一转换返回值类型。以下示例用于具备clamp()的8.6测试环境;截至11月18日正式版尚未发布。

clamp接受可比较值,混合类型需要先由业务代码规范化。
校验整数后限制到1至100
<?php
declare(strict_types=1);
function pageSize(mixed $raw): int
{
if ($raw === null) {
return 20;
}
if (!is_string($raw) && !is_int($raw)) {
throw new InvalidArgumentException('分页数量必须是整数');
}
$size = filter_var($raw, FILTER_VALIDATE_INT);
if ($size === false) {
throw new InvalidArgumentException('分页数量必须是整数');
}
return clamp($size, 1, 100);
}
try {
$size = pageSize($_GET['limit'] ?? null);
echo $size;
} catch (InvalidArgumentException $e) {
http_response_code(400);
echo 'limit参数无效';
}不传limit时使用20;传入0时得到1,传入200时得到100;abc、1.5或数组形式的输入返回400。这里选择“合法整数超界后收窄”的业务规则,如果产品要求超界直接报错,就应改成明确的范围校验。
不要让不同类型替业务决定大小
clamp()返回命中的原参数,不会自动转成同一种类型。非数字字符串与整数的比较可能变成字符串比较;金额、时间或其他对象也应先建立一致的比较规则。分页示例让三个参数都是整数,因此函数返回值也可明确声明为int。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。

下界大于上界、边界值为NAN都会引发ValueError。
边界来自配置时也要验证
若min大于max,或任一边界为NAN,clamp()抛出ValueError;value为NAN时则返回NAN。动态读取配置的代码应在启动或装载时验证边界,不应把配置错误一律转成用户参数错误。8.5及更旧版本没有该新函数,切换解释器前须保留原来的显式边界逻辑或做好版本兼容。


















