PHP报“File not found”错误的主因是路径解析问题:当前工作目录与预期不符、父目录缺少x权限、写入时父目录不存在,而非文件本身或单纯权限设置问题。

PHP fopen 或 file_get_contents 报 File not found 但文件明明存在
这不是权限问题,而是 PHP 进程当前工作目录(getcwd())和你预期的路径不一致。比如你在 Web 根目录下执行脚本,但 PHP CLI 模式下默认在 /root 或 /home/user 启动,./config.php 就会找错地方。
实操建议:
- 用
echo getcwd();打印当前路径,确认是否符合预期 - 避免相对路径,改用绝对路径:用
__DIR__ . '/config.php'替代'./config.php' - 如果读取的是 Web 可访问资源,优先用
$_SERVER['DOCUMENT_ROOT']拼接,例如$_SERVER['DOCUMENT_ROOT'] . '/data/cache.json' - 注意
include/require和fopen对路径解析逻辑一致,但错误提示可能不同——前者报failed to open stream: No such file,后者更常显示File not found
Linux 下 PHP 无法读取文件,chmod 改了还是报错
常见误区:只改了文件权限,却忽略了父目录的 x(执行)权限。Linux 中,要进入一个目录并读取其下的文件,该目录必须对运行 PHP 的用户(如 www-data 或 nginx)有 x 权限。
检查与修复步骤:
立即学习“PHP免费学习笔记(深入)”;
- 运行
ls -ld /var/www/html/data,看目录权限末三位是否含x(如drwxr-xr-x可,drw-r--r--不可) - 补全目录执行权限:
chmod +x /var/www/html/data(或更精确地:chmod 755 /var/www/html/data) - 确认 PHP 进程用户能访问整条路径:用
sudo -u www-data ls -l /var/www/html/data/config.json测试 - SELinux 启用时(如 CentOS),
chmod无效,需用chcon -t httpd_sys_rw_content_t /path/to/file
file_put_contents 写入失败,错误提示却是 File not found
这个错误往往发生在目标路径的**父目录不存在**,而非文件本身。例如写入 /var/log/app/debug.log,但 /var/log/app/ 目录还没创建。
安全写入建议:
- 写入前先确保目录存在:
if (!is_dir(dirname($path))) { mkdir(dirname($path), 0755, true); } - 不要依赖
file_put_contents($path, $data, FILE_APPEND | LOCK_EX)自动建文件——它不会自动建目录 - 注意
mkdir的第三个参数true表示递归创建,否则只建最后一级 - 如果路径含变量(如
$year = date('Y'); $path = "/log/$year/app.log";),务必对变量做白名单校验,防止路径遍历
Apache/Nginx + PHP-FPM 环境下路径行为不一致
CLI 模式、Apache mod_php、PHP-FPM 的工作目录和用户身份完全不同,同一段代码在不同环境可能一个成功、一个报 File not found。
关键差异点:
- Apache mod_php:通常以 Apache 用户(如
www-data)运行,getcwd()是 Apache 配置的DocumentRoot - PHP-FPM:worker 进程由
www.conf中的user/group定义,getcwd()默认是 FPM 启动路径(常为/或/var/www) - Nginx + PHP-FPM 组合中,Nginx 不控制 PHP 工作目录,
SCRIPT_FILENAME是 Nginx 传入的,但getcwd()仍由 PHP-FPM 进程决定 - 最稳妥方式:所有路径都基于
__DIR__或dirname(__FILE__)构造,避开对getcwd()的依赖
x 权限缺失、FPM 和 CLI 的工作目录错位、或者 file_put_contents 前忘了 mkdir ——这些细节不打日志根本看不出。











