ThinkPHP项目迁移到Linux服务器必须确保：public为Web根目录、runtime对PHP-FPM可写、Nginx请求全转发至index.php；需同步验证PHP-FPM与CLI版本≥8.0.0，启用mbstring/pdo/mysqlnd/openssl/fileinfo扩展，Nginx配置精准指向public并删除fastcgi_split_path_info，runtime设775+g+s，.env权限644且位于项目根目录，最后执行composer install --optimize-autoloader --no-dev并清理无用文件。
将ThinkPHP项目从开发环境迁移到Linux服务器并稳定运行，必须确保public目录成为Web根、runtime目录对PHP-FPM进程可写、Nginx请求全部正确转发至index.php——缺一不可，否则页面空白、500错误或路由失效会立即出现。
确认PHP版本与必需扩展是否启用
执行php -v仅显示CLI版本，而网页实际运行依赖PHP-FPM；必须同步验证两者：运行ps aux | grep php-fpm查出FPM二进制路径，再用该路径执行/usr/bin/php-fpm81 -v确认版本≥8.0.0（TP8强制要求）。
缺扩展不会报错，但会导致路由加载失败或数据库连接中断：运行php -m | grep -E "mbstring|pdo|mysqlnd|openssl|fileinfo"，漏任一模块都需在/etc/php/8.1/fpm/php.ini中取消对应extension=xxx前的分号；Ubuntu用户注意/etc/php/8.1/fpm/php.ini和/etc/php/8.1/cli/php.ini是两个独立文件，Nginx只读FPM配置。
Nginx配置必须精准指向public并重写URL
方法一：最简安全写法
编辑站点配置（如/etc/nginx/sites-available/myapp），将root设为项目内public子目录绝对路径：root /var/www/myapp/public;——【绝不能指向项目根目录，否则app/、config/等敏感目录可被直接访问】。
立即学习“PHP免费学习笔记（深入）”；
方法二：关键location块必须无歧义
在server块内添加：location / { try_files $uri $uri/ /index.php?$query_string; }location ~ \.php$ { fastcgi_pass unix:/run/php/php8.1-fpm.sock; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name; include fastcgi_params; }。
务必删除所有fastcgi_split_path_info相关行，TP不依赖它，留着会导致PATH_INFO错乱、伪静态失效。
方法三：验证入口可读性
执行ls -l /var/www/myapp/public/index.php，确认Nginx工作用户（如www-data）对该文件有读权限；若显示permission denied，运行sudo chown www-data:www-data /var/www/myapp/public/index.php修复。
Runtime权限与环境变量三步锁定
第一步：查清Nginx与PHP-FPM用户是否一致
运行ps aux | grep nginx | head -1得Nginx主进程用户（Ubuntu多为www-data）；再查/etc/php/8.1/fpm/pool.d/www.conf中user =和group =值，二者必须相同或同组。
第二步：设置runtime组继承与写权限
执行sudo chgrp www-data runtime → sudo chmod 775 runtime → sudo chmod g+s runtime；【g+s确保后续自动生成的log/cache/session子目录自动继承www-data组，避免半夜日志写入失败】。
第三步：检查.env文件是否存在且权限合规
.env必须位于项目根目录（与composer.json同级），内容含APP_DEBUG=false及正确数据库配置；运行ls -l .env确认权限为644，若为600则执行chmod 644 .env，否则FPM无法读取。
生产环境依赖与缓存一次性清理
进入项目根目录，执行composer install --optimize-autoloader --no-dev——这一步跳过phpunit、symfony/var-dumper等开发依赖，生成扁平化类映射，提升加载速度。
删掉所有非必要文件：rm -f .env.example README.md CHANGELOG.md；这些文件若留在线上，可能被扫描工具捕获导致信息泄露。
清空并重建缓存：php think clear；若提示Class 'think\App' not found，说明PHP CLI版本低于8.0，已误装TP6，需先修正PHP版本再重跑composer install。
