如何用Debian搭建ThinkPHP开发环境

1. 准备工作：更新系统

在开始前，确保Debian系统已更新至最新状态，避免依赖冲突：

sudo apt update && sudo apt upgrade -y

2. 安装PHP及必要扩展

ThinkPHP依赖PHP及多个扩展（如MySQL、JSON、XML等），通过以下命令安装：

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

说明：

php：PHP核心解释器；
php-fpm：PHP FastCGI进程管理器（适用于Nginx）；
php-mysql：MySQL数据库驱动；
php-curl/php-gd/php-mbstring：ThinkPHP常用功能扩展（如HTTP请求、图片处理、多字节字符串）。

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

ThinkPHP需通过Web服务器提供服务，推荐使用Nginx（轻量、高性能）：

sudo apt install nginx -y

4. 配置Nginx支持PHP

编辑Nginx默认站点配置（或新建自定义配置），添加PHP处理规则：

sudo nano /etc/nginx/sites-available/default

关键配置（替换your_domain_or_ip为实际域名/IP，/var/www/html/thinkphp为项目路径）：

server {
    listen 80;
    server_name your_domain_or_ip;
    root /var/www/html/thinkphp;
    index index.php index.html index.htm;

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

    location ~ \.php$ {
        include snippets/fastcgi-php.conf; # 引入FastCGI配置
        fastcgi_pass unix:/run/php/php8.1-fpm.sock; # 根据PHP版本调整（如php7.4-fpm.sock）
        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

5. 安装Composer（PHP依赖管理工具）

ThinkPHP项目依赖Composer管理依赖，安装步骤：

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

6. 部署ThinkPHP项目

方式一：下载官方包

wget https://github.com/top-think/thinkphp/archive/refs/tags/v6.0.x.zip -O thinkphp.zip
unzip thinkphp.zip -d /var/www/html/
mv /var/www/html/thinkphp-* /var/www/html/thinkphp

方式二：通过Composer创建项目

cd /var/www/html
composer create-project topthink/think your_project_name

说明：

方式一适用于快速测试，方式二适用于正式项目（支持依赖管理）。

7. 配置数据库

安装MySQL

sudo apt install mysql-server -y
sudo mysql_secure_installation # 初始化安全设置（设置root密码、删除匿名用户等）

创建数据库与用户

mysql -u root -p

在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文件（若不存在则复制public/.env.example）：

cd /var/www/html/thinkphp
cp .env.example .env
nano .env

修改数据库配置（对应步骤7中的数据库信息）：

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

9. 设置目录权限

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

sudo chown -R www-data:www-data /var/www/html/thinkphp
sudo chmod -R 755 /var/www/html/thinkphp

10. 测试访问

启动Web服务后，在浏览器中输入http://your_domain_or_ip，若看到ThinkPHP欢迎页面，则说明环境搭建成功。

常见问题排查

502 Bad Gateway：检查PHP-FPM是否运行（sudo systemctl status php8.1-fpm），确认Nginx配置中的fastcgi_pass路径与PHP-FPM socket一致。
路由失效：确保Nginx配置中包含try_files $uri $uri/ /index.php?$query_string;（支持PATHINFO）。
权限问题：若出现“Permission denied”，检查目录权限是否为www-data:www-data且权限为755。