Linux服务器上ThinkPHP部署指南

在Linux服务器上部署ThinkPHP项目是一个相对直接的过程，但需要确保所有必要的组件都已正确安装和配置。以下是一个详细的部署指南：

环境准备

1. 安装基础软件：

• 更新软件包：

sudo apt update && sudo apt upgrade -y

• 安装PHP及扩展：

sudo apt install php php-fpm php-mysql php-mbstring php-xml php-curl -y

• 安装Nginx：

sudo apt install nginx -y

• 安装Composer：

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

2. 配置Web服务器：

• Nginx配置示例：

server {
    listen 80;
    server_name yourdomain.com;
    root /path/to/tp6/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php-fpm.sock;
    }
}

• 启用配置：

sudo ln -s /etc/nginx/sites-available/thinkphp.conf /etc/nginx/sites-enabled/
sudo systemctl restart nginx

• Apache配置： 确保启用 mod_rewrite，并在项目根目录添加 .htaccess：

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

ThinkPHP安装

1. Composer创建项目（推荐）：

composer create-project topthink/think tp6 cd tp6

2. 手动下载： 从ThinkPHP官网下载完整版，解压至Web目录：

wget https://example.com/thinkphp6.x.zip
unzip thinkphp6.x.zip -d /var/www/html/

关键配置调整

1. 数据库连接： 修改 .env 文件：

DATABASE_TYPE=mysql
DATABASE_HOSTNAME=127.0.0.1
DATABASE_NAME=dbname
DATABASE_USERNAME=user
DATABASE_PASSWORD=password
DATABASE_PORT=3306

2. 目录权限： 确保运行时目录可写：

chmod -R 755 runtime
chown -R www-data:www-data runtime

3. 调试模式： 开发阶段开启调试：

APP_DEBUG=true

常见问题解决

1. 502 Bad Gateway： 检查PHP-FPM是否运行：

sudo systemctl status php-fpm

确认Nginx配置中的 fastcgi_pass 路径正确。

2. 路由失效： 确保服务器支持PATHINFO，Nginx需包含 try_files $uri $uri/ /index.php?$query_string;。

部署优化建议

• 生产环境安全：关闭调试模式，限制 .env 文件访问。
• 性能提升：开启OPcache，使用Redis缓存会话。
• 自动化部署：结合Git钩子或CI/CD工具实现自动更新。

通过以上步骤，您应该能够在Linux服务器上成功部署ThinkPHP项目。如果在部署过程中遇到任何问题，请参考官方文档或社区最佳实践进行排查。