php 8.5 中 filter_var() 新增 filter_flag_throw_on_failure 标志，使验证失败时抛出 valueerror 而非返回 false，需配合 filter_validate_* 类过滤器使用，不兼容 filter_sanitize_*，且必须显式传入，不影响旧代码。
filter_var() 在 PHP 8.5 新增 FILTER_FLAG_THROW_ON_FAILURE 怎么用
PHP 8.5 给 filter_var() 加了个新标志：FILTER_FLAG_THROW_ON_FAILURE。它不是替代原有逻辑，而是让失败时抛出 ValueError，而不是默默返回 false 或原值。
典型场景是校验用户输入（比如邮箱、整数、URL），你原本得写一堆 if ($result === false) 判断，现在可以统一用 try/catch 捕获——前提是显式传入这个标志。
- 必须和具体 filter 一起用，单独传没效果，比如
filter_var($email, FILTER_VALIDATE_EMAIL, FILTER_FLAG_THROW_ON_FAILURE) - 不加这个标志时，
filter_var()对无效输入一律返回false（或null，取决于 filter 类型），这是向后兼容行为，不会变 - 加了之后，只要 filter 判定为“失败”，立刻抛
ValueError，消息里会包含 filter 名称，比如"filter_var(): Validation failed for filter 'validate_email'" - 注意：它只影响“验证类” filter（如
FILTER_VALIDATE_EMAIL、FILTER_VALIDATE_INT），对“过滤类” filter（如FILTER_SANITIZE_STRING）无意义，后者本就不失败
// PHP 8.5+
try {
$id = filter_var($_GET['id'] ?? '', FILTER_VALIDATE_INT, FILTER_FLAG_THROW_ON_FAILURE);
} catch (ValueError $e) {
// 处理非法 ID，比如返回 400
http_response_code(400);
exit('Invalid ID');
}
为什么不用 is_int() + intval() 替代？
因为 filter_var() 做的是语义校验，不是类型转换。比如 '123abc' 用 FILTER_VALIDATE_INT 会失败；而 intval('123abc') 返回 123，看似“成功”，实则丢了数据完整性。
-
is_int()只能判断变量当前类型，对字符串输入完全无效 -
intval()和(int)是强制转换，会静默截断或归零（如intval('abc')→0），掩盖错误 -
filter_var(..., FILTER_VALIDATE_INT)要求输入是纯整数字符串，更贴近业务意图：“这个参数必须是一个合法整数” - 加上
FILTER_FLAG_THROW_ON_FAILURE后，校验失败不再需要分支判断，逻辑更线性，也更容易统一错误处理
和 filter_input() 一起用要注意什么
filter_input() 也支持这个新标志，但容易漏掉一个关键点：它默认对未设置的变量返回 null，而 null 传给验证 filter 会被当作“空输入”处理——有些 filter（如 FILTER_VALIDATE_EMAIL）对空字符串返回 false，触发异常；有些（如 FILTER_VALIDATE_INT）则可能接受空并返回 false，也抛异常。
立即学习“PHP免费学习笔记（深入）”；
- 如果字段是可选的，别直接套用
FILTER_FLAG_THROW_ON_FAILURE，先检查是否 set：filter_has_var(INPUT_GET, 'id') - 如果字段必填，那正好，
filter_input()返回null也会被验证 filter 拒绝，从而抛异常，符合预期 - 注意
filter_input()的第三个参数是选项数组，不是位标志，所以要写成：filter_input(INPUT_GET, 'email', FILTER_VALIDATE_EMAIL, ['flags' => FILTER_FLAG_THROW_ON_FAILURE]) - 老代码里习惯用
filter_input(..., ..., FILTER_SANITIZE_...)的地方，这个标志无效，别乱加
升级到 PHP 8.5 后，旧代码会崩吗
不会。这个标志是 opt-in 的，所有现有调用行为完全不变。你得主动加，才会改变失败路径。
- 如果你在 PHP 8.4 或更早版本用了这个常量，会报
Undefined constant致命错误——部署前记得检查 PHP 版本 - CI/CD 流程里，建议在
php -v后加一行php -r "echo defined('FILTER_FLAG_THROW_ON_FAILURE') ? 'ok' : 'fail';"防止误部署 - 框架封装了
filter_var()的（比如 Laravel 的validate()、Symfony 的Validator），它们还没适配这个标志，别指望框架自动用上 - 最易忽略的一点：错误日志里
ValueError默认不带 trace，如果没配置全局异常处理器，可能只看到 “Uncaught ValueError”，查不到哪行触发的——务必确保开发环境开启display_errors或捕获后打完整 trace
