PHP报“File not found”错误的主因是路径解析问题:当前工作目录与预期不符、父目录缺少x权限、写入时父目录不存在,而非文件本身或单纯权限设置问题。
fopen 或 file_get_contents 报 File not found 但文件明明存在这不是权限问题,而是 PHP 进程当前工作目录(getcwd())和你预期的路径不一致。比如你在 Web 根目录下执行脚本,但 PHP CLI 模式下默认在 /root 或 /home/user 启动,./config.php 就会找错地方。
实操建议:
echo getcwd(); 打印当前路径,确认是否符合预期__DIR__ . '/config.php' 替代 './config.php'
$_SERVER['DOCUMENT_ROOT'] 拼接,例如 $_SERVER['DOCUMENT_ROOT'] . '/data/cache.json'
include/require 和 fopen 对路径解析逻辑一致,但错误提示可能不同——前者报 failed to open stream: No such file,后者更常显示 File not found
chmod 改了还是报错常见误区:只改了文件权限,却忽略了父目录的 x(执行)权限。Linux 中,要进入一个目录并读取其下的文件,该目录必须对运行 PHP 的用户(如 www-data 或 nginx)有 x 权限。
检查与修复步骤:
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)sudo -u www-data ls -l /var/www/html/data/config.json 测试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, F
ILE_APPEND | LOCK_EX) 自动建文件——它不会自动建目录mkdir 的第三个参数 true 表示递归创建,否则只建最后一级$year = date('Y'); $path = "/log/$year/app.log";),务必对变量做白名单校验,防止路径遍历CLI 模式、Apache mod_php、PHP-FPM 的工作目录和用户身份完全不同,同一段代码在不同环境可能一个成功、一个报 File not found。
关键差异点:
www-data)运行,getcwd() 是 Apache 配置的 DocumentRoot
www.conf 中的 user/group 定义,getcwd() 默认是 FPM 启动路径(常为 / 或 /var/www)SCRIPT_FILENAME 是 Nginx 传入的,但 getcwd() 仍由 PHP-FPM 进程决定__DIR__ 或 dirname(__FILE__) 构造,避开对 getcwd() 的依赖x 权限缺失、FPM 和 CLI 的工作目录错位、或者 file_put_contents 前忘了 mkdir ——这些细节不打日志根本看不出。