PHP高效判断静态文件是否存在技巧

本文深入剖析了在纯 PHP 单入口路由（如 index.php）中高效、安全判断静态文件是否存在的核心实践，直击使用 get_headers() 导致循环请求、超时警告和潜在递归崩溃的常见陷阱；通过将请求 URI 精准映射为服务器本地绝对路径，结合 realpath() 校验与根目录前缀防护规避目录遍历风险，并利用 file_exists() + is_file() 进行毫秒级本地判定，不仅彻底消除网络开销，还支持按扩展名拦截敏感文件、自动设置 MIME 类型并直接输出内容——这一轻量、可靠、生产就绪的方案，让 PHP 路由在兼顾灵活性的同时，真正具备了媲美 Web 服务器原生静态资源处理的安全性与性能。

本文讲解如何在不依赖 .htaccess 的纯 PHP 路由（如 index.php 入口）中，安全、高效地检测请求路径对应的真实文件是否存在，规避 get_headers() 引发的循环 HTTP 请求与超时警告。核心方案是使用 file_exists() 基于服务器本地路径判断，而非发起外部 HTTP 请求。

本文讲解如何在不依赖 `.htaccess` 的纯 PHP 路由（如 `index.php` 入口）中，安全、高效地检测请求路径对应的真实文件是否存在，规避 `get_headers()` 引发的循环 HTTP 请求与超时警告。核心方案是使用 `file_exists()` 基于服务器本地路径判断，而非发起外部 HTTP 请求。

在原生 PHP 单入口路由（如 index.php）中，常需实现“优先服务静态资源，其余请求交由框架/逻辑处理”的策略。但若错误地使用 get_headers($url) 检测文件存在性（例如 http://example.com/js/app.js），会导致 PHP 向自身发起同步 HTTP 请求——这不仅显著拖慢响应（每次检查都经历完整 HTTP 生命周期），更可能因重入触发无限递归（如 index.php 处理 /js/app.js 时又调用 get_headers(.../js/app.js)，再次命中 index.php），最终抛出 failed to open stream: HTTP request failed 警告。

✅ 正确做法：基于文件系统路径进行本地判断，完全绕过网络层。

1. 将 URL 路径映射为服务器绝对路径

关键在于将浏览器请求的 URI（如 /css/style.css）安全转换为 Web 根目录下的真实文件路径：

// index.php
$request_uri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
$document_root = $_SERVER['DOCUMENT_ROOT']; // 或自定义根目录，如 __DIR__
$local_path = $document_root . $request_uri;

// 清理路径，防止目录遍历攻击（重要！）
$local_path = realpath($local_path);
if ($local_path === false || strpos($local_path, $document_root) !== 0) {
    // 路径非法或超出根目录，拒绝访问
    http_response_code(403);
    exit('Forbidden');
}

2. 使用 file_exists() 安全检测

$unauthorized_extensions = ['php', 'env', 'log', 'ini']; // 示例敏感后缀

if (file_exists($local_path) && is_file($local_path)) {
    $ext = strtolower(pathinfo($local_path, PATHINFO_EXTENSION));

    if (in_array($ext, $unauthorized_extensions)) {
        http_response_code(404);
        include '404.php';
        exit();
    }

    // 直接输出静态文件（推荐用 readfile + 正确 header）
    $mime_type = get_mime_type($ext) ?: 'application/octet-stream';
    header('Content-Type: ' . $mime_type);
    header('Content-Length: ' . filesize($local_path));
    readfile($local_path);
    exit();
}

// 若文件不存在，则继续执行后续路由逻辑（如 MVC 分发）
// ... your router logic here

? 补充：get_mime_type() 可简单实现：

function get_mime_type($ext) {
    $types = [
        'css' => 'text/css',
        'js'  => 'application/javascript',
        'png' => 'image/png',
        'jpg' => 'image/jpeg',
        'svg' => 'image/svg+xml',
        'woff2' => 'font/woff2'
    ];
    return $types[$ext] ?? null;
}

⚠️ 注意事项

• 绝不使用 get_headers() 检查同站资源：这是性能杀手与递归根源；
• 始终校验路径合法性：realpath() + 前缀检查防止 ../ 目录穿越；
• 区分 is_file() 和 is_dir()：确保目标是文件而非目录；
• 静态资源建议直接 readfile()：比 header("Location: ...") 重定向更高效（减少一次 HTTP 跳转）；
• 生产环境应交由 Web 服务器处理静态资源：Nginx/Apache 原生支持，PHP 路由仅负责动态逻辑。

通过本地文件系统判断，你获得了毫秒级响应、零网络开销与绝对可控的安全边界——这才是单入口 PHP 路由中处理静态资源的正确范式。

今天关于《PHP高效判断静态文件是否存在技巧》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！