ThinkPHP跨平台使用指南：Linux服务器生产环境部署全流程【说明】-ThinkPHP-PHP中文网

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服务器生产环境部署全流程【说明】

将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强制要求）。

Nginx配置必须精准指向public并重写URL

方法一：最简安全写法
编辑站点配置（如/etc/nginx/sites-available/myapp），将root设为项目内public子目录绝对路径：root /var/www/myapp/public;——【绝不能指向项目根目录，否则app/、config/等敏感目录可被直接访问】。

方法二：关键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修复。

Linux installer

先解析安全源，运行本地CLI安装、启动、卸载Linux桌面应用。用户请求时使用。

下载

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无法读取。