Debian如何配置ThinkPHP数据库

最近在帮朋友配置一台Debian服务器上的ThinkPHP环境，发现数据库连接这块细节不少，踩了几个坑才跑通。索性把完整步骤整理出来，从环境准备到测试连接，一气呵成，希望也能帮到有同样需求的人。

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

1. 准备基础环境

配置数据库之前，得先确认几样东西都装好了没：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 | phpsudo mv composer.phar /usr/local/bin/composer

2. 配置Web服务器

需要把Web服务器指向ThinkPHP项目的 public 目录（入口文件 index.php 所在目录），并配置URL重写，ThinkPHP的路由功能才能正常工作。

• Nginx配置示例（编辑 /etc/nginx/sites-a vailable/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-a vailable/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数据库，进行数据操作。