讲师中心 微信公众号
AI工具推荐 视频效率加速

ThinkPHP 8.0手册怎么使用?多应用模式与模块化设计

酷辰小哥_5657

酷辰小哥_5657

发布时间:2026-08-09 15:51:00

|

624人浏览过

|

来源于php中文网

原创

要让ThinkPHP 8.0支持前台、后台、API三端独立运行,必须安装think-multi-app扩展、定义APP_MULTI_MODULE常量、删除app/controller、用php think app:create生成应用骨架,并配置domain_bind实现域名绑定。

thinkphp 8.0手册怎么使用?多应用模式与模块化设计

要让ThinkPHP 8.0项目真正支持前台、后台、API三端独立运行且互不干扰,必须完成多应用模式的完整开启流程——跳过任意环节,访问/admin或/api路径时就会直接报404或错误进入默认index应用。

安装并启用官方多应用扩展

进入项目根目录,执行命令安装扩展:composer require topthink/think-multi-app。

安装后框架会自动注册服务提供者;若你用的是精简版TP8或手动改过config/app.php,请打开该文件,检查providers数组末尾是否已包含\think\multi\AppServiceProvider::class。未添加会导致后续所有应用识别失效。

【不装这个扩展,整个多应用流程就无法启动】。ThinkPHP 8.0核心不内置多应用能力,这是唯一被官方认可的支撑扩展。

立即学习“PHP免费学习笔记(深入)”;

在入口文件中定义关键常量

打开public/index.php,在require __DIR__ . '/../vendor/autoload.php';这一行之前插入:

define('APP_MULTI_MODULE', true);

这个常量只在入口文件中定义才生效;在config/app.php里写'app_multi_module' => true完全无效——这是最常踩的坑。

确认没有其他地方(比如中间件或命令行脚本)重复定义该常量,否则会触发PHP致命错误。

清理单应用残留结构

执行命令删除默认控制器目录:rm -rf app/controller(Linux/macOS);Windows用户请用资源管理器直接删除该文件夹。

不要尝试保留它并新建子目录——框架检测到app/controller存在,就会强制进入单应用模式,完全忽略domain_bind等配置。

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理:站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

这一步是触发框架切换至多应用识别的关键开关,不是可选项。

生成独立应用骨架

使用ThinkPHP内置命令创建两个应用:

第一步:执行php think app:create index → 第二步:执行php think app:create admin。

执行后,app/目录下将生成app/index/和app/admin/两个子目录,每个目录内含controller/、model/、view/、route/等标准MVC子结构。

注意:不能手动新建文件夹或复制粘贴,必须用php think app:create命令生成——否则缺少初始化路由文件route.php及命名空间声明,后续路由加载会静默失败。

配置域名与应用绑定

打开config/app.php,在return数组中添加或修改以下三项:

'auto_multi_app' => true,
'app_map' => ['think' => 'admin'],
'domain_bind' => ['tp8.test' => 'index', 'admin.tp8.test' => 'admin'],

其中domain_bind是实际生效的路由分发依据:当请求Host头为admin.tp8.test时,框架自动加载app/admin/下的全部逻辑;tp8.test则指向app/index/。

【domain_bind键名必须与真实HTTP请求中的Host头完全一致,大小写敏感,不能带http://或端口】。

务必确保你的本地/etc/hosts(Linux/macOS)或C:\Windows\System32\drivers\etc\hosts(Windows)已添加对应解析:

127.0.0.1 tp8.test
127.0.0.1 admin.tp8.test

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
Docker Desktop怎么设置端口映射
Docker Desktop怎么设置端口映射

本专题聚焦Docker Desktop容器端口映射与访问配置,整理从创建容器、设置端口绑定到验证本地服务访问的操作流程。针对端口被占用、映射配置错误、容器服务无法访问等情况,也提供相应的检查方向,方便用户完成端口配置。

0

2026.11.03

Docker Desktop镜像构建教程
Docker Desktop镜像构建教程

想使用Docker Desktop将本地项目构建成Docker镜像?本专题围绕镜像构建的实际操作展开,介绍Dockerfile编写、构建命令使用、镜像标签设置和构建日志查看等内容,同时整理镜像无法生成、依赖安装失败及构建缓存异常等问题的排查思路。

0

2026.11.03

Docker Desktop容器创建指南
Docker Desktop容器创建指南

本专题聚焦Docker Desktop容器创建与运行配置,介绍通过本地镜像或远程镜像创建容器的方法,以及容器启动、终端访问、日志查看和基础管理等操作。针对端口冲突、参数配置不当、容器无法启动等情况,也整理了相应的排查方向。

0

2026.11.03

Tailwind CSS 如何制作导航栏和卡片
Tailwind CSS 如何制作导航栏和卡片

用 Tailwind CSS 制作导航栏和卡片,可先搭建语义化结构,再组合 Flex、Grid、间距、圆角与阴影类。这里整理横向导航、移动端菜单、卡片网格及悬停效果的相关文章,帮助你把常见页面组件做得清晰且适配不同屏幕。

0

2026.11.03

Tailwind CSS 响应式布局怎么写
Tailwind CSS 响应式布局怎么写

Tailwind CSS 响应式布局通常从移动端样式写起,再用 sm、md、lg 等前缀调整不同屏幕宽度下的网格、间距和导航。本专题整理断点配置、Grid 与 Flex 自适应布局及常见溢出问题,帮助你逐步完成多设备适配。

0

2026.11.03

Tailwind CSS 常用类名怎么记
Tailwind CSS 常用类名怎么记

Tailwind CSS 类名很多,先按布局、间距、文字、颜色和状态分组记忆,再通过官方文档检索具体写法。本专题结合类名排序、动态拼接失效、自定义实用类等问题,帮助你建立常用类名的速查方法。

0

2026.11.03

码上飞入口地址合集
码上飞入口地址合集

本专题汇总了码上飞(CodeFlying)的官方入口地址合集,涵盖官网主站及网页版在线使用入口,支持注册登录后直接在线体验零代码AI应用生成。同时整理了APP端下载渠道与小程序入口,助你快速访问平台,通过自然语言描述需求即可生成应用、小程序或网站。

0

2026.11.03

Uvicorn 报错与问题解决教程
Uvicorn 报错与问题解决教程

本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集,涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案,助你快速定位并解决Uvicorn运行中的各类问题。

20

2026.11.02

Uvicorn使用教程
Uvicorn使用教程

本专题汇总了Uvicorn使用教程与启动运行指南,涵盖其作为Python ASGI服务器的定位与特点,以及命令行启动(uvicorn main:app --reload)、参数配置(host/port/workers)、程序内嵌运行与Gunicorn结合部署等核心用法。同时整理了热重载调试、日志配置与生产环境部署优化等技巧,助你快速掌握Uvicorn的运行与配置。

40

2026.11.02

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn