ThinkPHP数据库操作失败通常因连接配置缺失或错误，可通过五种方式配置：一、config/database.php标准配置；二、Db::connect()动态传参；三、DSN字符串；四、config.php二级配置；五、SSL加密连接（MySQL专用）。
如果您在ThinkPHP项目中无法执行数据库操作，则可能是由于数据库连接配置缺失或参数错误。以下是配置数据库连接的多种方法：
一、通过 config/database.php 文件配置
此方式为最常用、最推荐的标准配置方式，适用于绝大多数项目结构，配置信息将被全局加载并默认生效。
1、打开项目根目录下的 config/database.php 文件（若不存在可手动创建）。
2、返回一个关联数组，其中必须包含 'type' 键，值为数据库驱动类型（如 'mysql'、'pgsql'、'sqlsrv'），且不可省略。
立即学习“PHP免费学习笔记（深入）”；
3、设置 'hostname' 为数据库服务器地址（支持 '127.0.0.1' 或域名）。
4、设置 'database' 为目标数据库名，该库需已存在且PHP进程有访问权限。
5、填写 'username' 和 'password'，确保账号具备对应数据库的读写权限。
6、根据实际环境补充 'hostport'（如MySQL默认为 '3306'）、'charset'（建议使用 'utf8mb4'）、'prefix'（表前缀，可为空字符串）。
二、通过 Db::connect() 方法传入数组配置
该方式实现运行时动态连接，不依赖配置文件，适合临时切换或连接外部数据库场景，每次调用均生成独立连接实例。
1、在控制器或逻辑代码中引入命名空间：use think\facade\Db;
2、定义一个关联数组，键名须与 database.php 中字段一致，例如：'type'、'hostname'、'database' 等。
3、确保数组中包含完整必要字段，缺失 'type' 将导致框架回退至默认 mysql 驱动并可能引发兼容性错误。
4、调用 Db::connect($config)，返回一个可立即执行查询的 Query 实例。
5、后续操作需基于该实例链式调用，例如：$db->name('user')->select();
三、通过 DSN 字符串方式连接
DSN（Data Source Name）方式将全部连接参数压缩为单字符串，由PDO底层直接解析，适用于快速测试或脚本类轻量场景，但可读性和维护性较低。
1、构造标准格式 DSN 字符串，形如：'mysql://username:password@hostname:port/database#charset'。
2、注意：用户名与密码中若含特殊字符（如 /、@、:），必须进行 urlencode() 编码。
3、端口号为可选项，省略时使用驱动默认端口（如 MySQL 默认 3306）。
4、字符集部分（#utf8mb4）必须紧跟数据库名后，不可加空格。
5、将该字符串作为唯一参数传入：Db::connect('mysql://root:123@127.0.0.1:3306/test#utf8mb4');
四、通过应用配置文件 config.php 定义二级配置项
该方式将数据库配置嵌套于 config.php 的自定义键下，便于多环境差异化管理或模块化隔离，避免污染主 database.php。
1、打开项目根目录或模块目录下的 config.php 文件。
2、新增一个二维配置项，例如键名为 'my_db_config'，其值为完整数据库配置数组。
3、确保该数组结构与 database.php 中完全一致，包括所有必需键（'type'、'hostname' 等）。
4、在代码中调用：Db::connect(config('my_db_config'));
5、该方式支持 ThinkPHP 的配置缓存机制，修改后需清除 runtime/cache/ 下缓存文件方可生效。
五、启用 SSL 加密连接（MySQL专用）
当数据库服务端强制要求 SSL 连接时，必须通过 PDO 原生参数透传证书路径与模式，仅靠 DSN 或基础字段无法启用加密传输。
1、确认 MySQL 服务端已启用 SSL：执行 SHOW VARIABLES LIKE '%ssl%';，检查 have_ssl 值为 YES。
2、在 database.php 对应连接配置中，添加 'params' 子数组，键名必须为 PDO 常量（如 PDO::MYSQL_ATTR_SSL_CA）。
3、证书路径必须为服务器本地绝对路径，例如：'/etc/mysql/ssl/ca.pem'，相对路径或 URL 将导致连接失败。
4、设置 PDO::MYSQL_ATTR_SSL_MODE 值为 PDO::MYSQL_ATTR_SSL_MODE_REQUIRED（内网常用）或 PDO::MYSQL_ATTR_SSL_MODE_VERIFY_CA（需校验CA）。
5、私钥文件（PDO::MYSQL_ATTR_SSL_KEY）必须无密码保护，且与证书配对；否则 PHP 进程初始化 PDO 时将抛出异常。
