ThinkPHP项目如何在Debian上部署

ThinkPHP项目在Debian上的部署步骤

1. 系统准备

确保Debian系统已更新至最新版本，并安装基础工具：

sudo apt update && sudo apt upgrade -y
sudo apt install vim wget curl -y

2. 安装PHP及扩展

ThinkPHP需要PHP 7.4及以上版本及常用扩展，通过以下命令安装：

sudo apt install php php-cli php-fpm php-mysql php-curl php-gd php-mbstring php-xml php-zip -y

验证PHP安装：

php -v

3. 安装Web服务器（以Nginx为例）

Debian默认仓库中的Nginx版本稳定，适合服务器环境：

sudo apt install nginx -y

启动Nginx并设置开机自启：

sudo systemctl start nginx
sudo systemctl enable nginx

4. 配置Nginx虚拟主机

编辑Nginx默认配置文件（或新建自定义配置），指向ThinkPHP项目的public目录（关键步骤，确保路由正常）：

sudo vim /etc/nginx/sites-available/thinkphp

添加以下内容（替换your_domain.com为域名/IP，/var/www/html/thinkphp为项目路径）：

server {
    listen 80;
    server_name your_domain.com;
    root /var/www/html/thinkphp/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:/var/run/php/php8.2-fpm.sock; # 根据PHP版本调整sock路径
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    # 可选：优化静态文件缓存
    location ~* \.(jpg|jpeg|png|gif|css|js|ico)$ {
        expires 30d;
        access_log off;
    }
}

启用配置并测试语法：

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

5. 安装Composer

ThinkPHP依赖Composer管理依赖，全局安装Composer：

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

验证Composer安装：

composer -V

6. 部署ThinkPHP项目

将项目文件上传至服务器（如/var/www/html/thinkphp），推荐使用Git克隆或压缩包上传：

cd /var/www/html
composer create-project topthink/think your_project_name  # 从官方仓库创建新项目
# 或上传现有项目后解压

进入项目目录，安装依赖：

cd /var/www/html/thinkphp
composer install

7. 配置数据库

安装MySQL并创建数据库：

sudo apt install mysql-server -y
sudo mysql_secure_installation  # 设置root密码及安全选项

登录MySQL，创建数据库和用户：

CREATE DATABASE thinkphp_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'thinkphp_user'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON thinkphp_db.* TO 'thinkphp_user'@'localhost';
FLUSH PRIVILEGES;
exit;

8. 配置ThinkPHP项目

复制.env.example生成.env文件（隐藏敏感信息）：

cp .env.example .env

编辑.env文件，配置数据库连接（替换为实际值）：

[DATABASE]
TYPE=mysql
HOSTNAME=127.0.0.1
DATABASE=thinkphp_db
USERNAME=thinkphp_user
PASSWORD=your_password
HOSTPORT=3306

生成应用密钥（增强安全性）：

php think key:generate

9. 设置目录权限

确保Web服务器用户（通常为www-data）对项目目录有读写权限：

sudo chown -R www-data:www-data /var/www/html/thinkphp
sudo chmod -R 755 /var/www/html/thinkphp
sudo chmod -R 775 /var/www/html/thinkphp/runtime  # runtime目录需可写

10. 测试访问

启动Web服务，通过浏览器访问http://your_domain.com（若使用IP则替换为服务器IP）。若看到ThinkPHP欢迎页面，说明部署成功。

常见问题排查

• 502 Bad Gateway：检查PHP-FPM是否运行（sudo systemctl status php8.2-fpm），确认Nginx配置中的fastcgi_pass路径与PHP-FPM sock文件一致。
• 路由失效：确保Nginx配置中包含try_files $uri $uri/ /index.php?$query_string;，且location /块未被覆盖。
• 权限问题：若出现“Permission denied”错误，检查目录权限是否为www-data用户可写。