前言一个很典型的场景本地测试时file_exists(/data/upload/a.jpg)判断得好好于是照着写了file_exists(https://cdn.example.com/a.jpg)去检查远程图片是否还在结果无论那个地址是不是真的存在返回值永远是 false。换成is_file()、is_readable()也一样全都是 false。更让人困惑的是连一条明确的报错都看不到控制台干干净净只有结果不对。这不是你的代码写错了而是file_exists()的工作方式和 HTTP 协议的能力天生对不上。file_exists()底层调用的是文件系统的stat()家族函数而 PHP 的 HTTP 流包装器stream wrapper根本不支持stat()。查不到文件的元信息函数只能返回 false——它并不是在说文件不存在而是在说我查不了。本文会解释这个机制为什么必然导致 false、哪些包装器支持、哪些不支持然后给出三种真正能用的远程文件探测方法含超时和重定向处理最后是一份完整可运行的代码和几个很容易踩的坑。一、根本原因file_exists 依赖 stat而 HTTP 不支持 stat1.1 流包装器与 stat 家族PHP 把file_exists()、is_file()、is_dir()、filesize()、filemtime()、stat()这一组函数统称为 stat 家族它们只读取元信息不读取文件内容。这些函数并不是直接操作磁盘而是交给流包装器stream wrapper去执行。本地路径由内置的file://包装器处理http://和https://则分别由 HTTP 包装器处理。问题就出在这里HTTP 协议没有给我一个文件的元信息这种请求方式。要获取Content-Length、Last-Modified这些信息必须先发一次请求拿到响应头而 HTTP 包装器并没有实现这套语义。于是 stat 家族函数遇到 HTTP 地址时必然失败。包装器是否支持 stat 家族说明file://本地路径支持最常见的用法http:///https://不支持所以file_exists()恒为 falseftp://部分支持实际行为受服务器与 PHP 版本影响不建议依赖php://、data://不支持不是真实文件phar://支持读取归档内部条目判断某种包装器到底支不支持最靠谱的办法是查官方文档里支持的协议与包装器一页中每个包装器对应的受支持的 stat() 相关功能一栏——那里是权威答案比在网上抄经验可靠。1.2 一个能直接验证的实验?php // 需要 PHP 7.4把 URL 换成任何真实存在的公开地址结果都一样 $local __FILE__; $remote https://www.example.com/index.html; var_dump(file_exists($local)); // bool(true) var_dump(is_file($local)); // bool(true) var_dump(file_exists($remote)); // bool(false) —— 即使这个地址返回 200 var_dump(is_readable($remote)); // bool(false) // 对比同样的地址交给 stat()报错信息会直接告诉你不支持 var_dump(stat($remote)); // bool(false)并伴随 stat failed 警告注意最后一行用stat()时你会看到一条警告而file_exists()把它吞掉了。这就是没有报错却结果不对的来源。1.3 还有一层门槛allow_url_fopen即使某个包装器支持 stathttp://和https://这两个包装器本身是否被注册还取决于allow_url_fopen配置。当它被关闭时连fopen()、get_headers()、file_get_contents()调用 HTTP 地址都会失败。生产环境出于安全考虑关闭它是很常见的做法。?php // 检查当前环境是否允许访问远程 URL var_dump(ini_get(allow_url_fopen)); // 1 表示开启0 或空表示关闭 var_dump(in_array(http, stream_get_wrappers(), true)); // 是否注册了 http 包装器排查第一步就该跑这两行。如果allow_url_fopen是关的那么不管你怎么改写 stat 家族的调用都没用必须换 cURL 或让运维开启配置。二、三种可用的替代方案对比既然 stat 家族走不通就得改成发一次真实的 HTTP 请求看响应状态码。三种做法各有取舍方案依赖请求方式适用场景get_headers()allow_url_fopen开启GET只取响应头代码最简单内网脚本够用cURL 发 HEAD 请求cURL 扩展HEAD推荐可控超时与重定向cURL 发 GET 请求 RangecURL 扩展范围请求HEAD 被服务器拒绝时的兜底2.1 用 get_headers 看状态码?php // 需要 PHP 5.0$context 参数在 PHP 7.1 可用 $url https://www.example.com/index.html; $headers get_headers($url); if ($headers false) { echo 请求都没发出去检查 allow_url_fopen\n; } else { // 数组的第 0 个元素就是状态行例如HTTP/1.1 200 OK echo $headers[0], \n; echo strpos($headers[0], 200) ! false ? 存在\n : 不存在\n; }get_headers()的短板是没有超时控制只能通过流上下文设置且默认超时时间可能长达几十秒而且在被 302 重定向时会返回多组响应头直接看第 0 个元素可能读到 302 而不是最终的 200需要自己遍历。所以它适合临时排查不适合放进正式的业务流程里批量调用。2.2 用 cURL 发 HEAD 请求cURL 可以精确控制超时、重定向次数和用户代理是生产环境的推荐做法。HEAD 请求只取响应头不会把文件内容下载下来。?php // 需要 PHP 5.5使用了 array 语法与匿名函数cURL 扩展 function remoteFileExistsByHead(string $url, int $timeout 5): bool { $ch curl_init(); curl_setopt_array($ch, [ CURLOPT_URL $url, CURLOPT_NOBODY true, // 只发 HEAD不下载正文 CURLOPT_RETURNTRANSFER true, CURLOPT_FOLLOWLOCATION true, // 跟随 301/302 CURLOPT_MAXREDIRS 3, // 最多跟 3 跳避免死循环 CURLOPT_CONNECTTIMEOUT $timeout, CURLOPT_TIMEOUT $timeout, CURLOPT_USERAGENT MyApp/1.0, ]); $ok curl_exec($ch); if ($ok false) { // 网络层就失败了DNS 解析不了、连不上、超时 error_log(curl 错误 . curl_error($ch)); curl_close($ch); return false; } $code (int) curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); return $code 200 $code 300; } var_dump(remoteFileExistsByHead(https://www.example.com/index.html));这里必须强调一个容易被忽略的点200不是唯一的存在信号。CDN 或对象存储经常返回206范围响应、304缓存有效这些都应该算存在而401、403表示文件在那里但你没权限访问很多业务场景下也算存在。用$code 200这种精确判断会把一部分真实存在的文件误判成不存在。2.3 HEAD 被拒时的兜底范围请求有一批服务器尤其是部分对象存储和带 WAF 的站点会直接对 HEAD 请求返回403或405。这时可以退一步发 GET 请求但只取前几个字节?php // 需要 PHP 5.5用 CURLOPT_RANGE 只拉前 1 个字节代价极小 function remoteFileExistsByRange(string $url, int $timeout 5): bool { $ch curl_init(); curl_setopt_array($ch, [ CURLOPT_URL $url, CURLOPT_RETURNTRANSFER true, CURLOPT_HEADER true, CURLOPT_FOLLOWLOCATION true, CURLOPT_MAXREDIRS 3, CURLOPT_CONNECTTIMEOUT $timeout, CURLOPT_TIMEOUT $timeout, CURLOPT_RANGE 0-0, // 只要第 0 个字节 ]); $raw curl_exec($ch); if ($raw false) { curl_close($ch); return false; } $code (int) curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); // 服务器可能不支持范围请求而返回 200照常下载完整内容的响应头也算存在 return in_array($code, [200, 206], true); }需要注意的是如果服务器不理会Range头而返回 200那么这个请求会把整个文件传回来——对一张图片还好对一个几百兆的备份文件就是灾难。所以这个方案要配合CURLOPT_TIMEOUT使用并且在确定对方支持范围请求之前不要用在超大文件上。代码实战一份可运行的完整示例把下面这段保存成remote_check.php直接运行它把三种方式串起来优先 HEADHEAD 被拒时自动降级到范围请求并且区分不存在和查不了两种失败。?php // 需要 PHP 7.4保存后执行php remote_check.php declare(strict_types1); /** * 检查远程文件是否可访问 * 返回 exists | missing | unknown */ function checkRemote(string $url, int $timeout 5, bool $allowFallback true): string { $ch curl_init(); curl_setopt_array($ch, [ CURLOPT_URL $url, CURLOPT_NOBODY true, CURLOPT_RETURNTRANSFER true, CURLOPT_FOLLOWLOCATION true, CURLOPT_MAXREDIRS 3, CURLOPT_CONNECTTIMEOUT $timeout, CURLOPT_TIMEOUT $timeout, ]); $body curl_exec($ch); $errno curl_errno($ch); $code (int) curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); // 网络层失败无法判断文件是否存在这跟不存在是两码事 if ($body false $errno ! 0) { error_log(sprintf(curl errno%d url%s, $errno, $url)); return unknown; } if ($code 200 $code 300) { return exists; } if ($code 404 || $code 410) { return missing; } // 401/403/405文件很可能在只是不允许 HEAD 或不给访问 if ($allowFallback in_array($code, [401, 403, 405], true)) { return checkRemoteByRange($url, $timeout); } return unknown; } function checkRemoteByRange(string $url, int $timeout): string { $ch curl_init(); curl_setopt_array($ch, [ CURLOPT_URL $url, CURLOPT_RETURNTRANSFER true, CURLOPT_HEADER true, CURLOPT_FOLLOWLOCATION true, CURLOPT_MAXREDIRS 3, CURLOPT_CONNECTTIMEOUT $timeout, CURLOPT_TIMEOUT $timeout, CURLOPT_RANGE 0-0, ]); $raw curl_exec($ch); $code (int) curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); if ($raw false) { return unknown; } if (in_array($code, [200, 206], true)) { return exists; } return $code 404 ? missing : unknown; } $urls [ https://www.example.com/index.html, https://www.example.com/definitely-not-here-12345, ]; foreach ($urls as $u) { printf(%-56s - %s\n, $u, checkRemote($u)); }把查不了unknown和不存在missing分开返回是这段代码最重要的设计。线上排查时两者对应的处理完全不同missing 说明资源真的没了可以清理引用unknown 说明是网络或权限问题需要告警而不是当成 404 处理。常见坑点1. 把 file_exists 的 false 当成文件不存在❌if (!file_exists($url)) { unlinkLocalCopy($id); }把远程文件当成本地文件判断结果把好数据全清了✅ 远程地址一律用 HTTP 请求判断状态码file_exists()只用于本地路径和file://地址2. 以为改写 is_file / is_readable 能解决问题❌ 试完file_exists()再试is_file()、is_readable()、filemtime()全都是 false然后怀疑是权限问题✅ 它们同属 stat 家族走的是同一个包装器遇到 HTTP 地址会一起失败换函数没用3. 忘了检查 allow_url_fopen❌ 代码按get_headers()写好了在生产环境返回 false因为allow_url_fopen被关掉了✅ 部署前确认配置如果配置不能改直接走 cURL 方案4. 只认 200 状态码❌return $code 200;于是 206、304 被误判CDN 上的资源全部不存在✅ 用区间判断200 到 299并单独处理 404、410 表示不存在401、403 视业务语义决定5. 用 get_headers 判断却不处理重定向❌$headers[0]拿到的是HTTP/1.1 302 Found于是把存在的文件判成不存在✅ 遍历整个数组找最后一个状态行或者干脆换成带CURLOPT_FOLLOWLOCATION的 cURL6. 没有超时控制❌ 在一个循环里对几百个 URL 调file_exists()或get_headers()遇到不响应的主机整个脚本卡死✅ cURL 必须同时设置CURLOPT_CONNECTTIMEOUT和CURLOPT_TIMEOUT前者管连接阶段后者管整体7. 忽略本地路径下的 stat 缓存❌ 删除或新建文件后立刻用file_exists()判断结果和实际不符✅ PHP 会缓存 stat 结果本地文件操作场景下调用clearstatcache()再判断8. 用 file_exists 判断软链❌ 用file_exists()检查一个断链的符号链接永远是 false于是误以为路径写错了✅file_exists()会跟随软链断链返回 false。要检查链接本身是否存在用is_link()。另外检查目录要用is_dir()file_exists()对目录也返回 true总结疑问答案为什么file_exists()对 HTTP 地址总是 false它走 stat 家族而 HTTP 包装器不支持 stat换个函数有用吗没用is_file()、is_readable()、filesize()同属 stat 家族会不会有报错提示基本没有这也是它难排查的原因用stat()才会看到警告还有什么前提条件allow_url_fopen必须开启HTTP 包装器才会被注册推荐用什么替代cURL 发 HEAD 请求设置超时、跟随重定向按状态码区间判断HEAD 被拒怎么办降级为范围请求取 1 个字节注意服务器可能忽略 Range 返回完整内容一句话记住file_exists()返回 false 的含义是我查不到而不是文件不存在。判断远程资源必须走一次真实的 HTTP 请求并且把网络失败和资源缺失分开处理——把前者当成后者才是这类问题真正会造成损失的场景。