mac下php项目在windows运行失败的核心原因是路径分隔符、扩展加载路径和配置项默认值不一致；需统一用directory_separator拼接路径、修正extension_dir/openssl.cafile/date.timezone等php.ini配置，并确保cli与web环境加载同一php.ini文件。
Mac 下写的 PHP 项目直接扔到 Windows 上跑不起来，核心问题不是语法差异，而是路径分隔符、扩展加载路径、配置项默认值这三块没对齐。改完就能跑，但漏掉任意一个点都会卡在 require 失败、extension_dir 找不到或 open_basedir 拒绝访问上。
路径分隔符：别硬写 /，用 DIRECTORY_SEPARATOR 或 str_replace()
Mac 默认用 /，Windows 认 \（虽然现在也兼容 /，但部分扩展、include_path、realpath() 行为仍敏感）。硬编码 '/path/to/file.php' 在 Windows 下可能被解析成相对路径或触发安全限制。
- 所有拼接路径的地方，统一用
DIRECTORY_SEPARATOR：比如__DIR__ . DIRECTORY_SEPARATOR . 'config' . DIRECTORY_SEPARATOR . 'app.php' - 读取外部配置（如 JSON/YAML）里含路径的字段时，用
str_replace('/', DIRECTORY_SEPARATOR, $path)做一次归一化 - 避免用
basename()/dirname()处理含反斜杠的字符串——它们在 Windows 下行为不稳定，优先用pathinfo()
PHP 配置适配：重点改 extension_dir、openssl.cafile 和 date.timezone
Mac 的 php.ini 里 extension_dir 指向 /usr/lib/php/extensions/no-debug-non-zts-20220829/ 这类路径，Windows 下完全无效；openssl.cafile 如果指向 Mac 的证书路径（如 /etc/ssl/cert.pem），cURL 就会报 SSL certificate problem: unable to get local issuer certificate。
- Windows 下
extension_dir一般设为"C:\php\ext"（具体看你的 PHP 安装路径），确认该目录下有php_openssl.dll等必需文件 -
openssl.cafile改成 Windows 可访问路径，例如"C:\php\cacert.pem"（需提前下载 Mozilla CA 包并放进去） -
date.timezone别留空，Mac 可能靠系统继承，Windows 必须显式设为"Asia/Shanghai"否则date()返回False - 检查
include_path，把 Mac 的:/usr/local/lib/php换成 Windows 下对应路径，或直接删掉，用自动加载代替
扩展加载失败？先看 php -m 和 php --ini 是否指向正确 ini 文件
常见现象是 Windows 下 php -v 显示正常，但 Web 服务里 extension=openssl 不生效——本质是 CLI 和 Web SAPI 加载了不同 php.ini。Apache/Nginx + PHP-FPM 往往用的是 C:\php\php.ini，而命令行可能读 C:\windows\php.ini 或其他位置。
立即学习“PHP免费学习笔记（深入）”；
- 执行
php --ini查 CLI 加载的配置路径；在 PHP 脚本里调用phpinfo()查 Web 环境实际加载的 ini - 确保两个环境都启用了相同扩展，尤其是
php_mbstring.dll、php_curl.dll——Windows 下扩展名是.dll，不是.so - 如果用 XAMPP/WAMP，不要直接改
php.ini，优先通过控制面板界面启用扩展，避免路径写错
最常被忽略的是 realpath() 对混合斜杠的处理和 open_basedir 的路径大小写敏感性：Windows 文件系统不区分大小写，但 PHP 的 open_basedir 校验是字面匹配，C:\project 和 c:\project 被视为不同路径。上线前务必用真实 Windows 环境跑一遍路径相关逻辑，光靠 WSL 模拟不够。
