HookPHP项目目录结构全解析：看懂9大目录，理清热插拔架构设计思路

HookPHP项目目录结构全解析看懂9大目录理清热插拔架构设计思路【免费下载链接】HookPHPHookPHP基于C扩展搭建内置AI编程的架构系统-支持微服务部署|热插拔业务组件-集成业务模型|权限模型|UI组件库|多模板|多平台|多域名|多终端|多语言-含常驻内存|前后分离|API平台|LUA QQ群679116380项目地址: https://gitcode.com/gh_mirrors/ho/HookPHPHookPHP 是一款基于 Yaf C 扩展搭建的 PHP 框架内置热插拔业务组件与微服务部署能力。刚拿到这个项目是不是被一堆目录搞得眼花缭乱别担心本文用9 大目录带你一图看懂 HookPHP 的目录结构10 分钟理清它的热插拔架构设计思路零基础也能快速上手。 一分钟总览9大目录结构图先把整棵目录树放在这里后文逐个拆解HookPHP/ ├── public/ # ① Web 入口目录唯一对外窗口 ├── config/ # ② 配置中心MySQL / Redis ├── app/ # ③ 应用核心大脑 │ ├── Bootstrap.php # 启动引导器 │ ├── controllers/ # ④ 全局控制器 │ ├── views/ # ⑤ 全局视图模板 │ ├── models/ # ⑥ 数据模型层 │ ├── library/ # ⑦ 基础类库Module / Hook │ ├── modules/ # ⑧ 热插拔模块区 ⭐ │ ├── plugins/ # ⑨ 插件钩子插件 │ └── services/ # 业务服务层 ├── runtime/ # 运行时目录缓存 / 日志 ├── composer.json # 依赖清单 └── hookphp.sql # 数据库初始化脚本一句话记忆public/管入口config/管配置app/管一切业务runtime/管运行痕迹。 public/ 目录唯一的 Web 入口public/是整个应用对外暴露的唯一窗口Web 服务器的根目录应指向这里。public/index.php全局唯一入口文件。它定义了APP_PATH、加载 Composer 自动加载然后创建Yaf\Application并调用bootstrap()-run()启动整个框架。robots.txt与sitemap.xml为搜索引擎准备的 SEO 文件说明项目对多平台、多站点场景的友好设计。⚙️ config/ 目录配置中心如何连接 MySQL 与 Redisconfig/只放两个配置文件但作用关键文件职责config/app.php应用配置自动扫描app/modules/下所有目录并注册为模块config/database.php数据库配置内置 MySQL 与 Redisdefault业务库 cache缓存库双连接 热插拔的第一块拼图就藏在app.php里它用glob()遍历app/modules/*意味着你新建一个模块目录它就自动被注册无需手工改任何配置。 app/ 目录应用大脑的 5 步启动流程app/是核心中的核心先看总调度员 app/Bootstrap.php。它在框架启动时依次执行 5 个初始化步骤_initLoader为Services、Extensions和每一个模块注册命名空间模块代码从此开箱即达_initPlugin注册HookPlugin钩子插件后文详述_initDatabase建立数据库连接并注入注册表_initModel初始化HookModel、ModuleModel两个模型其余_init*步骤按字母序自动执行。启动顺序、依赖注入全靠它编排是理解框架运转的钥匙。app/controllers/ 与 app/views/全局默认页面区存放不属于任何模块的全局页面app/controllers/Index.php默认首页控制器app/views/index/index.phtml默认首页视图。它们和模块内部的控制器、视图完全隔离职责清晰不越界。app/models/ 目录数据模型层DatabaseModel统一获取数据库连接app/models/Module.phpModuleModel通过关联查询hook、module_hook、module三张表得出某个钩子点上挂载了哪些已启用的模块——这是热插拔的数据底座。app/library/ 目录可复用的基础类库app/library/Module.php抽象基类Module内置install()/uninstall()/enable()/disable()四个生命周期方法统一维护数据库extensions表并暴露onInstall()等钩子供子类扩展app/library/Hook.php静态类Hook::run($key)负责执行某个钩子点上挂载的全部模块。这两个文件只有几十行却撑起了整个热插拔体系值得细读。app/plugins/ 与 app/services/钩子插件与业务服务app/plugins/Hook.phpHookPlugin继承 Yaf 插件基类在框架请求周期的7 个关键时刻routerStartup、routerShutdown、dispatchLoopStartup、preDispatch、postDispatch、dispatchLoopShutdown、preResponse自动调用Hook::run()app/services/HookService.phpServices命名空间下的业务服务层适合放置与模块解耦的可复用业务逻辑。 app/modules/ 目录热插拔组件的家核心重点这是 HookPHP 最有特色的目录一个模块 一个完整的迷你应用自带控制器、视图和模块主类。以横幅模块为例app/modules/HookBanner/ ├── HookBanner.php # 模块主类继承 Module ├── controllers/ # 模块自己的控制器Index / Api └── views/Index/ # 模块自己的视图 以 app/modules/HookBanner/HookBanner.php 为例它重写了onInstall()建ip_logs表和onUninstall()删表实现了装模块建数据、卸模块清数据的干净安装体验。旁边的HookMonitor模块同理是内置的监控组件。✨ 热插拔全流程只有三步把模块目录放入app/modules/→ 配置自动扫描注册调用模块install()安装 → 写入extensions表并执行onInstall()管理端enable()/disable()切换状态 → 钩子点即时生效或失效全程无需改动框架核心代码。️ runtime/ 目录缓存与日志的工作车间runtime/是运行期目录用于存放缓存、日志等临时产物Yaf 配置中开启了yaf.cache_config1配置缓存也会落在这里。它应该可清空、可重建并建议配置为 Web 不可访问。 热插拔架构设计思路7 个钩子点串联一切把前面的目录串起来整条链路一目了然请求进入 public/index.php ↓ Bootstrap 启动 → 注册 HookPlugin ↓ 请求周期 7 个关键时刻触发 Hook::run(钩子点) ↓ ModuleModel 查表该钩子点挂载了哪些 status1 的模块 ↓ 按 position 顺序依次执行各模块方法 ↓ 汇总输出继续下一环节钩子点定义在框架核心app/plugins/Hook.php模块与钩子点的绑定关系存在数据库里初始化脚本见 hookphp.sql所以插件的增删改本质是改数据 放目录框架本体纹丝不动——这正是热插拔架构的精髓。 快速回顾5 点记忆表#目录一句话职责1public/唯一入口对外窗口2config/模块自动扫描 双库配置3app/Bootstrap.php5 步启动总调度4app/modules/热插拔模块的家 ⭐5app/plugins/7 个钩子点的接线板看懂这 9 大目录你就掌握了 HookPHP 的骨架核心保持稳定业务全部插件化。下一步不妨照着HookBanner的结构新建一个自己的模块目录体验一次放入即注册的热插拔流程你会彻底理解这套架构的设计巧思【免费下载链接】HookPHPHookPHP基于C扩展搭建内置AI编程的架构系统-支持微服务部署|热插拔业务组件-集成业务模型|权限模型|UI组件库|多模板|多平台|多域名|多终端|多语言-含常驻内存|前后分离|API平台|LUA QQ群679116380项目地址: https://gitcode.com/gh_mirrors/ho/HookPHP创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考