XAMPP运行ThinkPHP6：配置.env环境文件与多应用模式路由-php教程-PHP中文网

thinkphp 6.x 默认不自动加载 .env 文件，需在 public/index.php 中手动调用 dotenv::createimmutable()->load()；app_env 切换需配合 think\env::set()；多应用路由须显式导入并绑定域名。

xampp运行thinkphp6：配置.env环境文件与多应用模式路由

为什么 XAMPP 下 .env 文件不生效

ThinkPHP 6.x 默认不会自动加载 .env，哪怕你把它放在项目根目录（和 app/、config/ 同级），XAMPP 的 PHP 进程也完全感知不到。这不是 XAMPP 的锅，是 TP6 的设计逻辑：它把环境变量加载交给开发者显式控制。

必须在 public/index.php 中手动引入并执行 vlucas/phpdotenv：

use Dotenv\Dotenv;

// 在 require __DIR__.'/../vendor/autoload.php'; 之后、require __DIR__.'/../start.php'; 之前插入
$dotenv = Dotenv::createImmutable(__DIR__.'/..');
$dotenv->load();

常见错误：

.env 文件保存为 UTF-8 with BOM —— 会导致 Dotenv 解析失败，静默跳过，毫无报错
等号两边写了空格，比如 APP_ENV = dev → 必须写成 APP_ENV=dev
敏感值含特殊字符但没加单引号，如 DB_PASSWORD=p@ss#123 → 应写为 DB_PASSWORD='p@ss#123'

XAMPP 中 APP_ENV 切换多环境配置为何无效

设了 APP_ENV=prod 在 .env 里，不代表框架就会加载 config/prod/ 下的配置。TP6 的环境切换依赖两件事：一是 APP_ENV 的值被读取，二是这个值被传给框架内部环境管理器。

在 public/index.php 中，$dotenv->load() 之后，必须紧接着调用：

think\Env::set('APP_ENV', 'prod');

注意三点：

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

值必须小写，且严格匹配 config/ 下子目录名（prod ✅，PROD ❌，production ❌）
CLI 模式（如 php think migrate）也要在 think 入口脚本里做同样设置，不能只靠 .env
XAMPP 的 Apache 若已通过 fastcgi_param APP_ENV prod; 透传，框架会优先取服务器变量，跳过 .env 中的值

多应用模式下路由 404 的真实原因

在 XAMPP 上跑 TP6 多应用，最常卡在「访问 /admin/index/index 报 404」——不是伪静态没配好，而是路由根本没被加载。

TP6 不会扫描 app/admin/route.php，哪怕它存在且语法正确。你必须在全局路由入口 route/route.php 中显式导入：

use think\facade\Route;

Route::import('admin', 'admin'); // 第二个参数是子应用目录名，大小写敏感

关键细节：

app/ 目录必须为空（删掉原始的 controller/、model/ 等）；否则框架检测到 app/controller 就认定是单应用，think-multi-app 中间件直接失效
Route::import('admin') 写法错误——缺第二个参数会导致路径解析错乱，加载的是 app/admin/route.php 还是 app/route.php？不确定
每个新增子应用（如 api）都得追加一行 Route::import('api', 'api');，漏掉就等于该应用路由不存在

域名绑定在 XAMPP 下必须手写入口文件

config/app.php 里的 'domain_bind' => ['admin.local' => 'admin'] 在 XAMPP 环境中完全不生效。TP6 多应用的域名路由绑定，只认 public/index.php 中的 \think\App::bind()。

例如，你在 C:\xampp\apache\conf\extra\httpd-vhosts.conf 配了两个虚拟主机指向同一项目，就要在入口文件里判断 Host：

if ($_SERVER['HTTP_HOST'] === 'admin.local') {
    \think\App::bind('admin');
}
// 必须放在 \think\App::run() 之前，且不能晚于 autoload.php 加载之后

容易忽略的点：

绑定发生在请求生命周期早期，一旦绑错（比如绑成 'Admin' 而不是 'admin'），后续所有逻辑（路由、配置、中间件）都会走错应用
子应用目录名只能是小写字母+下划线（app/admin ✅，app/Admin ❌，app/admin-v2 ❌）
绑定后，URL 中的应用前缀（如 /admin/xxx）会被自动剥离，实际匹配的是 app/admin/route.php 里定义的路径部分

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！