CentOS部署ThinkPHP项目教程

在 CentOS 上部署 ThinkPHP 项目，本质上是按标准流程操作：环境准备、Web 服务器配置、项目上传、权限设置，再加上生产环境调优。以下将各步骤拆解，并附上具体命令和配置参考，便于直接对照操作。

ThinkPHP 项目在 CentOS 上的部署步骤

1. 环境准备

部署前需完成基础环境——Web 服务器（Nginx 或 Apache）、PHP 及扩展、数据库（MySQL/MariaDB）、以及 Composer。这些组件缺一不可，否则 ThinkPHP 无法运行。

• 更新系统：sudo yum update -y
• 安装 Nginx：

  sudo yum install epel-release -y
  sudo yum install nginx -y
  sudo systemctl start nginx
  sudo systemctl enable nginx

• 安装 PHP 及扩展（ThinkPHP 6.x 推荐 PHP 7.4+）：

  sudo yum install php php-fpm php-mysqlnd php-gd php-mbstring php-curl php-xml php-bcmath -y
  sudo systemctl start php-fpm
  sudo systemctl enable php-fpm

• 安装 MySQL/MariaDB：

  sudo yum install mysql-server -y
  sudo systemctl start mysqld
  sudo systemctl enable mysqld
  sudo mysql_secure_installation  # 完成安全配置（设置 root 密码、移除匿名用户等）

• 安装 Composer（依赖管理工具）：

  curl -sS https://getcomposer.org/installer | php
  sudo mv composer.phar /usr/local/bin/composer

2. 配置 Web 服务器

Nginx 配置（推荐）

ThinkPHP 依赖伪静态支持，需修改 Nginx 配置文件（/etc/nginx/conf.d/thinkphp.conf）：

server {
    listen 80;
    server_name your_domain.com;  # 替换为域名或 IP
    root /var/www/html/thinkphp/public;  # 项目 public 目录
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php$query_string;  # 路由重写
    }

    location ~ \.php$ {
        fastcgi_pass unix:/run/php-fpm/www.sock;  # PHP-FPM socket 路径
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.ht {
        deny all;  # 禁止访问 .htaccess 文件
    }
}

验证配置并重启 Nginx：

sudo nginx -t   # 测试配置语法
sudo systemctl restart nginx

Apache 配置（可选）

若使用 Apache，需启用 mod_rewrite 并配置虚拟主机（/etc/httpd/conf.d/thinkphp.conf）：

    ServerName your_domain.com
    DocumentRoot /var/www/html/thinkphp/public
    
        AllowOverride All   # 允许 .htaccess 覆盖
        Require all granted
    

重启 Apache：

sudo systemctl restart httpd

3. 部署 ThinkPHP 项目

• 上传项目：通过 FTP/SFTP 或 Git 将项目代码上传至 /var/www/html/thinkphp（或其他目录）。
• 安装依赖：进入项目目录，执行 composer install --no-dev --optimize-autoloader（--no-dev 用于生产环境移除开发依赖，--optimize-autoloader 优化自动加载性能）。
• 配置数据库：编辑 .env 文件（或 config/database.php），填写数据库连接信息：

  DB_TYPE=mysql
  DB_HOST=127.0.0.1
  DB_NAME=your_database
  DB_USER=your_username
  DB_PASSWORD=your_password
  DB_PORT=3306
  DB_PREFIX=tp_   # 表前缀（可选）

• 创建数据库：登录 MySQL，执行以下命令：

  CREATE DATABASE your_database CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
  CREATE USER 'your_username'@'localhost' IDENTIFIED BY 'your_password';
  GRANT ALL PRIVILEGES ON your_database.* TO 'your_username'@'localhost';
  FLUSH PRIVILEGES;

• 运行数据库迁移（若有）：

  php think migrate:run   # 执行数据库迁移

4. 设置权限

权限问题常导致访问失败，因此这一步不可省略：

sudo chown -R nginx:nginx /var/www/html/thinkphp   # Nginx 用户（若用 Apache 则改为 apache:apache）
sudo chmod -R 755 /var/www/html/thinkphp
sudo chmod -R 775 /var/www/html/thinkphp/runtime   # runtime 目录需可写

5. 启动服务与访问

• 启动服务：

  sudo systemctl start nginx
  sudo systemctl start php-fpm
  sudo systemctl enable nginx
  sudo systemctl enable php-fpm

• 访问项目：在浏览器输入 http://your_domain.com，若看到 ThinkPHP 欢迎页面，说明部署成功。

6. 生产环境优化（可选）

• 关闭调试模式：编辑 .env 文件，设置 APP_DEBUG=false。
• 配置缓存：开启 OPcache（修改 php.ini）和 Redis 缓存（修改 config/cache.php）。
• 设置 Supervisor：管理 PHP-FPM 进程，避免进程意外终止（参考 ThinkPHP 官方文档）。
• 配置 HTTPS：使用 Let’s Encrypt 免费证书，提升网站安全性（参考 Certbot 文档）。

以上步骤覆盖了 ThinkPHP 项目在 CentOS 上的完整部署流程，实际使用时可根据端口、域名、数据库类型等灵活调整。部署中若遇到问题，首先查看 Web 服务器错误日志（/var/log/nginx/error.log 或 /var/log/httpd/error_log），大部分问题都能在其中找到线索。