0

0

composer安装ThinkPHP6教程_多应用模式下的目录结构与安装【指南】

尼克

尼克

发布时间:2025-12-27 15:26:55

|

868人浏览过

|

来源于php中文网

原创

Composer安装ThinkPHP6多应用项目需执行php think build生成app/admin等子目录,而非手动创建;启用app_multi=true可实现路径自动识别应用,注意命名空间、路由绑定与配置继承规则。

composer安装thinkphp6教程_多应用模式下的目录结构与安装【指南】

Composer 安装 ThinkPHP6 并启用多应用模式,不需要手动改目录或硬编码应用名——thinkphp/composer 官方包已原生支持,关键在安装后执行 php think build 生成应用骨架,而非直接复制粘贴旧项目结构。

composer create-project 正确初始化 TP6 多应用项目

ThinkPHP6 的多应用模式不是靠“新建多个 app 目录”实现的,而是通过 app 目录下的子目录(如 app/adminapp/api)被自动识别为独立应用。但默认安装只带一个 app/index,必须主动构建其余应用:

  • 运行 composer create-project topthink/think tp6-demo 拉取基础框架
  • 进入项目后,执行 php think build --config build.php(需先有 build.php 配置)
  • build.php 示例内容(放在项目根目录):
    return [
        '__file__' => [],
        'admin'    => ['controller', 'model', 'view', 'config', 'common.php'],
        'api'      => ['controller', 'model', 'config'],
    ];
  • 执行后会自动生成 app/admin/app/api/ 目录,并填充标准结构

多应用模式下入口文件与 URL 路由的关键区别

TP6 多应用不依赖子域名或二级目录式入口,所有应用共用同一个 public/index.php,区分靠 URL 中的 app 参数或路由规则:

  • 默认访问 /index.php 进入 app/index 应用
  • 显式指定应用:访问 /index.php?s=/admin/index/index 或配置路由绑定后使用 /admin
  • 若要启用「路径自动识别应用」(即访问 /admin/xxx 自动进入 admin 应用),需在 config/app.php 中开启:'app_multi' => true
  • 注意:app_multi 开启后,app 目录下每个子目录名必须合法(仅字母、数字、下划线),否则路由解析失败

常见错误:composer install 后找不到 app/admin 或报错 Class not found

这不是 Composer 安装问题,而是多应用未生成或自动加载未注册:

无限画
无限画

千库网旗下AI绘画创作平台

下载

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

  • 没运行 php think buildapp/admin 根本不存在,自然无法加载
  • 生成了目录但没更新自动加载 → 执行 composer dump-autoload -o
  • 控制器命名空间写错:多应用下控制器应为 app\admin\controller\Index,不是 app\controller\admin\Index
  • URL 访问时未传 app=admin 且未配置路由绑定 → 请求仍走默认 index 应用,找不到对应类

多应用真正的复杂点不在安装,而在路由隔离和配置继承——比如 app/admin/config/database.php 会自动合并覆盖 app/config/database.php,但中间件、事件监听器等不会自动跨应用共享,得手动在各应用的 provider.php 中注册。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
composer是什么插件
composer是什么插件

Composer是一个PHP的依赖管理工具,它可以帮助开发者在PHP项目中管理和安装依赖的库文件。Composer通过一个中央化的存储库来管理所有的依赖库文件,这个存储库包含了各种可用的依赖库的信息和版本信息。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

162

2023.12.25

什么是中间件
什么是中间件

中间件是一种软件组件,充当不兼容组件之间的桥梁,提供额外服务,例如集成异构系统、提供常用服务、提高应用程序性能,以及简化应用程序开发。想了解更多中间件的相关内容,可以阅读本专题下面的文章。

183

2024.05.11

Golang 中间件开发与微服务架构
Golang 中间件开发与微服务架构

本专题系统讲解 Golang 在微服务架构中的中间件开发,包括日志处理、限流与熔断、认证与授权、服务监控、API 网关设计等常见中间件功能的实现。通过实战项目,帮助开发者理解如何使用 Go 编写高效、可扩展的中间件组件,并在微服务环境中进行灵活部署与管理。

226

2025.12.18

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

385

2024.04.10

thinkphp性能怎么样
thinkphp性能怎么样

thinkphp 是一款高性能的 php 框架,具备缓存机制、代码优化、并行处理和数据库优化等优势。官方性能测试显示,它每秒可处理超过 10,000 个请求,实际应用中被广泛用于京东商城、携程网等大型网站和企业系统。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

358

2024.04.10

class在c语言中的意思
class在c语言中的意思

在C语言中,"class" 是一个关键字,用于定义一个类。想了解更多class的相关内容,可以阅读本专题下面的文章。

891

2024.01.03

python中class的含义
python中class的含义

本专题整合了python中class的相关内容,阅读专题下面的文章了解更多详细内容。

32

2025.12.06

discuz database error怎么解决
discuz database error怎么解决

discuz database error的解决办法有:1、检查数据库配置;2、确保数据库服务器正在运行;3、检查数据库表状态;4、备份数据;5、清理缓存;6、重新安装Discuz;7、检查服务器资源;8、联系Discuz官方支持。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

227

2023.11.20

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 13.5万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.3万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 1.0万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号