如何在 Nginx 中正确访问 .phar.php 文件

偷偷努力，悄无声息地变强，然后惊艳所有人！哈哈，小伙伴们又来学习啦~今天我将给大家介绍《如何在 Nginx 中正确访问 .phar.php 文件 》，这篇文章主要会讲到等等知识点，不知道大家对其都有多少了解，下面我们就一起来看一吧！当然，非常希望大家能多多评论，给出合理的建议，我们一起学习，一起进步！

Nginx 默认 PHP 处理规则无法匹配双扩展名（如 Contao-Manager.phar.php），需调整 fastcgi_split_path_info 正则及 location 优先级，确保 .phar.php 被识别为可执行 PHP 脚本。

Nginx 默认 PHP 处理规则无法匹配双扩展名（如 `Contao-Manager.phar.php`），需调整 `fastcgi_split_path_info` 正则及 location 优先级，确保 `.phar.php` 被识别为可执行 PHP 脚本。

在使用 DDEV（尤其是 macOS Apple Silicon 环境）部署 Contao 等依赖 PHAR 的 PHP 应用时，直接通过浏览器访问 Contao-Manager.phar.php 返回 404，通常并非路径错误，而是 Nginx 的 PHP 匹配逻辑未覆盖 .phar.php 这类复合扩展名。根本原因在于：Nginx 的 location ~ \.php$ 规则虽能匹配以 .php 结尾的 URI，但后续 fastcgi_split_path_info 的正则表达式默认仅适配单段扩展（如 script.php），而 Contao-Manager.phar.php 实际包含两个点号，原始正则 ^(.+?\.php)(/.*)$ 会错误截断路径，导致 $fastcgi_script_name 解析失败，最终 try_files $uri =404 直接返回 404。

✅ 正确解决方案是增强 PHP location 的匹配鲁棒性，并确保 .phar.php 被优先交由 PHP-FPM 处理。推荐修改 location ~ \.php$ 块如下：

location ~ \.php$ {
    # 关键：支持 .phar.php、.foo.php 等多点扩展名
    fastcgi_split_path_info ^(.+\.php)(/.+)$;

    # 先尝试精确匹配脚本文件（含 .phar.php），再 fallback 到 404
    try_files $fastcgi_script_name =404;

    fastcgi_pass unix:/run/php-fpm.sock;
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_param SCRIPT_NAME $fastcgi_script_name;
    fastcgi_param PATH_INFO $fastcgi_path_info;
    include fastcgi_params;

    fastcgi_intercept_errors off;
    fastcgi_read_timeout 10m;
    fastcgi_buffers 16 16k;
    fastcgi_buffer_size 32k;
}

⚠️ 注意事项：

• fastcgi_split_path_info 的正则 ^(.+\.php)(/.+)$ 中 .+\.php 使用贪婪匹配，能正确捕获 Contao-Manager.phar.php 整体作为脚本名（$1），而 /.* 部分（如 ?/install）进入 $2 作为 PATH_INFO；
• 必须移除原配置中 location / 内的 try_files $uri $uri/ /index.php?$query_string 对 .php 文件的兜底处理，否则请求会先被 location / 拦截并重写为 /index.php，绕过 PHP location，导致 .phar.php 永远无法抵达 PHP-FPM；
• 若仍 404，请立即检查 Nginx 日志：tail -f /var/log/nginx/access.log 和 /var/log/nginx/error.log，确认是否出现 *no such file or directory 或 FastCGI sent in stderr: "Primary script unknown" —— 这表明 $fastcgi_script_name 解析为空或路径错误；
• 补充安全建议：.phar.php 文件应置于 Web 可访问目录内，但建议通过 location ~ \.phar\.php$ { allow all; } 显式放行，并避免将其与敏感配置文件共存。

总结：解决 .phar.php 404 的核心是让 Nginx 正确识别其为 PHP 脚本而非静态资源。这依赖于精准的正则匹配与 location 优先级控制。修改后 reload Nginx（ddev restart）即可生效。

理论要掌握，实操不能落！以上关于《如何在 Nginx 中正确访问 .phar.php 文件 》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！