PHP跨平台兼容性检测需关注换行符、路径分隔符、大小写敏感性和扩展加载四类问题：统一用LF换行、DIRECTORY_SEPARATOR或/拼接路径、确保类名与文件名大小写一致、扩展名省略后缀并用extension_loaded()检测，CI中需目标环境测试兜底。
PHP 本身不直接提供“跨平台文件兼容性检测”功能，所谓“文件是否跨平台兼容”，实际是指该 PHP 文件在不同操作系统（Windows / Linux / macOS）上能否被正确解析、执行，核心矛盾集中在 line endings、path separators、case sensitivity 和 extension loading 四类问题上。
检查换行符是否为 LF（Linux/macOS 友好）
Windows 默认用 CRLF（\r\n），而 Unix-like 系统只认 LF（\n）。虽然现代 PHP 解析器大多能容忍 CRLF，但某些场景（如 CLI 脚本首行 #!/usr/bin/env php 后紧跟 \r）会直接报 Invalid argument 或静默失败。
- 用
file($path, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES)读取后检查末尾是否有\r - 更可靠：用
file_get_contents($path)+ 正则/[\r\u2028\u2029]/u检测非法行尾或 Unicode 分隔符 - CI/CD 中可加 shell 检查：
git grep -I $'\r$' -- '*.php'（需 Git 配置core.autocrlf=input）
验证路径分隔符是否统一用 DIRECTORY_SEPARATOR
硬编码 '\\' 或 '/' 在跨平台时极易出错——比如 file_exists('logs\\error.log') 在 Linux 下永远返回 false；而 include 'lib/utils.php' 在 Windows 下可能因大小写忽略侥幸通过，但在 Linux 上失败。
- 所有拼接路径必须用
dirname(__FILE__) . DIRECTORY_SEPARATOR . 'config.php'或更推荐__DIR__ . '/config.php'（/在 PHP 中跨平台安全，底层自动转换） - 避免
realpath()前手动替换斜杠，它本身已处理分隔符归一化 - 用
is_file()/is_dir()替代字符串判断路径存在性，它们对分隔符不敏感
检测大小写敏感的类名/文件名引用
Linux/macOS 文件系统默认大小写敏感，Windows（NTFS 默认）不敏感。若代码中写 new MySQLi(); 却文件名为 mysqli.php，在 Windows 可运行，部署到 Linux 就抛 Class 'MySQLi' not found。
