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。
立即学习“PHP免费学习笔记（深入）”；
- 启用
opcache.validate_timestamps=1+opcache.revalidate_path=1，让 OPcache 不缓存错误的大小写映射 - 静态扫描：用
php -l无法发现这类问题，需配合phpstan或自定义脚本比对use语句与实际文件名（如grep -r 'class.*MyClass' src/ | grep -i 'myclass'辅助排查） - 开发环境强制用 Linux 容器（Docker）运行，从源头规避“本地能跑线上挂了”的陷阱
确认扩展加载逻辑不依赖平台特定路径或条件
常见坑是 extension_dir 硬编码，或在 php.ini 里写 extension=php_curl.dll（Windows）却忘了 Linux 是 curl.so；还有通过 PHP_OS 判断后动态 dl() 扩展，但 dl() 在大多数 SAPI（如 FPM）中已被禁用。
- 扩展名应省略后缀：
extension=curl（PHP 自动补.so或.dll） - 避免在代码中用
if (PHP_OS === 'WINNT') { dl('xxx.dll'); }，改用配置文件分离或 Composer 的platform机制 - 用
extension_loaded('mbstring')替代function_exists('mb_strlen')判断扩展可用性，更准确
真正难检测的不是语法兼容，而是那些“只在特定 OS + 特定 PHP SAPI + 特定扩展组合下才触发”的隐式依赖，比如 pcntl_fork() 在 Windows 不可用、posix_getpwuid() 在 Windows 无意义。这类问题没法靠静态扫描覆盖，只能靠目标环境的最小化 CI 测试兜底。
