PHP7.1FuelPHP如何配置模块化应用架构-php教程-PHP中文网

FuelPHP 7.1 的模块化依赖框架原生机制而非 Composer，模块必须置于 fuel/app/modules/ 下并含 Module.php，需手动注册路由、autoload 和配置，无自动 DI 与跨模块依赖解析。

php7.1fuelphp如何配置模块化应用架构

PHP 7.1 下 FuelPHP 的模块化不是靠 Composer 自动加载驱动的，而是依赖框架原生的 fuel/app/modules/ 目录结构和运行时加载机制。直接套用 Laravel 或现代 PSR-4 模块方案会失败。

FuelPHP 不识别 Modules/ 或自定义 PSR-4 命名空间路径。所有模块必须严格置于 fuel/app/modules/ 内，且每个模块需包含自己的 Module.php 文件（继承 FuelCoreModule）。

错误做法：composer.json 中添加 "Modules\": "Modules/" 并期望自动加载 —— FuelPHP 启动时不读取 vendor/autoload.php，该配置无效
正确结构示例：fuel/app/modules/user/Module.php、fuel/app/modules/user/classes/controller/user.php
模块类命名空间固定为 ModuleUser（对应模块名 user），不能随意改成 AppModulesUser

FuelPHP 在启动时通过反射调用每个模块的 Module.php 中的 init() 方法，并默认尝试调用 register_autoloader() 注册该模块内的类自动加载规则。

若省略 register_autoloader()，模块内 classes/ 下的类（如 classes/model/user.php）将无法被自动识别，报错 Class 'Model_User' not found
典型写法：Autoloader::add_classes(array('Model_User' => __DIR__.'/classes/model/user.php'));
init() 中可设置 $this->config、绑定事件监听器或初始化服务，但不能执行耗时操作（如 DB 连接），否则拖慢整个应用启动

FuelPHP 不自动扫描模块路由文件。你得在 fuel/app/config/routes.php 中手动注册模块路由，否则访问 /user/login 会 404。

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

下载

启用模块路由的标准写法：Route::add('user(/:action)', array('module' => 'user', 'controller' => 'user'));
模块内路由文件（如 fuel/app/modules/user/config/routes.php）不会被自动加载，必须在主路由中 require 或用 Route::add 显式挂载
模块控制器路径固定为 fuel/app/modules/{name}/classes/controller/{name}.php，不能改成 controllers/UserController.php

FuelPHP 的 oil generate migration 默认只作用于 fuel/app，不感知模块。模块专属迁移、模型配置、连接参数都得自己组织。

模块专属 migration 文件应放在 fuel/app/modules/{name}/migrations/，并在 oil refine migrate 时用 --path 指定：oil refine migrate --path=fuel/app/modules/user/migrations
模块数据库配置不能写在 fuel/app/modules/{name}/config/db.php —— FuelPHP 不自动加载模块 config，需在 Module.php->init() 中手动 Config::load('db', true) 并 merge 配置
模型类若使用 OrmModel，必须确保其 $_table_name 和 $_connection 显式指定，避免误用主应用默认连接