news 2026/4/17 16:50:36

PHP-FPM返回的File not found.”的本质

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
PHP-FPM返回的File not found.”的本质

你已经修正了SCRIPT_FILENAME的参数,但仍然显示“File not found.”,这说明问题不仅是配置参数的问题,还涉及PHP文件的路径匹配、权限、PHP-FPM的访问权限或Nginx的root指令作用域等问题。我会逐一分析并给出可落地的排查和修复步骤。

一、先明确“File not found.”的本质

这个错误是PHP-FPM返回的,而非Nginx直接返回。意味着Nginx已经把请求转发给了PHP-FPM,但PHP-FPM在$document_root$fastcgi_script_name对应的路径下,找不到对应的PHP文件,或者没有权限访问该文件。

二、分步排查与修复(按优先级排序)

步骤1:给PHP解析块添加root指令(关键遗漏项)

你的location ~ \.php$块中缺少root /app/code/zbx;指令,这会导致$document_root在PHP解析块中可能无法正确获取到项目根目录(Nginx的root指令有作用域,不同location块需要显式声明)。

修改这部分配置

location ~ \.php$ { root /app/code/zbx; # 必须添加!和location /中的root保持一致 try_files $uri =404; # 新增:先检查文件是否存在,不存在直接返回404,避免无效请求 fastcgi_pass 127.0.0.1:9000; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; }
  • try_files $uri =404:这一步能提前过滤掉不存在的PHP文件请求,避免PHP-FPM返回错误,同时也能防止某些安全漏洞。
步骤2:验证PHP文件的实际路径是否存在

执行以下命令,确认你访问的PHP文件(比如index.php)确实在/app/code/zbx目录下:

# 检查根目录下的index.php是否存在ls-l /app/code/zbx/index.php# 如果你访问的是其他PHP文件(比如test.php),替换为对应文件名ls-l /app/code/zbx/test.php
  • 如果输出“No such file or directory”,说明文件不存在,需要将PHP文件放到该目录下。
步骤3:检查PHP-FPM用户是否有权限访问文件

PHP-FPM默认以apachenginx(部分系统是php-fpmwww-data)用户运行,该用户需要有读取PHP文件和遍历目录的权限

  1. 查看PHP-FPM的运行用户

    # 编辑PHP-FPM的配置文件(不同版本路径可能不同,比如php74-php-fpm的配置在/etc/opt/remi/php74/php-fpm.d/www.conf)cat/etc/php-fpm.d/www.conf|grep-E'user|group'

    输出示例(通常是user = apachegroup = apache):

    user = apache group = apache
  2. 修改文件和目录的权限

    # 给目录添加遍历权限(755),给文件添加读取权限(644)chmod-R755/app/code/zbxchmod-R644/app/code/zbx/*.php# 将目录和文件的所有者改为PHP-FPM的运行用户(比如apache,根据上面的输出调整)chown-R apache:apache /app/code/zbx
    • 如果你不确定PHP-FPM的用户,也可以临时设置文件的其他用户可读:chmod -R o+r /app/code/zbx(测试用,生产环境建议严格控制权限)。
步骤4:检查SELinux是否阻止了访问(CentOS/RHEL系统常见)

SELinux的强制模式会阻止PHP-FPM访问非默认目录的文件,这是很多人容易忽略的点。

  1. 临时关闭SELinux测试

    setenforce0

    然后重新访问PHP文件,如果能正常显示,说明是SELinux的问题。

  2. 永久解决SELinux问题(推荐,而非一直关闭):

    # 给目录添加SELinux上下文,允许Web服务访问chcon -R -t httpd_sys_content_t /app/code/zbx# 若需要PHP写入文件(比如上传目录),再添加可写上下文chcon -R -t httpd_sys_rw_content_t /app/code/zbx
步骤5:查看Nginx和PHP-FPM的日志,定位具体错误

如果以上步骤都没解决,查看日志能直接找到问题:

# 查看Nginx的错误日志tail-f /var/log/nginx/error.log# 查看PHP-FPM的错误日志(路径可能不同,比如/var/log/php-fpm/error.log、/var/log/opt/remi/php74/php-fpm/error.log)tail-f /var/log/php-fpm/error.log
  • 日志中如果出现“Permission denied”,说明是权限问题;如果出现“No such file or directory”,说明路径问题。

三、修复后的完整配置(汇总所有修正项)

server { listen 80; server_name localhost www.zbx888.com; location / { root /app/code/zbx; index index.php index.htm; # 把index.php放前面,优先解析 try_files $uri $uri/ /index.php$is_args$args; # 处理PHP项目路由 } error_page 500 502 503 504 /50x.html; location = /50x.html { root /usr/share/nginx/html; } location ~ \.php$ { root /app/code/zbx; # 显式声明根目录 try_files $uri =404; # 提前检查文件是否存在 fastcgi_pass 127.0.0.1:9000; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } # 禁止访问隐藏文件,提升安全性 location ~ /\.ht { deny all; } }

修改后记得执行nginx -t检查语法,再执行systemctl restart nginx重启Nginx。

总结

  1. 核心遗漏问题是PHP解析块缺少root指令,导致$document_root无法正确指向项目目录。
  2. 其次需要验证文件存在性、PHP-FPM用户权限、SELinux限制这三个常见触发“File not found.”的因素。
  3. 日志是定位剩余问题的关键,若仍有报错,可通过Nginx和PHP-FPM的错误日志进一步分析。
版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/4/17 20:17:45

安全测试必学神器 --BurpSuite 安装及使用实操

BurpSuite是一款功能强大的集成化安全测试工具,专门用于攻击和测试Web应用程序的安全性。适合安全测试、渗透测试和开发人员使用。本篇文章基于BurpSuite安装及常用实操做详解,如果你是一名安全测试初学者,会大有收获! 一、BurpS…

作者头像 李华
网站建设 2026/4/18 7:53:29

Milkdown插件化Markdown编辑器:5步打造你的专属写作环境

Milkdown插件化Markdown编辑器:5步打造你的专属写作环境 【免费下载链接】milkdown 项目地址: https://gitcode.com/gh_mirrors/mil/milkdown 还在为找不到理想的Markdown编辑器而烦恼吗?Milkdown或许正是你期待已久的解决方案。这个基于Prosemi…

作者头像 李华
网站建设 2026/4/18 7:53:29

如何快速掌握Saladict:桌面划词翻译的完整指南

Saladict是一款功能强大的桌面划词与翻译工具,支持Windows、Mac和Linux操作系统。这款工具聚合了众多词典资源,能够为用户提供快速准确的翻译服务,特别适合需要频繁查阅外文资料的学习和工作场景。 【免费下载链接】saladict-desktop ✨✨桌面…

作者头像 李华
网站建设 2026/4/18 7:57:20

计算机毕业设计springboot基于vue的健身房信息管理系统 基于Spring Boot与Vue.js的健身房信息化管理平台设计与实现 Vue.js前端与Spring Boot后端集成的健身房管理

计算机毕业设计springboot基于vue的健身房信息管理系统2m9669 (配套有源码 程序 mysql数据库 论文) 本套源码可以在文本联xi,先看具体系统功能演示视频领取,可分享源码参考。随着信息技术的飞速发展,传统健身房的管理模式已经难以…

作者头像 李华
网站建设 2026/4/17 21:08:39

如何快速优化Mac USB性能:USBMap终极配置指南

如何快速优化Mac USB性能:USBMap终极配置指南 【免费下载链接】USBMap Python script for mapping USB ports in macOS and creating a custom injector kext. 项目地址: https://gitcode.com/gh_mirrors/us/USBMap USBMap是一款专为Mac系统设计的强大工具&a…

作者头像 李华