原文:thinkphp学习笔记5—模块化设计
1.模块结构
完整的ThinkPHP用用围绕模块/控制器/操作设计,并支持多个入口文件盒多级控制。ThinkPHP默认PATHINFO模式,如下:
http://serverName/index.php(或者其他应用入口文件)/模块/控制器/操作/[参数名/参数值...]
应用:由同一个入口文件访问的项目称为一个应用,在完整版的代码中就是Application
模块:一个应用下面可以包含多个模块,每个模块对应独立的目录,在完整版的代码中有Admin,Home,Common,Runtime四个模块
控制器:每个模块下有多个控制器,放在Controller目录里面,控制器对应一个单独的php类文件
操作:在控制器中又可以包含多个操作方法,还可以邦东某个操作类,每个操作就是URL访问的最小单元,这个有点迷惑,类不是方法,可以有返回值么?
2.模块设计
模块的目录结构如下:
Application 默认应用目录(可以设置)
├─Common 公共模块(不能直接访问)
├─Home 前台模块
├─Admin 后台模块
├─... 其他更多模块
├─Runtime 默认运行时目录(可以设置)
模块不是固定的,可以方便的删除添加,但是一般Common,Runtime两个不用删除。
在模块内部又可以包含配置,控制器,模型等目录,结构如下:
├─Module 模块目录
│ ├─Conf 配置文件目录
│ ├─Common 公共函数目录
│ ├─Controller 控制器目录
│ ├─Model 模型目录
│ ├─Logic 逻辑目录(可选)
│ ├─Service Service目录(可选)
│ ... 更多分层目录可选
│ └─View 视图目录
除了Common和Conf目录之外,其他的可以灵活的添加和删除。
Common模块是一个公共模块,访问所有模块之前都会首先加载这个公共模块下的配置文件Conf/config.php和公共函数文件Common/function.php,但是没有找到这个function.php文件,Common模块本身不能通过URL直接访问,公共模块中的其他文件可以被其他模块集成或者调用。此外公共模块的位置可以通过COMMON_PATH常量改变,在入口文件中重新定义COMMON_PATH如下:
define('COMMON_PATH','./Common/');define('APP_PATH','./Application/');require './ThinkPHP/ThinkPHP.php';
目录结构变化如下
www WEB部署目录(或者子目录)
├─index.php 入口文件
├─README.md README文件
├─Common 应用公共模块目录
├─Application 应用模块目录
├─Public 应用资源文件目录
└─ThinkPHP 框架目录
我这里不是用define('COMMON_PATH','./Common/');生成的,而是define('COMMON_PATH','Common/');去掉了前面的./,生成目录截图如下:
这样Application目录下的Common目录就没有作用了。
3.自动生成模块目录
3.2.2版本开始可以自动生成默认模块和自动生成控制器和模型,例如现在要生成一个Admin模块用于网站后台管理,可以在入口文件下面添加下面代码
// 绑定Admin模块到当前入口文件 define('BIND_MODULE','Admin'); define('APP_PATH','./Application/'); require './ThinkPHP/ThinkPHP.php';
然后刷新就可以在Application目录下面生成一个Admin目录,并且在Controller目录里面生成一个默认的控制器IndexController.Class.php文件,手册中的注释是绑定Admin模块到当前入口文件,其实这句话的具体作用是:如果没有应用下面没有Admin这个模块那么自动生成这个模块并以此模块作为入口文件,注意如果绑定的是Home这个模块,而去访问Admin这个目录就会报错的,http://Servername/thinkphp/index.php/Admin/Index,错误内容是:
无法加载控制器:Admin
还有一点,如果生成模块之后我们删除这句绑定,就没有错了,这样可以随便访问任何模块。
生成模块之后我们还可以自动在模块内生成控制器和模型文件,代码如下:
define('BIND_MODULE','Admin'); define('BUILD_CONTROLLER_LIST','Index,User,Menu');
注意这两句要一起执行,我测试发现如果开始执行第一句生成模块,再加上后面一句生成控制器的时候是不成功的,要删掉这个Admin目录,然后执行,这样会生成目录然后再Controller目录下生成控制器文件,这个有点傻瓜。
生成的控制器是继承自Think\Controller下。也可以实用命令行来生成控制器,这里我在赘述。
同样的道理也可以自动生成模型,代码如下:
define('BIND_MODULE','Admin'); define('BUILD_CONTROLLER_LIST','Index,User,Menu'); define('BUILD_MODEL_LIST','User,Menu'); define('APP_PATH','./Application/'); require './ThinkPHP/ThinkPHP.php';
同样的,不能有先后顺序,就是说这三句必须一起执行才有效,不能逐一执行。控制器继承自Think\Model
据我观察,如果没有绑定模块是会自动生成Home模块并访问这个模块的
系统默认配置中是禁止访问Common模块和Runtime模块,我们也可自己添加禁止访问的模块,代码如下:
// 设置禁止访问的模块列表 'MODULE_DENY_LIST' => array('Common','Runtime','Api'),
同样也可设置可以访问的模块和默认模块,代码如下:
'MODULE_ALLOW_LIST' => array('Home','Admin','User'), 'DEFAULT_MODULE' => 'Home',
据我观察,就算不设置默认模块,ThinkPHP也会默认生成并访问Home模块。
如果项目比较简单,还可以设置单模块,代码如下:
// 关闭多模块访问 'MULTI_MODULE' => false, 'DEFAULT_MODULE' => 'Home',
可以给相同的用用及模块绑定多个入口,不同入口文件设置不同的应用模式和绑定模块,代码如下:
// 绑定Home模块到当前入口文件 $_GET['m'] = 'Home'; define('APP_PATH','./Application/'); require './ThinkPHP/ThinkPHP.php';
这样就可以使用下面的路径来访问了http://Servername/thinkphp/home.php/Index
这个home.php里的内容和index.php内容一样,也是一个入口文件。