如何在Linux上配置ThinkPHP数据库

在Linux上配置ThinkPHP框架的数据库连接，其实并没有想象中那么复杂，只要你按照正确的步骤来操作。下面我们直接进入正题，一步步拆解整个过程。

第一步：确保数据库服务器已经就绪

不管你是用MySQL还是MariaDB，首先得保证Linux服务器上已经装好了对应的数据库服务。不同发行版的包管理器命令略有差异，但核心思路是一样的。

以Ubuntu系为例：

sudo apt update
sudo apt install mysql-server

CentOS/RHEL系则用yum来安装MariaDB（也可以换成MySQL，看个人习惯）：

sudo yum install mariadb-server
sudo systemctl start mariadb
sudo systemctl enable mariadb

安装完成后，建议顺手跑一下安全脚本（sudo mysql_secure_installation），把默认的root密码、匿名用户之类的隐患处理掉，这是老手们的常规操作。

第二步：创建数据库和专用用户

数据库装好了，接下来就得为你的ThinkPHP项目准备一个独立的数据库和用户。直接在命令行里操作最干脆：

CREATE DATABASE thinkphp_db;
CREATE USER 'thinkphp_user'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON thinkphp_db.* TO 'thinkphp_user'@'localhost';
FLUSH PRIVILEGES;

密码请务必换成一个足够复杂的字符串，别直接复制粘贴“your_password”。如果习惯用phpMyAdmin之类的图形工具，效果一样，无非是多点几下鼠标。

第三步：修改ThinkPHP的配置文件

核心环节来了。ThinkPHP支持两种配置方式：大部分新版项目用.env文件，也可以用config/database.php。两者选其一即可，推荐优先用.env，因为它和环境解耦，方便不同环境切换。

如果是.env文件（位于项目根目录），添加或修改以下内容：

DB_TYPE=mysql
DB_HOST=127.0.0.1
DB_NAME=thinkphp_db
DB_USER=thinkphp_user
DB_PWD=your_password
DB_PORT=3306
DB_PREFIX=

如果使用的是config/database.php，则找到对应的数组配置项，改成：

return [
    'type'     => 'mysql',
    'hostname' => '127.0.0.1',
    'database' => 'thinkphp_db',
    'username' => 'thinkphp_user',
    'password' => 'your_password',
    'hostport' => '3306',
    // 其他参数按需保留
];

注意：数据库主机地址这里填127.0.0.1还是localhost，取决于你的数据库是否允许socket连接。一般来说127.0.0.1更稳妥。

第四步：写个脚本测试连接是否通畅

配置改完了，但不代表万事大吉。强烈建议先写一个测试脚本，确认数据库能真正连上。在项目根目录创建test_db.php，内容如下：

select();
    print_r($result);
} catch (think\db\exception\DataNotFoundException $e) {
    echo $e->getMessage();
} catch (think\db\exception\ModelNotFoundException $e) {
    echo $e->getMessage();
} catch (think\exception\DbException $e) {
    echo $e->getMessage();
}

把your_table_name换成你数据库中实际存在的表名（没有的话就先建一个简单的测试表）。然后在浏览器里访问这个脚本，或者用命令行php test_db.php执行。如果看到查询结果或者明确的错误信息，就知道问题出在哪了——绝大多数连接失败都是因为用户名、密码、主机地址填写有误，或者是数据库没开远程访问（本地连接不受影响）。

第五步：启动项目，正常开发

确认数据库连接没问题之后，就可以用之前熟悉的命令启动ThinkPHP项目了。比如：

php run start

或者根据你的项目路由配置，用其他方式访问。至此，数据库配置就算完整搞定了。

最后提醒一句：以上步骤假设你已经通过Composer安装好了ThinkPHP框架，并且项目根目录下vendor/autoload.php是正常可用的。如果你的环境比较特殊（比如用的是旧版ThinkPHP或者自定义加载路径），那就要根据实际情况微调。不过大部分常见场景下，按这个流程走不会出什么岔子。