config/app.php是ThinkPHP 5.1应用配置主文件，定义调试开关、默认模块、URL规则等基础参数，仅在此静态设置才生效，不支持运行时覆盖。
ThinkPHP 5.1 的 app.php 是应用配置的主文件，所有基础运行参数（如调试开关、默认模块、URL 规则等）都应在此定义。它属于一级配置 app，不支持运行时动态覆盖关键项，必须静态写入该文件才生效。
app.php 的核心定位与存放位置
该文件位于 config/app.php，是框架默认加载的首要应用配置。注意：
– 不再有旧版的 config.php；
– 所有配置键名区分大小写；
– 若未指定一级配置名（如直接用 config('app_debug')），系统自动归入 app 下。
必须在 app.php 中设置的关键配置项
以下参数仅在 config/app.php 中定义才有效，控制器中调用 config() 或 Config::set() 修改会被忽略：
-
app_debug：布尔值，开启/关闭调试模式（开发必开，生产必须设为
false） -
app_trace：是否启用 Trace 面板（依赖
app_debug为 true） -
default_filter：全局输入过滤规则，如
'htmlspecialchars,strip_tags' -
pathinfo_depr：URL 路径分隔符，设为
'-'可支持/user-info-list这类风格 -
url_route_must：路由是否强制匹配，设为
true时未定义路由将报错 -
app_multi_module：是否启用多模块，设为
false可简化为单模块结构
常用实用配置示例
以下是典型 config/app.php 片段，兼顾可读性与生产安全：
立即学习“PHP免费学习笔记（深入）”；
return [
// 基础开关
'app_debug' => true,
'app_trace' => false,
'app_multi_module' => true,
// 模块与路由
'default_module' => 'index',
'empty_module' => 'index',
'url_route_must' => true,
'pathinfo_depr' => '/',
// 安全与过滤
'default_filter' => 'htmlspecialchars',
'deny_module_list' => ['runtime', 'common'],
'allow_module_list' => ['index', 'admin'],
// 其他行为
'layout_on' => false,
'template' => [
'layout_item' => '{__CONTENT__}',
],
];
说明：
– deny_module_list 和 allow_module_list 配合使用可限制可访问模块；
– layout_on 控制模板布局开关；
– 所有数组键名无需加引号（PHP 7.0+ 支持短数组语法），但值中的字符串必须用单引号或双引号包裹。
配置读取与验证技巧
开发中快速验证配置是否生效，推荐用助手函数而非门面类：
-
config('app_debug')—— 获取当前值 -
config('?app_debug')—— 返回true或false判断是否存在 -
config('app.')—— 获取整个app一级下的全部配置（慎用于线上）
若修改后无变化，请确认：
– 清理了 runtime/cache/ 下的配置缓存；
– Web 服务器指向的是 public/ 目录；
– 没有在模块配置（如 application/index/config/app.php）中同名覆盖（模块配置优先级更高）。
