php项目从windows迁移到linux需严格对齐php版本与扩展、处理大小写敏感路径、配置nginx重写规则、校准.env与文件权限、确保php-fpm正确监听，任一环节疏漏均会导致白屏、404或500错误。
把PHP项目从Windows 12本地开发环境迁移到Linux服务器，不是复制粘贴就能跑通的事——PHP版本小数点差一位、扩展少一个、路径大小写写错、.env配置漏注入、Nginx重写规则缺参数，任一环节出错都会导致白屏、404或500错误。
确认PHP版本与核心扩展一致性
Windows 12上用的是PHP 8.2.15（通过PHPStudy或XAMPP），Linux服务器必须严格对齐。不能只装php-fpm，要明确指定版本并安装全部必需扩展。
在Ubuntu/Debian执行：
sudo apt install php8.2-cli php8.2-fpm php8.2-mbstring php8.2-xml php8.2-zip php8.2-bcmath php8.2-curl php8.2-pdo php8.2-mysql php8.2-opcache
CentOS/RHEL系先启用EPEL与PowerTools，再运行：
sudo dnf install php82-php-cli php82-php-fpm php82-php-mbstring php82-php-xml php82-php-zip php82-php-bcmath php82-php-curl php82-php-pdo php82-php-mysqlnd php82-php-opcache
【必须验证】执行php -v确认输出为8.2.x；再运行php -m | grep -E "mbstring|pdo|mysql|opcache"，缺任何一项都得补装——Laravel 11和Symfony 6.4均依赖opcache，缺失会导致路由加载极慢甚至超时。
迁移代码并处理大小写敏感问题
Windows不区分大小写，Linux严格区分。常见故障：类文件名为UserController.php，但代码里use App\Controllers\usercontroller;，上线直接Class not found。
第一步：用SCP上传整个项目到/var/www/html/myapp
scp -r C:\xampp\htdocs\myapp user@server-ip:/var/www/html/
第二步：进入项目目录，执行大小写扫描
cd /var/www/html/myapp && find . -name "*.php" -exec grep -l "Controller\|Model\|view\|View" {} \; | xargs ls -l
第三步：重点检查三类路径
① 类名与文件名是否完全一致（UserAuthController.php ↔ UserAuthController）
② 视图引用路径是否全小写（$this->render('login') → views/auth/login.php）
③ require_once中的路径是否混用大小写（如protected/config/main.php不能写成PROTECTED/CONFIG/MAIN.PHP）
这一步操作起来很简单，直接把所有控制器、模型、视图文件夹名和文件名统一转为小写即可，避免逐个排查。
配置Nginx并补全关键重写规则
Nginx不支持.htaccess，必须手动写死重写逻辑。漏掉$query_string或SCRIPT_FILENAME错位，首页能打开，点链接就404或报Undefined index: REQUEST_URI。
方法一：创建站点配置文件
sudo nano /etc/nginx/sites-available/myapp
方法二：填入最小可行配置（替换server_name为你的域名或IP）
server {
listen 80;
server_name example.com;
root /var/www/html/myapp/public;
index index.php;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ ^/index\.php(/|$) {
fastcgi_pass unix:/run/php/php8.2-fpm.sock;
fastcgi_split_path_info ^(.+\.php)(/.*)$;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
fastcgi_param DOCUMENT_ROOT $realpath_root;
}
location ~ \.php$ {
return 404;
}
}
方法三：启用并重载
sudo ln -sf /etc/nginx/sites-available/myapp /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
初始化.env与权限校准
绝对不提交.env到Git。如果已提交过，先在Linux服务器上执行git rm --cached .env && echo ".env" >> .gitignore。
第一步：生成生产环境配置文件
cp .env.example .env
第二步：注入生产配置（数据库地址、APP_URL、密钥等）
sed -i 's/DB_HOST=127.0.0.1/DB_HOST=localhost/g' .env
sed -i 's/APP_URL=http:\/\/localhost:8000/APP_URL=https:\/\/example.com/g' .env
第三步：生成应用密钥
php artisan key:generate
第四步：设置storage与bootstrap/cache可写权限
sudo chown -R www-data:www-data storage bootstrap/cache
sudo chmod -R 755 storage bootstrap/cache
【不可跳过】这一步没做完，Laravel会报“Unable to write to cache directory”，Symfony会卡在cache:warmup阶段，页面空白无日志。
启动PHP-FPM并验证运行状态
PHP-FPM监听方式必须与Nginx配置匹配。Unix socket路径不对，Nginx会报502 Bad Gateway。
第一步：确认PHP-FPM池配置
Ubuntu/Debian编辑/etc/php/8.2/fpm/pool.d/www.conf，检查：
listen = /run/php/php8.2-fpm.sock
listen.owner = www-data
listen.group = www-data
user = www-data
group = www-data
第二步：启用并启动服务
sudo systemctl enable php8.2-fpm
sudo systemctl start php8.2-fpm
第三步：验证状态
sudo systemctl status php8.2-fpm → 必须显示active (running)
第四步：测试PHP解析
echo "" | sudo tee /var/www/html/info.php
访问http://your-server-ip/info.php → 看到PHP版本页即表示PHP与Nginx通信成功。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
