游乐游手机版
首页/编程语言/文章详情

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

时间:2026-07-11 06:42
在CentOS上部署ThinkPHP项目需完成环境安装、Web服务器配置、项目上传与权限设置。安装Nginx、PHP及扩展、MySQL和Composer;配置伪静态支持;上传项目并安装依赖;设置目录权限;最后优化生产环境如关闭调试、开启缓存。
在CentOS上部署ThinkPHP项目,本质上就是一套标准流程:环境准备、Web服务器配置、项目上传、权限设置,再加上一些生产环境的调优。下面就把这些步骤拆开来说,每一步都配上具体的命令和配置参考,方便直接对照操作。

ThinkPHP项目在CentOS上的部署步骤

1. 环境准备

部署前要先搞定基础环境——Web服务器(Nginx或Apache)、PHP及其扩展、数据库(MySQL/MariaDB)、以及Composer。这些组件缺一不可,否则ThinkPHP跑不起来。

thinkphp项目在centos上如何部署

  • 更新系统: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
  • 访问项目:在浏览器输入https://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),大部分问题都能在那里找到线索。

来源:https://www.yisu.com/ask/106340.html
上一篇CentOS操作系统Go语言性能测试方法完整详解指南 下一篇CentOS系统上ThinkPHP兼容性问题完整详细解决步骤指南
本站内容用于信息整理与展示,如有侵权或内容问题请及时联系处理。

相关推荐

补充同频道和同主题内容,方便继续浏览更多相关内容。

同类最新

继续查看同栏目最近更新的文章。

更多
IDEA中SpringBoot项目热部署实现指南
编程语言 · 2026-07-11

IDEA中SpringBoot项目热部署实现指南

Springboot项目在IDEA中实现热部署需依次完成:开启自动编译(静态与动态编译)、启用热部署策略、引入spring-boot-devtools依赖、关闭浏览器缓存,最后启动测试即可生效,省去手动重启时间,大幅提升开发效率。

Java实现Excel转JSON的代码详解
编程语言 · 2026-07-11

Java实现Excel转JSON的代码详解

使用Java结合FreeSpire XLS库可自动将Excel转为JSON,通过读取工作表并映射为键值对,高效支持数据迁移、报表导出与系统对接,大幅提升效率并消除手动录入错误。

Golang高效布谷鸟过滤器多字符集字符串过滤
编程语言 · 2026-07-11

Golang高效布谷鸟过滤器多字符集字符串过滤

布谷鸟过滤器支持删除操作,通过指纹截断与双哈希定位实现多字符集高效过滤。指纹截断需采用fnv64a或xxhash快速哈希并取低8位,桶索引使用独立双哈希避免假阳性。并发安全需以固定数组配合sync atomic实现。

Java使用Poi-tl按Word模板生成动态表格
编程语言 · 2026-07-11

Java使用Poi-tl按Word模板生成动态表格

Poi-tl是Word导出工具,文档周全,支持多级合并表头生成。通过{{text}}、{{?var}}、{{ table}}标签处理模板,传入TableRenderData对象即可动态渲染表格。示例展示用户信息表格生成,并提供工具类消除表格首行缩进,确保格式正确。

Go语言微服务集成Swagger生成交互式API文档完整教程
编程语言 · 2026-07-11

Go语言微服务集成Swagger生成交互式API文档完整教程

在Go微服务中集成Swagger常见四大问题:swaginit初始化失败需确保存在packagemain及注释;SwaggerUI加载失败因路由映射错误或未导入docs;@Param注解必须严格遵循格式;部署后接口文档显示localhost因硬编码host,应删除或通过环境变量动态注入。