搞ThinkPHP的人，十个里有八个第一课就是连数据库。这事儿听着简单，不就是填个主机名、用户名、密码嘛，可真到了手忙脚乱的时候，报错信息能把你逼疯。我见过太多新手卡在“数据库连接失败”这行红字上，一查，密码没错，端口没错，可就是连不上。问题出在哪儿？多半是配置文件的格式或者写法没吃透。今天咱就掰开揉碎了，把ThinkPHP配置数据库这事儿聊明白，从最基础的.env文件到动态切换，再到那些容易踩的坑，一次说清楚。
先说说最常规的玩法。ThinkPHP从5.0开始，默认推荐用.env文件来管理配置，这玩意儿在项目根目录下，长得跟个隐藏文件似的，但作用可大了。你打开它，会看到类似“APPDEBUG = true”这样的键值对，数据库配置就在下面几行。写法很简单：“DBHOST=127.0.0.1”，“DBNAME=yourdatabase”，“DBUSER=root”，“DBPASS=yourpassword”。注意了，这里有个大坑：有些人习惯在配置文件里写“DBPASSWORD”，但在.env里是“DBPASS”，少写几个字母，系统直接不认账。还有那个端口，默认3306，你要是用了别的端口，比如本地装了MAMP或者宝塔改了端口，记得加一行“DBPORT=3307”，不然怎么连都是超时。
再说说数据库类型。ThinkPHP默认是MySQL，但很多人不知道，它其实也支持PostgreSQL、SQLite、SqlServer这些。你要是用SQLite，那配置就简单多了，直接写个文件路径就行，连主机和密码都省了。可你要是用PostgreSQL，得注意驱动问题，得装pgsql扩展，而且.env里的“DBTYPE”要改成“pgsql”，不然框架按MySQL的协议去连，直接报“Driver not found”。我有个朋友，项目部署在服务器上，数据库是PostgreSQL，他忘了改这个，折腾了一下午，发现就是一行代码的事，气得直拍大腿。所以，动手之前，先确认你的环境装了什么数据库。
接下来是动态配置的问题。有些人项目要上线，本地一套配置，线上另一套配置，总不能每次部署都手动改.env吧？ThinkPHP给了一个很聪明的方案：在“config/database.php”里，你可以用“env(‘DBHOST’)”这种语法去读取环境变量，然后根据不同的环境加载不同的.env文件。比如你在本地是“development.env”，服务器上是“production.env”，只要在入口文件里根据域名或IP判断一下，加载对应文件就行。这样改起来就方便多了，不用动代码，只动环境变量。我见过有些团队，干脆把配置写在服务器环境变量里，完全不写进项目文件，这样更安全，数据库密码不会泄露在代码仓库里。
说到安全，就不得不提一个很多人忽视的细节：把数据库配置提交到Git仓库。我刷GitHub的时候，经常看到有人把.env直接传上去，里面清清楚楚写着数据库密码，甚至还有阿里云、腾讯云的RDS地址。这等于把家门钥匙挂在门口，谁都能进来遛一圈。正确做法是，把.env加入“.gitignore”文件，然后提供一个“.env.example”文件，里面用占位符代替真实值，同事自己复制一份改成本地配置就行。这习惯得从第一天就养成，不然后面项目大了，密码泄露了，改都来不及。
再聊聊缓存。ThinkPHP默认会缓存配置文件，你改了.env，如果没清缓存，改了等于白改。尤其用Redis或者Memcached做缓存的时候，配置信息也会被缓存起来。我遇到过好几次，明明在.env里改了数据库密码，页面还是报旧的错误，清了半天缓存才好。解决办法很简单，每次改完配置，执行一下“php think clear”命令，把配置缓存清掉，再刷新页面就正常了。你要是用Docker部署，容器重启的时候也会重新加载配置，所以一般不会出这问题。
还有个容易忽略的点，就是数据库连接池。ThinkPHP的底层用的是PDO，默认每次请求都会建立一个新的连接，高并发下会很吃力。你可以开启连接池，但需要配置“DBPARAMS”里的PDO属性，比如“PDO::ATTRPERSISTENT => true”这样，让PDO保持持久连接。不过这个要小心，持久连接在某些环境下会出问题，比如MySQL的“waittimeout”设置太短，连接被服务器掐断，你还在用，就会报“MySQL server has gone away”。所以，要是你的项目访问量不大，别开这个，省得给自己找麻烦。
说说多数据库切换。有些项目需要同时连好几个库，比如一个业务库，一个日志库，一个缓存库。ThinkPHP支持配置多个连接，在“database.php”里可以定义多个连接组，比如“connections”数组里写两个键，一个叫“mysqlbusiness”，一个叫“mysqllog”。用的时候，在Model里指定“$connection = ‘mysqllog’”，或者用Db::connect(‘mysql_log’)来切换。这功能很实用，但配置的时候要注意，每个连接都得写全，不能只写一个数据库名，不然框架会拿默认配置去连，报错都不知道哪儿错的。
说这么多，其实配置数据库这事儿，就是个熟能生巧的活儿。第一次配置，报错了别慌，先看报错信息，再检查.env格式，再查端口和权限，八成能解决。要是实在搞不定，就去查官方文档，或者看看日志文件，里面都有详细记录。记住一个原则：配置不是写一次就完事，要当作代码一样对待，版本管理、环境隔离、安全防护，一个都不能少。下次你再遇到数据库连接问题，冷静下来，按着上面说的这些点，挨个排查，肯定能搞定。毕竟，ThinkPHP把数据库这块的配置已经做得够傻瓜了，咱也别辜负了这份苦心。
