CentOS 与 ThinkPHP 集成开发指南
将 ThinkPHP 框架部署在 CentOS 服务器上，是许多追求稳定与性能的开发者的选择。这份指南将带你走通从环境准备到生产上线的完整路径，避开那些常见的“坑”。
一 环境准备与版本选择
工欲善其事，必先利其器。搭建一个匹配的环境，是后续一切顺利的前提。
- 操作系统建议：首选 CentOS 7.x 系列，其长期支持与稳定性久经考验。当然，步骤在 Alibaba Cloud Linux 3/2 等兼容发行版上同样适用。
- PHP 版本要求：这是关键，版本不匹配是后续问题的首要根源。
- 计划使用 ThinkPHP 6.x？请确保 PHP 版本 ≥ 7.1.0。
- 若想体验 ThinkPHP 8.x 的新特性，则必须准备好 PHP ≥ 8.0.0 的环境。
- 数据库与缓存：MySQL 或 MariaDB 是数据库的常见搭档，而 Redis 则是提升性能的缓存利器。
- 开发工具：Composer（PHP 的依赖管家）和 Git（代码版本控制）必不可少。
- 核心说明：ThinkPHP 在 Linux 环境下运行非常稳定，通常与 Nginx/Apache 配合 PHP-FPM，或直接作为 Apache 模块运行。
二 安装与初始化
下面我们一步步来，把地基打牢。
- 安装 EPEL 与 Remi 仓库（CentOS 7）：这两个仓库提供了丰富的软件包，尤其是新版 PHP。
sudo yum install -y epel-releasesudo yum install -y https://rpms.remirepo.net/enterprise/remi-release-7.rpm
- 启用并安装 PHP 及扩展：这里以安装 PHP 8.0（满足 TP 8 要求）为例。
- 启用仓库：
sudo yum-config-manager --enable remi-php80 - 安装核心及常用扩展：
sudo yum install -y php php-cli php-fpm php-mysqlnd php-zip php-devel php-gd php-mcrypt php-mbstring php-curl php-xml php-pear php-bcmath php-json - 最后，别忘了用
php -v确认一下版本，输出类似“PHP 8.0.x”就对了。
- 启用仓库：
- 安装 Composer：
- 先装依赖：
sudo yum install -y unzip git - 下载安装脚本：
curl -sS https://getcomposer.org/installer | php - 移动到全局路径：
sudo mv composer.phar /usr/local/bin/composer - 检查安装：
composer --version
- 先装依赖：
- 创建 ThinkPHP 项目：以最新的 8.x 版本为例。
- 执行创建命令：
composer create-project topthink my-tp-app - 进入目录并启动内置开发服务器：
cd my-tp-app && php think run（默认监听 8000 端口） - 打开浏览器，访问
https://<服务器公网IP>:8000，看到欢迎页就意味着安装成功了。
- 执行创建命令：
三 生产环境部署与 Web 服务器配置
开发环境跑通了，接下来要配置更安全、高效的生产环境。
- 目录与入口规范：一个重要的安全原则是，对外只暴露
public/目录作为 Web 根目录。项目核心代码和运行时生成的runtime/目录应放在 Web 可访问范围之外。 - Apache 配置要点（确保启用 mod_rewrite）：
- 启用重写模块：
sudo a2enmod rewrite && sudo systemctl restart httpd - 虚拟主机配置示例（关键是将 DocumentRoot 指向 public，并允许 .htaccess 重写）：
- DocumentRoot /var/www/html/my-tp-app/public
- AllowOverride All
- Require all granted
- 启用重写模块：
- 同样，站点根目录应指向
public，并正确配置try_files和fastcgi_pass到 127.0.0.1:9000。 - 配置片段示例：
- root /var/www/html/my-tp-app/public;
- index index.php index.html;
- location / {
- try_files $uri $uri/ /index.php?$query_string;
- }
- location ~ .php$ {
- fastcgi_pass 127.0.0.1:9000;
- fastcgi_index index.php;
- fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
- include fastcgi_params;
- }
- 更改目录所有者：
sudo chown -R nginx:nginx /var/www/html/my-tp-app - 设置目录权限为 755：
sudo find /var/www/html/my-tp-app -type d -exec chmod 755 {} ; - 设置文件权限为 644：
sudo find /var/www/html/my-tp-app -type f -exec chmod 644 {} ; - 确保运行时目录可写：
sudo chmod -R 775 /var/www/html/my-tp-app/runtime
- 启动并设置 PHP-FPM 开机自启：
sudo systemctl enable --now php-fpm - 启动并设置 Nginx（或 httpd）开机自启：
sudo systemctl enable --now nginx
四 数据库与连接配置
应用离不开数据，我们来配置数据库连接。
- 安装与初始化数据库（以 MariaDB 为例）：
- 安装：
sudo yum install -y mariadb-server mariadb - 设置开机启动并立即启动：
sudo systemctl enable --now mariadb - 运行安全初始化脚本：
sudo mysql_secure_installation（设置 root 密码及基础安全选项）
- 安装：
- 创建应用数据库与用户（示例）：
- CREATE DATABASE tp_app DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci;
- CREATE USER ‘tp_user’@‘127.0.0.1’ IDENTIFIED BY ‘StrongPass!’;
- GRANT ALL PRIVILEGES ON tp_app.* TO ‘tp_user’@‘127.0.0.1’;
- FLUSH PRIVILEGES;
- ThinkPHP 配置：
- 在项目根目录的
.env文件或config/database.php中配置连接信息：- TYPE=mysql
- HOSTNAME=127.0.0.1
- DATABASE=tp_app
- USERNAME=tp_user
- PASSWORD=StrongPass!
- HOSTPORT=3306
- CHARSET=utf8mb4
- 一个小提示：开发环境可以开启
APP_DEBUG=true方便调试；但生产环境务必关闭此项，并配置好合适的缓存与日志策略。
- 在项目根目录的
五 常见问题与排查
即使步骤清晰，也难免遇到小波折。这里有几个高频问题的排查思路。
- 端口与防火墙：
- 开发服务器默认用 8000 端口；生产环境请使用标准的 80（HTTP）或 443（HTTPS）端口。
- 务必在服务器安全组和本地防火墙放行相应端口：
sudo firewall-cmd --permanent --add-port=80/tcp --add-port=443/tcp && sudo firewall-cmd --reload
- 路由 404 或白屏：
- 首先检查 Web 服务器（Nginx/Apache）的根目录是否确实指向了项目下的
public/文件夹。 - 其次，确认 URL 重写功能已正确启用（Apache 的 mod_rewrite 或 Nginx 的 try_files 指令）。
- 首先检查 Web 服务器（Nginx/Apache）的根目录是否确实指向了项目下的
- 权限错误：
- 确保
runtime/目录及日志目录对 Web 服务运行用户（如 nginx, apache）是可写的。 - 检查项目文件的所有者和权限设置是否正确。
- 确保
- PHP 版本不匹配：
- 在命令行执行
php -v确认实际版本。记住：TP 8 需要 PHP ≥ 8.0，TP 6 需要 PHP ≥ 7.1。
- 在命令行执行
- Composer 安装缓慢或失败：
- 可以临时切换为国内镜像加速：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer。
- 可以临时切换为国内镜像加速：
