说到 ThinkPHP 在 CentOS 上的部署，其实核心问题就那几个：PHP 版本对不对、扩展装没装全、Web 服务器配没配好。只要把这几个关键点拿捏住，稳定运行是没问题的。
先说版本基线。如果你用的是 ThinkPHP 6.x，那 PHP 版本必须 ≥ 7.1.0；到了 ThinkPHP 8.0，要求就更高了，PHP 得 ≥ 8.0。 CentOS 7 默认的 PHP 是 5.4，显然不够用，得通过 Remi 仓库来启用对应的高版本。开发环境图省事的话，直接用内置服务器 php think run 跑一下就能验证，但生产环境还是建议老老实实上 Nginx/Apache 搭配 PHP-FPM。
常见兼容性问题与修复
在实际部署中，最容易踩的坑无非这么几个，我们一个一个来看。
文件大小写敏感导致模板或类找不到。 Windows 下不区分大小写，但 Linux 是严格区分的。比如模板文件叫 TestSql.html，调用时却写成 fetch('testsql')，那肯定找不到。解决思路也很简单：要么统一命名规范，全小写或者保持驼峰一致；要么在调用时用 $this->fetch($request->action(true)) 保留原始大小写，不过这种方法不太建议去动框架核心。
缺了 PHP 扩展或驱动。 经常遇到的情况包括：ctype 函数未定义、PDO 或 pdo_mysql 找不到、报错“could not find driver”。修复方法就是安装对应的扩展，比如 php-ctype、php-pdo、php-pdo_mysql、php-mysqlnd、php-gd、php-mbstring、php-xml、php-zip 这些，装完记得重启 PHP-FPM 和 Web 服务。
PHP 版本不匹配。 这个其实和第一个问题有点像。CentOS 7 默认 PHP 5.4 太低，或者项目要求 PHP 8.0+，但系统没跟上。解决办法就是启用 Remi 仓库，安装需要的版本，比如 remi-php80，然后把配套的扩展也一并装上。
URL 重写规则配置不当导致路由 404。 生产环境下，Nginx 需要在配置里加上 try_files $uri $uri/ /index.php?$query_string;；Apache 则需要启用 mod_rewrite 模块，并配好重写规则。
SELinux 或防火墙出来捣乱。 开发调试时，可以临时用 setenforce 0 关掉 SELinux 来验证问题。但生产环境可不能这么干，得配置正确的 SELinux 布尔值或策略，同时确保防火墙放行了需要用到的端口（比如 8000、80、443）。
CentOS 7 与 8 部署要点对比
| 维度 | CentOS 7 | CentOS 8 |
|---|---|---|
| 默认 PHP | 5.4（过低，需要更换） | 7.2（仍可能低于项目需求） |
| 启用 PHP 8.0 | 安装 EPEL + Remi，启用 remi-php80 后 yum install php php-fpm ... | 使用 Remi 仓库启用相应版本（如 remi-php80/81/82） |
| 常用扩展 | 建议安装：php-mysqlnd php-gd php-mbstring php-xml php-zip php-bcmath php-json php-fpm | 同上（按项目实际增减） |
| 开发验证 | php think run（默认 8000 端口） | 同上 |
| 生产建议 | Nginx/Apache + PHP-FPM，正确配置重写规则与权限 | 同上 |
需要说明的是，ThinkPHP 6 官方要求 PHP ≥ 7.1，ThinkPHP 8 要求 PHP ≥ 8.0。在 CentOS 7 或 8 上都能通过 Remi 仓库安装到所需版本。部署前，记得用 php -v 和 php -m 检查版本和扩展是否都到位了。
标准化部署与排查清单
最后，整理一份标准化的操作流程，方便按步骤来，避免遗漏。
安装与版本
- 先安装 EPEL 和 Remi 仓库
- 启用所需的 PHP 版本仓库，比如
remi-php80 - 执行
yum install php php-cli php-fpm php-mysqlnd php-gd php-mbstring php-xml php-zip ... - 用
php -v确认版本
Web 服务与重写
- Nginx：配置
root指向项目public目录，加上try_files $uri $uri/ /index.php?$query_string;；PHP-FPM 通过 127.0.0.1:9000 或 unix socket 连接，最后重启服务 - Apache：启用
mod_rewrite，配置AllowOverride All，使用标准重写规则
项目初始化与依赖
- 使用
composer create-project topthink创建项目 - 进入项目目录，执行
php think run验证开发环境 - 生产环境按需执行
composer install和php think vendor:publish
权限与运行用户
- 建议将项目目录权限赋给 Web 服务用户：
chown -R nginx:nginx（或apache:apache） - 设置目录权限：
chmod -R 755 - 确保
runtime和vendor目录可写
数据库与连接
- 安装并启动 MariaDB/MySQL
- 执行
mysql_secure_installation进行安全初始化 - 在
.env或config/database.php中正确配置数据库信息
日志与快速排查
- 查看 PHP-FPM 错误日志、Nginx/Apache 错误日志、应用
runtime/log目录 - 重点关注这些关键词：
could not find driver、Call to undefined function ctype_lower()、Permission denied、No input file specified、404路由失效
