Linux下include路径出错的根本原因是文件系统大小写敏感且路径解析规则更严格：包括文件名大小写不一致、依赖不稳定的getcwd()、符号链接与open_basedir冲突、中文路径及空格导致底层调用失败。
Linux下include路径出错，根本原因是大小写敏感 + 路径解析规则更严格
Windows上能跑通的 include 'config.php'，一上Linux就报 failed to open stream: No such file or directory，不是PHP版本问题，也不是配置漏改——大概率是文件名大小写不一致，或误用了当前工作目录（getcwd()）当基准。
Linux文件系统默认区分大小写，而PHP在Linux下完全继承这一行为。比如你写了 include 'Config.php';，但实际文件叫 config.php，PHP直接失败，连警告都不会多给一句“是不是大小写错了”。Windows会自动忽略大小写匹配，掩盖了这个问题，直到上线才爆发。
- 用
ls -l确认目标文件真实名称，特别注意首字母大小写、下划线/短横是否混用 - 避免依赖
getcwd()拼路径：Web请求中它常等于脚本所在目录，但CLI执行时可能指向用户家目录，导致同一行include '../lib/utils.php'在命令行里直接炸掉 - 别信编辑器显示的文件名——有些FTP工具或IDE在传输时悄悄重命名（如把
HEADER.PHP改成header.php），用ls -la看原始结果
相对路径的“当前目录”在Linux下更不可靠
PHP的 include 'foo.php' 默认按 __DIR__ 查找，但只要路径里出现 ./ 或 ../，它就立刻切换成基于 getcwd() 解析——而这个值在Linux下极不稳定。
比如你在 /var/www/html/admin/index.php 里写 include '../config/db.php'，如果通过Web访问，getcwd() 通常是 /var/www/html/admin，路径能对上；但若用CLI跑 php /var/www/html/admin/index.php，getcwd() 很可能是 /home/deploy，../config/db.php 就变成去 /home/config/db.php 找，必然失败。
立即学习“PHP免费学习笔记（深入）”；
- 永远优先用
__DIR__拼接：include __DIR__ . '/../config/db.php'; - 禁用任何含
./的写法——它看似明确，实则触发getcwd()解析，等于埋雷 - 用
realpath(__DIR__ . '/../config/db.php')验证路径是否真存在，返回false就说明中间某级目录不存在或权限不足
符号链接 + open_basedir 是Linux上线后才暴露的组合拳
开发时一切正常，部署到Nginx+PHP-FPM后突然include全挂？常见于用符号链接做发布（如 /var/www/current → /var/www/releases/20260831）。PHP在解析 ../ 时，默认跟随符号链接展开，但 open_basedir 限制的是**真实物理路径**，不是链接路径。
例如 open_basedir = /var/www/current:/tmp，但 /var/www/current 指向 /var/www/releases/20260831，这时 include '../shared/config.php' 实际要去 /var/www/releases/shared/config.php，不在 open_basedir 白名单里，直接被拦住，错误信息却只显示“no such file”，不提权限限制。
- 检查
open_basedir实际值：echo ini_get('open_basedir');，注意它可能被PHP-FPM池配置（php_admin_value[open_basedir]）强制覆盖 - 用
readlink -f /var/www/current确认符号链接真实指向，再把对应物理路径加进open_basedir - 避免在符号链接目录内用
../向上跳——改用__DIR__定位后硬编码跳转层级，或统一用dirname(__DIR__) . '/shared/config.php'
中文路径和空格在Linux下基本等于自毁
Linux文件系统本身支持UTF-8中文名，但PHP的 include 在底层调用 open() 系统调用时，若路径含中文或空格，极易因编码转换失败或shell参数截断导致静默失败。你看到的错误还是“no such file”，但真实原因是路径传入时已损坏。
比如 include '公共库/utils.php';，在某些终端环境或FTP上传后，文件名可能变成乱码或被截断为 公共，PHP自然找不到。
- 开发阶段就禁用中文路径和空格——不是“能不能”，而是“何必冒这个险”
- 已有中文路径？用
mv命令重命名为纯ASCII，如gonggongku，并全局替换代码中所有引用 - 用
find /var/www -name "*[[:space:]]*"和find /var/www -name "*[^[:ascii:]]*"快速扫出隐患文件
include 调用前，都得清楚知道 __DIR__ 是哪、getcwd() 是哪、open_basedir 卡在哪——少查一个，就多一个线上告警。 
