PHP脚本跨平台失效的主因是路径硬编码而非PHP本身需编译：Windows特有盘符、反斜杠、大小写不敏感等导致file_exists失败或类加载报错，应统一使用DIRECTORY_SEPARATOR和__DIR__构建路径。
PHP脚本本身不用“编译”，但路径硬编码会直接崩
PHP是解释型语言，php script.php 在Windows和Linux下都能跑——前提是里面没写死 C:
mpphtdocs 这种路径。很多同学以为“换系统要重新编译PHP”，其实真正崩的是脚本里那些 file_get_contents('D:/www/data.txt')、__DIR__ . 'config.ini' 或用 realpath() 拼出来的绝对路径。
关键不是PHP二进制，而是你的代码是否依赖Windows特有路径分隔符、驱动器盘符、大小写不敏感文件系统。
- Windows路径分隔符是
，Linux必须用/；混用会导致file_exists()返回false -
__DIR__ . 'config.php'在Linux下变成/var/www/config.php——这个反斜杠会被当字面量，文件根本找不到 - Windows不区分
Config.php和config.php，Linux严格区分，类自动加载容易报Class not found
用 dirname(__FILE__) + str_replace() 不如直接用 __DIR__ 和 DIRECTORY_SEPARATOR
别再手写字符串拼路径。PHP内置常量和函数就是为跨平台准备的：
// ✅ 正确：自动适配 / 或 $confPath = __DIR__ . DIRECTORY_SEPARATOR . 'config' . DIRECTORY_SEPARATOR . 'db.php'; // ✅ 更简洁（PHP 7.4+）：用 ... 展开数组也安全 $pathParts = [__DIR__, 'src', 'Utils', 'Helper.php']; $fullPath = implode(DIRECTORY_SEPARATOR, $pathParts); // ❌ 危险：硬写 或 / 都可能出问题 $bad1 = __DIR__ . 'libclass.php'; // Linux下变成 /var/wwwlibclass.php $bad2 = __DIR__ . '/lib/class.php'; // Windows下虽然能凑合，但不保证所有函数支持（比如某些扩展）
DIRECTORY_SEPARATOR 是PHP根据当前OS自动定义的常量，值为 /（Linux/macOS）或 （Windows），比判断 PHP_OS_FAMILY 更轻量。
立即学习“PHP免费学习笔记（深入）”；
Composer autoload 和 include_path 配置要重检
Windows下用Composer生成的自动加载文件（vendor/autoload.php）本身是跨平台的，但如果你在 composer.json 里写了自定义 autoload 路径，或者改过 include_path ini设置，就容易翻车：
-
"psr-4": {"App\": "D:\project\app\"}→ 必须改成相对路径："App\": "app/" -
set_include_path('C:libs') // PHP Warning: include(): Failed opening→ 改成set_include_path(__DIR__ . DIRECTORY_SEPARATOR . 'libs') - Linux默认不读
php.ini里的include_path（尤其容器环境），建议显式用require_once或 Composer管理依赖
Web服务器路径映射和 $_SERVER['DOCUMENT_ROOT'] 别信
开发时习惯用 $_SERVER['DOCUMENT_ROOT'] . '/assets/js/app.js' 拼资源路径？这在Linux部署时极危险——因为 DOCUMENT_ROOT 值由Web服务器（Apache/Nginx）配置决定，不是PHP能控制的，且Windows开发环境（如XAMPP）和Linux生产环境（如Nginx + /var/www/html）根目录完全不同。
更稳的做法：
- 静态资源走相对URL（
<script src="js/app.js">），由浏览器解析，不经过PHP路径逻辑 - PHP内部需要定位文件时，用
__DIR__向上找，而不是向下依赖DOCUMENT_ROOT - 如果真要动态生成资源URL，用配置项或环境变量注入真实域名+路径前缀，而非拼文件系统路径
最常被忽略的一点：Windows下 getcwd() 可能返回带盘符的路径（C:project），而Linux下永远是 /var/www/project ——任何基于当前工作目录的路径计算，上线前务必实测输出看看。
