Debian如何配置ThinkPHP数据库

Debian系统配置ThinkPHP数据库的完整步骤

1. 准备基础环境

在配置数据库前，需确保Debian系统已安装PHP（7.4+）、Web服务器（Nginx/Apache）、MySQL/MariaDB及Composer（ThinkPHP依赖管理工具）。

更新软件包列表：
```
sudo apt update
```

安装PHP及常用扩展（ThinkPHP 6.x要求PHP 7.4+）：

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

安装Web服务器（以Nginx为例）：
```
sudo apt install nginx -y
```
安装MySQL数据库：
```
sudo apt install mysql-server -y
```

安装Composer（用于管理ThinkPHP依赖）：

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

2. 配置Web服务器

需将Web服务器指向ThinkPHP项目的public目录（入口文件index.php所在目录），并配置URL重写以支持ThinkPHP的路由功能。

Nginx配置示例（编辑/etc/nginx/sites-available/default）：

server {
    listen 80;
    server_name your_domain.com;  # 替换为你的域名或IP
    root /var/www/your_project/public;  # 替换为项目public目录路径
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;  # 关键：将请求转发到index.php
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/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 ln -s /etc/nginx/sites-available/default /etc/nginx/sites-enabled/
sudo nginx -t  # 测试配置语法
sudo systemctl restart nginx

3. 创建数据库与用户

通过MySQL命令行工具创建数据库、用户并授权，确保ThinkPHP应用有权限访问数据库。

登录MySQL：
```
sudo mysql -u root -p
```

创建数据库（建议使用utf8mb4字符集支持emoji等特殊字符）：

CREATE DATABASE your_database_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

创建用户并授权（替换your_username、your_password为实际值）：

CREATE USER 'your_username'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON your_database_name.* TO 'your_username'@'localhost';
FLUSH PRIVILEGES;  # 刷新权限

退出MySQL：
```
exit;
```

4. 配置ThinkPHP数据库连接

ThinkPHP的数据库配置主要通过**.env文件**（环境变量配置）或**config/database.php**（应用配置文件）实现，优先使用.env文件（避免敏感信息泄露）。

修改.env文件（位于项目根目录）：

# 数据库配置（ThinkPHP 6.x+）
DB_CONNECTION=mysql  # 数据库类型（mysql/sqlite/pgsql等）
DB_HOST=127.0.0.1    # 数据库服务器地址（本地用127.0.0.1）
DB_PORT=3306         # 数据库端口（MySQL默认3306）
DB_DATABASE=your_database_name  # 数据库名
DB_USERNAME=your_username       # 数据库用户名
DB_PASSWORD=your_password       # 数据库密码

若使用config/database.php（ThinkPHP 5.x）：
编辑config/database.php，修改connections数组中的mysql配置：

return [
    'default' => 'mysql',  // 默认数据库连接
    'connections' => [
        'mysql' => [
            'type'     => 'mysql',
            'hostname' => '127.0.0.1',
            'database' => 'your_database_name',
            'username' => 'your_username',
            'password' => 'your_password',
            'hostport' => '3306',
            'charset'  => 'utf8mb4',
            'prefix'   => 'think_',  // 表前缀（可选）
        ],
    ],
];

5. 设置目录权限

确保ThinkPHP项目的runtime目录（运行时文件，如缓存、日志）可写，避免权限问题。

cd /var/www/your_project  # 进入项目根目录
sudo chown -R www-data:www-data .  # 将项目所有者设为www-data（Web服务器用户）
sudo chmod -R 755 runtime          # 设置runtime目录权限为755

6. 测试数据库连接

通过ThinkPHP的命令行工具或浏览器测试数据库连接是否正常。

使用命令行测试（进入项目根目录）：
```
php think db:list  # 查看已配置的数据库连接（ThinkPHP 6.x+）
```
若配置正确，将显示数据库连接信息；若报错，需检查.env文件中的数据库信息是否正确。

7. 可选：开启断线重连（生产环境推荐）

若应用长时间运行，可能出现数据库连接断开的情况，可在config/database.php中开启断线重连：

'mysql' => [
    // ...其他配置
    'break_reconnect' => true,  // 开启断线重连
],

完成以上步骤后，ThinkPHP项目即可正常连接MySQL数据库，进行数据操作。