ThinkPHP在Linux下如何高效部署

ThinkPHP在Linux下的高效部署指南

一、前置准备：环境与工具

在Linux（如Ubuntu/Debian/CentOS）上部署ThinkPHP前，需安装以下核心组件：

基础软件：PHP（≥7.4，需开启PDO、OpenSSL、Mbstring、CURL等扩展）、Web服务器（推荐Nginx，性能更优；或Apache）、数据库（MySQL/MariaDB）、Composer（PHP依赖管理工具）。

安装示例（Ubuntu）：

# 更新系统并安装PHP及扩展
sudo apt update && sudo apt upgrade -y
sudo apt install php php-fpm php-mysql php-mbstring php-xml php-curl -y
# 安装Nginx和Composer
sudo apt install nginx -y
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

验证环境：通过php -v确认PHP版本，nginx -v确认Nginx版本，composer -V确认Composer可用。

二、ThinkPHP项目部署

1. 项目创建/上传

推荐方式（Composer创建）：直接生成标准项目结构，避免手动配置遗漏。

composer create-project topthink/think tp6 /var/www/html/tp6  # tp6为项目目录
cd /var/www/html/tp6

手动上传：从官网下载完整版，解压至Web目录（如/var/www/html/tp6）。

2. 依赖安装与配置

安装依赖：进入项目目录，运行composer install安装所需包。

配置数据库：修改.env文件（而非config/database.php，避免提交敏感信息），设置数据库连接：

DATABASE_TYPE=mysql
DATABASE_HOSTNAME=127.0.0.1
DATABASE_NAME=your_db
DATABASE_USERNAME=your_user
DATABASE_PASSWORD=your_pass
DATABASE_PORT=3306

设置目录权限：确保runtime目录（存储缓存、日志）可写，避免权限问题：

sudo chown -R www-data:www-data /var/www/html/tp6  # www-data为Web用户（根据系统调整）
sudo chmod -R 755 runtime

3. Web服务器配置

Nginx配置（推荐）：创建虚拟主机文件/etc/nginx/sites-available/tp6.conf，内容如下：

server {
    listen 80;
    server_name your_domain.com;  # 替换为域名/IP
    root /var/www/html/tp6/public;  # 必须指向public目录（入口文件所在）
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;  # 路由重写，支持PATHINFO
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;  # 根据PHP版本调整
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

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

启用配置并重启Nginx：

sudo ln -s /etc/nginx/sites-available/tp6.conf /etc/nginx/sites-enabled/
sudo nginx -t  # 测试配置语法
sudo systemctl restart nginx

Apache配置：启用mod_rewrite模块，在项目根目录添加.htaccess文件：

<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteRule ^(.*)$ public/$1 [L]
</IfModule>

三、安全与性能优化

1. 生产环境安全设置

关闭调试模式：修改config/app.php，设置app_debug = false，避免暴露敏感信息。
限制.env访问：通过Nginx配置（如上）禁止访问.env文件，防止数据库密码等泄露。

2. 性能提升措施

开启OPcache：编辑php.ini（如/etc/php/8.2/fpm/php.ini），取消以下注释：

opcache.enable=1
opcache.memory_consumption=128
opcache.interned_strings_buffer=8
opcache.max_accelerated_files=4000
opcache.validate_timestamps=0  # 生产环境关闭，避免频繁检查文件

重启PHP-FPM生效：sudo systemctl restart php8.2-fpm。

使用Redis缓存会话：安装Redis并配置ThinkPHP使用Redis存储会话，提升会话读取速度。

3. 自动化部署（可选）

Git钩子：在服务器项目的hooks/post-receive中添加脚本，实现代码推送后自动拉取、安装依赖：
```
#!/bin/bash
cd /var/www/html/tp6
git pull origin main
composer install --no-interaction --prefer-dist
```
赋予执行权限：chmod +x post-receive。
CI/CD工具：使用Jenkins、GitLab CI等工具，集成测试、构建、部署流程，减少人工操作。

四、常见问题排查

502 Bad Gateway：检查PHP-FPM是否运行（sudo systemctl status php8.2-fpm），确认Nginx配置中的fastcgi_pass路径与PHP-FPM的listen指令一致。
路由失效：确保Nginx配置中包含try_files $uri $uri/ /index.php?$query_string;，且location /块未覆盖路由规则。

Composer安装慢：配置国内镜像源，加速依赖下载：

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/