require() 找不到文件的三个常见原因是路径错误、open_basedir 限制和文件权限问题；需依次检查日志路径是否存在、是否可读，以及 open_basedir 是否放行该位置，同时注意 linux 下 php 进程用户对文件及目录的 r/x 权限。
require() 找不到文件的三个常见原因
报 Fatal error: require(): Failed opening required，不是“PHP坏了”，而是它明确告诉你：它按规则去找文件，但没找到。核心就三点：路径写错了、权限拦住了、open_basedir 切断了访问。
常见错误现象包括：
- 本地能跑，线上 500；
- 命令行执行正常，Web 请求失败；
- 报错里路径看着对（比如
/home/wwwroot/app/public/../core/init.php），但就是打不开。
排查顺序建议：先看日志里完整路径，再确认该路径下文件是否存在、是否可读，最后检查 open_basedir 是否放行了这个位置。
相对路径在不同上下文中会解析错
require '../config.php' 这类写法依赖当前工作目录（cwd）和脚本所在目录，而 Web 和 CLI 的 cwd 往往不同。PHP 解析时依次查：当前脚本目录 → include_path → 当前工作目录，任意一环出偏差就挂。
实操建议：
- 用
__DIR__拼接绝对路径：require __DIR__ . '/../config.php';，避免 cwd 干扰； - ThinkPHP/Laravel 等框架入口
index.php通常已设好chdir(__DIR__)，但自定义脚本别默认它存在； - 不要依赖
include_path去“简化路径”，它容易被环境覆盖，且无法解决跨目录限制问题。
open_basedir 拦截导致 Operation not permitted
当报错同时带 open_basedir restriction in effect，说明 PHP 被安全策略锁死了路径范围。典型如 ThinkPHP5 部署时，public/index.php 要加载上层 thinkphp/start.php，但 open_basedir 只给了 /public/ 目录，上级自然拒绝访问。
关键点：
- Nginx 中的
fastcgi_param PHP_ADMIN_VALUE "open_basedir=..."优先级高于 php.ini； - 不能只写
$document_root/，得包含其父级（如$document_root/../或直接写项目根目录）； - 多个路径用英文冒号分隔，末尾加
/tmp/:/proc/是常规操作，别漏掉； - 改完必须重启 PHP-FPM 或整个 LNMP，仅 reload Nginx 不生效。
文件权限或 SELinux 导致的“找不到”
Linux 下即使路径全对、open_basedir 放行，仍可能因权限失败。报错里出现 Permission denied 或中文“权限不”（如“鏉冮檺涓嶅”），基本锁定是这个问题。
注意细节：
- PHP 进程用户（如
www-data或nobody）必须对目标文件有r权限，对所在目录有x权限（否则无法进入）； -
chmod 644通常够用，666不推荐——它只是绕过检查，没解决根本权限归属； - SELinux 启用时，
ls -Z查看上下文，用chcon -t httpd_sys_content_t重标文件类型； - 容器环境要确认挂载卷权限是否透传，宿主机
chown -R www-data:www-data /app很关键。
最易被忽略的是：open_basedir 的路径必须以 / 结尾，且大小写敏感；Windows 下反斜杠不被识别，一律用正斜杠；Nginx 的 $document_root 变量值可能含符号链接，realpath() 检查实际路径更可靠。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
