php线上部署难点在于跨平台细节：路径分隔符需统一用/，文件名大小写须严格匹配；nginx+php-fpm与windows的apache+mod_php处理机制不同；扩展、时区、环境变量、权限等均需逐项验证。
PHP 线上部署本身不难，难在跨 Windows 和 Linux 时那些看似微小、实则导致 500、file not found、include_path 失效或定时任务静默失败的细节。Windows 开发环境跑通 ≠ Linux 上能用。
路径分隔符和大小写敏感性必须显式处理
Linux 文件系统严格区分大小写，require 'Config.php' 和 require 'config.php' 是两个文件；Windows 下全都能加载。更隐蔽的是路径拼接：__DIR__ . '\config\app.php' 在 Linux 下会变成 /var/www/app\config\app.php（反斜杠被当普通字符），导致 require 失败。
- 统一用
/作为路径分隔符，PHP 内部会自动适配（__DIR__ . '/config/app.php'） - 避免硬编码
\或DIRECTORY_SEPARATOR—— 它在 Windows 是\，但多数现代 Web 服务器（Nginx/Apache）只认/作 URI 分隔符，混用易出错 - 检查所有
include/require/file_get_contents路径，确保目标文件名与实际大小写完全一致
Web 服务器配置差异直接决定是否“启动成功”
Windows 常用 XAMPP/WAMP，自带 Apache + PHP 模块；线上 Linux 多用 Nginx + PHP-FPM，两者处理 PHP 请求的方式完全不同：Apache 用 mod_php，每个请求都加载一次 PHP 解释器；Nginx 是反向代理，靠 fastcgi_pass 把请求转给独立的 PHP-FPM 进程池。
- 别直接复制
.htaccess到 Nginx —— 它不识别，得重写为location块（比如伪静态规则） - 确认
php-fpm.conf中user/group与 Web 目录权限匹配（常见坑：www-data用户无权读取/var/www/app/storage） - Linux 上禁用
display_errors = On，否则可能暴露路径；改用error_log = /var/log/php/error.log并确保该文件可写
扩展、函数和时区行为不一致要提前验证
Windows 下默认启用 php_opcache 但配置项名可能是 zend_extension=php_opcache.dll；Linux 是 .so 后缀，且路径不同。有些函数行为也不同：exec('ping -c 1 google.com') 在 Windows 会卡住（因参数是 -n 1），date_default_timezone_set('Asia/Shanghai') 在某些旧版 Linux 的 tzdata 包里没有 Asia/Shanghai 别名，得用 PRC。
立即学习“PHP免费学习笔记（深入）”；
- 上线前运行
php -m对比扩展列表，重点核对mbstring、curl、openssl、pdo_mysql - 用
php -r "echo date_default_timezone_get();"验证时区是否生效，再查php -r "print_r(timezone_identifiers_list());"确认支持的时区名 - 避免依赖
shell_exec执行平台特有命令（如dir/ls），改用 PHP 原生函数scandir()、is_dir()
环境变量和配置加载顺序容易被忽略
Windows 开发常把配置写进 .env 或全局 $_SERVER；Linux 生产环境通常通过 Web 服务器传入（Nginx 的 fastcgi_param，Apache 的 SetEnv），或由 systemd service 文件定义。如果代码里用 getenv('APP_ENV') 却没在 PHP-FPM pool 配置中声明，就会返回 false。
- 在
www.conf（PHP-FPM pool 配置）中显式加：env[APP_ENV] = production - 不要依赖
$_ENV—— 默认关闭，需设variables_order = "EGPCS"并确保env在首位 - 数据库密码等敏感信息别硬编码，用
putenv()或配置管理工具（如 Vault）注入，而非靠.env文件（Git 忘记忽略就完了）
最麻烦的不是某处报错，而是某处“没报错却没生效”——比如日志写不进目录、队列任务卡在 waiting、缓存键在 Linux 下生成空字符串。上线前务必在 Linux 环境完整走一遍请求链路，别只测首页。
