首页 > 编程语言 >CentOS部署ThinkPHP项目教程

CentOS部署ThinkPHP项目教程

来源：互联网 2026-07-17 07:20:19

在CentOS上部署ThinkPHP项目需完成环境安装、Web服务器配置、项目上传与权限设置。安装Nginx、PHP及扩展、MySQL和Composer；配置伪静态支持；上传项目并安装依赖；设置目录权限；最后优化生产环境如关闭调试、开启缓存。

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

ThinkPHP 项目在 CentOS 上的部署步骤

1. 环境准备

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

CentOS部署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），大部分问题都能在其中找到线索。

侠游戏发布此文仅为了传递信息，不代表侠游戏网站认同其观点或证实其描述