ThinkPHP跨平台部署实操：Linux云服务器（CentOSUbuntu）环境搭建【说明】

ThinkPHP Linux上线核心是三步：public设为Web根目录、PHP-FPM与CLI版本一致、runtime目录被Web和CLI用户共同写入；任一缺失将导致白屏、502或路由失效。

在Linux云服务器（CentOS或Ubuntu）上完成ThinkPHP项目上线，核心是让public目录成为Web可访问入口、确保PHP-FPM与CLI版本一致、runtime目录被Web进程和命令行用户共同写入——这三点任一缺失，都会导致白屏、502或路由失效。

确认并安装基础运行环境

先查系统类型：执行cat /etc/os-release | grep -E "NAME|VERSION"，区分是Ubuntu系还是CentOS/RHEL系，再执行对应命令。

Ubuntu/Debian系统执行：sudo apt update && sudo apt install -y php8.2 php8.2-fpm php8.2-mysql php8.2-mbstring php8.2-xml php8.2-curl php8.2-opcache php8.2-fileinfo nginx composer。

CentOS 8+/Rocky/AlmaLinux系统执行：sudo dnf module enable php:remi-8.2 && sudo dnf install -y php php-mysqlnd php-mbstring php-xml php-curl php-opcache php-fileinfo nginx composer；若为CentOS 7，先启用EPEL和Remi源再安装。

立即学习“PHP免费学习笔记（深入）”；

装完必须验证两处PHP版本：终端执行php -v，输出应为8.2.x；再执行ps aux | grep php-fpm | head -1，看进程调用的二进制路径（如/usr/bin/php-fpm82），用该路径查版本：/usr/bin/php-fpm82 -v。两个版本不一致，网站必报错。

创建项目并初始化依赖

方法一：用Composer直接生成标准结构（推荐）
执行composer create-project topthink/think /var/www/myapp，项目将自动创建完整目录，含public、runtime、app等子目录。

方法二：手动上传已开发完成的项目
用scp或rsync把本地项目传到/var/www/myapp，确保目录内有public/index.php文件；然后进入目录执行composer install --no-dev，跳过开发依赖，减小体积。

【注意】不要在项目根目录运行php think命令后发现Class think\App not found——这是因CLI PHP版本低于8.0，Composer自动降级装了TP6。删掉整个项目重来前，先fix PHP版本。

配置Nginx指向public并绕开常见陷阱

第一步：编辑站点配置文件，路径为/etc/nginx/sites-available/myapp（Ubuntu）或/etc/nginx/conf.d/myapp.conf（CentOS）。

Nginx Proxy Manager

管理 Nginx Proxy Manager（NPM）的主机、证书和访问列表，用于添加域名、指向服务器/端口、启用 SSL 或查看代理主机状态。

下载

第二步：写入以下内容（严格复制，不可增删空格或分号）：
server {
  listen 80;
  server_name _;
  root /var/www/myapp/public;
  index index.php;
  location / {
    try_files $uri $uri/ /index.php?$query_string;
  }
  location ~ \.php$ {
    fastcgi_pass unix:/run/php/php-fpm.sock;
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
  }
}

第三步：禁用所有fastcgi_split_path_info相关行——它会污染$_SERVER[PATH_INFO]，导致ThinkPHP路由解析失败，哪怕只留一行也会出问题。

第四步：启用配置并测试：sudo ln -sf /etc/nginx/sites-available/myapp /etc/nginx/sites-enabled/ → sudo nginx -t（必须显示success）→ sudo systemctl reload nginx。

修复runtime权限：让Web和CLI都能写入

① 查Nginx工作用户：执行ps aux | grep nginx | grep master | awk {print $1}，Ubuntu返回www-data，CentOS返回nginx。

② 查PHP-FPM用户组：打开/etc/php/*/fpm/pool.d/www.conf（路径用ls /etc/php/*/fpm/pool.d/确认），找到user =和group =两行，确保它们与Nginx用户一致或同属一个组。

③ 执行权限修复：sudo chgrp www-data /var/www/myapp/runtime → sudo chmod 775 /var/www/myapp/runtime → sudo chmod g+s /var/www/myapp/runtime。

【关键】别用chmod 777 runtime——session和cache子目录存的是登录态与敏感缓存，开放过宽等于主动暴露后门。

关闭调试模式并验证数据库连接

直接编辑/var/www/myapp/.env文件，将app_debug=true改为app_debug=false；同时填写数据库参数：database_type=mysql、database_hostname=127.0.0.1、database_name=your_db、database_username=your_user、database_password=your_pass。

保存后，在终端进入项目根目录，执行php think migrate:status，若返回迁移列表说明数据库连通且权限正常；若报错“Access denied”，检查MySQL用户是否允许localhost连接，而非仅127.0.0.1。

最后一步：浏览器访问服务器IP，看到ThinkPHP默认首页即部署成功。