CentOS下ThinkPHP项目部署全流程教程

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），大部分问题都能在那里找到线索。