tp5配置文件的核心答案是：文件入口在项目根目录的config目录，但真正需要经常修改的配置多数集中在application/config.php和模块目录下的config.php中。搞懂加载顺序和缓存机制，比死记代码更管用，这篇文章专门解决ThinkPHP5配置上最让人头疼的问题改了不生效、数据库连不上、运行模式不对。
tp5配置文件放在哪个目录？先搞懂加载顺序
很多新手问thinkphp5配置文件在哪里，其实它比旧版ThinkPHP要分散得多，tp5采用“全局配置 + 模块配置”的双层结构，加载优先级从低到高依次是：
- 框架内置配置：位于
thinkphp/convention.php，这是默认值，一般不要动 - 全局配置：项目根目录下
config文件夹里的文件，按类型拆分 - 应用配置：
application/config.php，作用于整个应用 - 模块配置：
application/index/config.php，只作用于index模块
这个顺序意味着后加载的配置会覆盖先加载的同名配置,也就是说，模块配置拥有最高的覆盖权限，优于应用配置，应用配置又优于根目录的config目录。
实际使用场景：如果你的后台模块需要单独连接另一个数据库，不想影响前端模块，就在application/admin/config.php中覆盖数据库配置，这样前后端互不干扰。
核心配置文件逐个拆解：每个文件管什么
tp5配置文件的命名逻辑很简单,一个文件对应一个功能类别，用config()助手函数就可以在任何位置读取。
application/config.php 是主控台
这个文件管理的是应用级别的全局设置,比较关键的几个选项包括：
default_module：默认访问模块，支持修改为admin来改变入口url_route_on：是否开启路由，生产环境建议开启app_debug：调试模式开关，上线后必须设为falsedefault_timezone：默认时区，国内项目保持Asia/Shanghai即可exception_handle：自定义异常处理类，按项目需要注册
改动都属于全局行为,对每个模块都生效。
database.php 数据库配置实操
tp5数据库配置详解从来都是重点项目。application/database.php文件中需要核心关注这几个参数：
'type' => 'mysql', // 数据库类型 'hostname' => '127.0.0.1', // 服务器地址 'database' => 'demo', // 数据库名 'username' => 'root', // 用户名 'password' => '', // 密码 'hostport' => '3306', // 端口 'charset' => 'utf8mb4', // 字符集 'prefix' => 'tp_', // 表前缀 'debug' => true, // 调试模式
常见的坑有三个：表前缀填错导致SQL查询报“表不存在”，hostport写错导致连接超时，charset用utf8导致emoji存入失败，维护中重点检查这几项即可。
cache.php 和 session.php 负责性能
tp5默认文件缓存,路径在runtime/cache，如果业务量提升，需要切换为Redis，修改cache.php中的type为redis并填入host和port，Session的存储方式同理，默认存文件，多机部署时改为Redis共享才是主流做法。
thinkphp5配置缓存不更新？三步排查法
很多开发者问tp5配置文件不生效是什么原因，绝大多数情况不是改错了，而是缓存没清或者加载了错误文件。
第一步，清空runtime目录下的缓存文件，包括cache和temp文件夹里的内容，手动删除后重新访问，看配置是否生效。
第二步，用调试工具验证当前配置值，在控制器里加一行代码：
dump(config('database.hostname'));
输出当前读取到的值,对比你修改后的值，能立刻判断代码是否加载了新配置。
第三步，检查模块配置是否覆盖了全局配置，貌似改了application/config.php没变化，其实application/index/config.php里也有一份同名配置，模块级配置优先级更高，把这里改成需要的内容即可。
✍️ 实操建议：在本地开发环境，把app_debug保持为true，框架会自动检测配置变化，部署到服务器后改为false并配合php think clear命令手动清理缓存，不要依赖自动更新。
动态修改配置的常用技巧
config()函数不只能读，还能在运行时动态改配置，这个特性在处理一些临时需求时非常有用。
// 动态改变当前请求的数据库连接
config('database.hostname', '192.168.1.100');
// 读取完整配置数组
$config = config('database.');
但需要注意,动态修改只管当前请求，不写入配置文件，下次请求自动恢复原样，适合做临时切换、多租户隔离这类场景。
批量设置配置信息,使用Config::set方法配合数组，一次写入多个键值对，减少代码冗余，这些API在tp5手册和源码注释中都有完整说明，遇到不熟悉的参数直接查看框架源码中的注释是最快的路子。
生产环境上线前必须检查的5个配置项
这部分的经验来自真实项目踩坑,行业共识认为，多数安全问题出在配置文件上而非业务代码中。
- 设置
app_debug为false：调试模式打开时会暴露完整报错信息、SQL语句和文件路径，生产环境必须关闭，开发环境保持true，便于排查问题 - 数据库使用独立账号：避免用
root账号直连项目数据库，创建权限受限的业务账号，降低被注入攻击的风险 - 开启日志记录：
log配置中设置level为['error', 'sql']，只记录错误和慢查询，如果全部开启，大流量下日志文件会迅速膨胀 - 修改默认路由规则：默认模块
index很容易被扫描到，把后台模块改成不常见的名称，能少很多恶意请求 - 确保session和cache存储方式符合部署计划：多机负载均衡场景，文件存储会导致session不同步，需要在配置文件中切换为Redis
问答环节：tp5配置常见问题
tp5配置缓存目录runtime没有写入权限怎么办？
检查runtime目录权限，确保Web服务器用户可写，Linux服务器执行chmod -R 755 runtime即可解决，或调整所属用户chown www:www runtime。
配置了数据库但连接报错，如何快速定位？
先检查database.php中host和端口能否连通，使用命令行测试mysql -h 127.0.0.1 -P 3306 -u root -p，连通后检查database字段和prefix是否与真实环境一致，注意区分本地与线上库。
tp5里的配置项可以动态修改吗？
可以,通过config()函数修改的配置只在当前请求周期内生效，不写入文件，如果想要永久修改，还是直接编辑config目录下的对应文件更靠谱，修改后记得清理缓存。