从windows迁移到linux部署php接口需系统性应对底层差异：统一路径分隔符、标准化换行符、严格校验文件名大小写、适配linux权限模型、对齐php版本与扩展、隔离.env配置、补全nginx重写规则及cgi参数，避免隐性故障。
从 Windows 迁移到 Linux 部署 PHP 接口时，配置改动不是“改几个参数”那么简单，而是要系统性应对操作系统底层差异。重点不在“能不能跑”，而在“会不会悄悄出错”——比如接口返回空、文件上传失败、日志写不进、定时任务漏执行等隐性问题。
PHP 扩展与版本必须严格对齐
Windows 开发常用 PHPStudy 或 XAMPP，Linux 生产环境多用 apt/yum 安装。版本小数点不一致（如 8.2.1 vs 8.2.5）或缺一个扩展，就可能让 json_encode() 返回 false、file_get_contents() 报错，甚至 Laravel 的 php artisan migrate 直接中断。
- 确认必需扩展已启用：mbstring、openssl、pdo、xml、ctype、json、zip；推荐补上 bcmath 和 sodium（尤其涉及金额或加密）
- Linux 上不要只装
php-fpm，要明确指定版本，例如：sudo apt install php8.2-mbstring php8.2-xml php8.2-zip - 运行
php -m和php --ini对比两边启用的扩展和配置路径，避免 .ini 文件被忽略
.env 和环境变量要隔离且注入安全
本地 .env 写着 DB_HOST=127.0.0.1，线上却连内网 RDS 地址；APP_URL=http://localhost 导致生成的 JWT 签名 URL 错误——这类配置混用是接口 401/500 的常见源头。
- Git 中彻底移除已提交的
.env：git rm --cached .env && echo ".env" >> .gitignore - 服务器部署后，用
cp .env.example .env && php artisan key:generate初始化，再通过 Ansible 变量、宝塔环境变量或 systemd service 文件注入真实配置 - 避免在代码里硬编码
$_SERVER['HTTP_HOST']构造 API 域名，统一走config('app.url')或环境变量
Nginx 路由与 CGI 参数不能少半句
Apache 在 Windows 下自带 PATH_INFO 支持，Nginx 在 Linux 上必须手动补全规则，否则 POST 接口收不到 body、带 query 的路由 404、$_FILES 为空——这些都不是代码问题，是配置缺口。
-
root必须指向/path/to/laravel/public，不是项目根目录 -
location /块里必须有：try_files $uri $uri/ /index.php?$query_string;（注意$query_string，丢掉它，所有 GET 参数失效） -
location ~ .php$中必须包含：fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;，否则$_SERVER['SCRIPT_FILENAME']指向错误，Laravel 自动加载失败
路径、大小写、权限三处必须提前校验
Windows 不区分 Helpers/MyClass.php 和 helpers/myclass.php，Linux 会直接报 Class not found；Windows 默认允许脚本写日志，Linux 下没 chmod 就 Permission denied——这些不会在首页报错，但一调接口就崩。
- 所有
include、require、命名空间引用，确保大小写 100% 匹配物理文件名（建议开发阶段就在 WSL 或 Docker 中调试） - 路径拼接一律用
DIRECTORY_SEPARATOR，不用"\"或"/"硬编码 - 部署后立即设权：
chmod -R 755 bootstrap/cache storage，chown -R www-data:www-data storage bootstrap/cache
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
