php报错：filter_var(): explicit use of FILTER_FLAG_SCHEME_REQUIRED and FILTER_FLAG_HOST_REQUIRED is dep

关注

转载最新推荐文章于 2025-12-29 10:49:19 发布 1.6k 阅读 AI 写同款· GEO 优化 ›

NXOpenC#-通用NX对象操作Tag,Handle,TaggedObject介绍阅读详情

PHP7.3.0+弃用FILTER_FLAG_SCHEME_REQUIRED的解决办法
今天本地调用一个接口报错了：
filter_var(): explicit use of FILTER_FLAG_SCHEME_REQUIRED and FILTER_FLAG_HOST_REQUIRED is deprecated
但测试环境没有报错，于是查看了一下测试环境的 PHP 版本，是7.1.5，而我开发机的 PHP 版本是7.3.4。
再去看 PHP 手册关于 FILTER_FLAG_SCHEME_REQUIRED 的介绍，Changelog里“赤裸裸”地写着：
7.3.0 The explicit usage of FILTER_FLAG_SCHEME_REQUIRED and FILTER_FLAG_HOST_REQUIRED has been deprecated.
好吧， FILTER_FLAG_SCHEME_REQUIRED 这个过滤器已经从7.3.0开始被弃用了，那就只能改造一下调用的方法了，代码如下：
private function prependMissingScheme( $KaTeX parse error: Expected '}', got 'EOF' at end of input: \dotsf (!filter_var($ host, FILTER_VALIDATE_URL, FILTER_FLAG_SCHEME_REQUIRED)) {
$host = ‘http://’ . $host;
}
return $host;
}
FILTER_FLAG_SCHEME_REQUIRED是干嘛用的呢？可以看一下FILTER_VALIDATE_URL，它也是一个过滤器，把值作为 URL 来验证，有以下几个标识：

FILTER_FLAG_SCHEME_REQUIRED - 要求 URL 是 RFC 兼容 URL（比如 http://example）
FILTER_FLAG_HOST_REQUIRED - 要求 URL 包含主机名（比如 http://www.example.com）
FILTER_FLAG_PATH_REQUIRED - 要求 URL 在域名后存在路径（比如 www.example.com/example1/test2/）
FILTER_FLAG_QUERY_REQUIRED - 要求 URL 存在查询字符串（比如 “example.php?name=Peter&age=37”）
也就是说，代码中的filter_val()方法是想判断变量 $host 有没有形似于“http://”或“https://”的内容，如果没有，就拼接一个“http://”字符串。

既然从7.3.0版本开始无法用FILTER_FLAG_SCHEME_REQUIRED了，可以用什么函数代替呢？翻手册找到了parse_url()，这个函数用来解析一个 URL 并返回一个关联数组，包含在 URL 中出现的各种组成部分。语法如下：
parse_url ( string $url [, int $component = -1 ] ) : mixed
PHP手册关于parse_url()有这样一段说明：
Specify one of PHP_URL_SCHEME, PHP_URL_HOST, PHP_URL_PORT, PHP_URL_USER, PHP_URL_PASS, PHP_URL_PATH, PHP_URL_QUERY or PHP_URL_FRAGMENT to retrieve just a specific URL component as a string (except when PHP_URL_PORT is given, in which case the return value will be an integer).
看！PHP_URL_SCHEME！是不是和已经弃用的 FILTER_FLAG_SCHEME_REQUIRED 很像？！手册也给出了例子：

<?php $url = 'http://username:password@hostname:9090/path?arg=value#anchor'; print_r(parse_url($url)); // Array ( [scheme] => http [host] => hostname [port] => 9090 [user] => username [pass] => password [path] => /path [query] => arg=value [fragment] => anchor ) print_r(parse_url($url, PHP_URL_SCHEME)); // http print_r(parse_url($url, PHP_URL_USER)); // username print_r(parse_url($url, PHP_URL_PASS)); // password print_r(parse_url($url, PHP_URL_HOST)); // hostname print_r(parse_url($url, PHP_URL_PORT)); // 9090 print_r(parse_url($url, PHP_URL_PATH)); // /path print_r(parse_url($url, PHP_URL_QUERY)); // arg=value print_r(parse_url($url, PHP_URL_FRAGMENT)); // anchor 所以可以用parse_url()函数配合 PHP_URL_SCHEME 验证即可。 private function prependMissingScheme($host){ // 也可以写成 // if (!isset(parse_url($host)['scheme'])) { if (empty(parse_url($host, PHP_URL_SCHEME)) { $host = 'http://' . $host; } return $host; } 需要注意的是，parse_url()不能验证给定 URL 的合法性，只是将给定的 URL 分解为上面列出的各部分。不完整的 URL 也被接受，parse_url()会尝试尽量正确地将其解析。