laravel项目从windows本地迁移到linux服务器需统一php版本与扩展、分环境管理.env、对齐nginx重写规则、处理大小写敏感及权限。linux用apt安装php8.2-mbstring等扩展，windows用phpstudy/xampp；.env不提交，用.env.example生成并注入配置；nginx必须配置try_files和script_filename，storage与bootstrap/cache需chown www-data并chmod 755。

把 Laravel 项目从 Windows 本地开发环境迁移到 Linux 生产服务器，不是简单复制粘贴就能跑通的事。核心在于处理好环境差异、路径逻辑、权限规则和配置隔离——这些地方出错，轻则 404/500，重则数据泄露或功能失效。

PHP 版本与扩展必须对齐

Windows 和 Linux 上的 PHP 看似一样，但版本小数点差一位、扩展少一个，Laravel 就可能直接报错退出。Laravel 11 要求 PHP ≥ 8.2，且以下扩展不能缺：

• 必需：mbstring、openssl、pdo、tokenizer、xml、ctype、json、zip
• 推荐：bcmath（数字精度）、redis（缓存）、sodium（加密）

Windows 推荐用 PHPStudy 或 XAMPP 8.2+；Linux 上用 apt 安装时别只敲 php-fpm，要明确指定版本，例如：
sudo apt install php8.2-cli php8.2-mbstring php8.2-xml php8.2-zip php8.2-bcmath

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

.env 配置必须分环境管理

数据库地址、APP_URL、密钥这些值在本地和线上天然不同，但绝不能靠手动改来改去。关键做法是：

• 本地 Windows 保留 .env，内容如 DB_HOST=127.0.0.1、APP_URL=http://localhost:8000
• Linux 服务器部署后运行 cp .env.example .env && php artisan key:generate，再用脚本或 Ansible 注入生产配置
• 绝对不提交 .env 到 Git —— 已提交的要用 git rm --cached .env 移除，并加进 .gitignore

Nginx 配置要补全关键规则

Windows 本地常用 Apache 或 PHP 内置服务，但 Linux 生产环境基本用 Nginx。没配对，首页能打开，点个登录就 404 是常态。必须确认三点：

• root 指向的是 /path/to/laravel/public，不是项目根目录
• location / 块里有完整重写：try_files $uri $uri/ /index.php?$query_string;（少了 $query_string，带参数的 URL 会丢参）
• location ~ \.php$ 中必须包含：fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;，否则 $_SERVER['SCRIPT_FILENAME'] 错位

文件路径与权限要提前校准

Windows 不区分大小写，Linux 区分。比如代码里写了 use App\Helpers\Myclass;，但实际文件叫 myclass.php，本地没问题，上线就 Class not found。还有两个易漏点：

• storage 和 bootstrap/cache 目录必须可写：sudo chown -R www-data:www-data storage bootstrap/cache
• public/storage 软链接要重建：php artisan storage:link（尤其用 dcat-admin 等后台时，上传图片路径依赖这个）
• 禁止 .env 文件被 Web 直接访问：location ~ \.env { deny all; } 加进 Nginx 配置