thinkphp的目录结构设计经验总结

2024-12-16 技术教程

用thinkphp开发了好些项目了；最近准备抽空写一些经验总结；

希望能给刚开始接触tp的童鞋们提供一些开发的方案；少走一些弯路；少踩一些坑；

这些绝对都是些精华干货；耐着性子阅读；相信收货大大的；

可以结合git项目对照研究：http://git.oschina.net/shuaibai123/thinkphp-bjyadmin

先从thinkphp的目录架构开始吧；

thinkbjy白俊遥博客├─Application项目逻辑目录│├─Common公共模块││├─Common公共函数目录│││├─functioin.php公共函数php文件││├─Conf公共配置文件目录│││├─config.phptp的配置用于覆盖框架默认配置项│││├─db.php数据库配置用户名密码等│││├─webconfig.php项目的配置；网站名；是否开启网站等││├─Controller公共控制器目录│││├─BaseController.class.php应用最基础的控制器│││├─HomeBaseController.class.phpHome基础控制器继承BaseController│││├─AdminBaseController.class.phpAdmin基础控制器继承BaseController│││├─UserBaseController.class.phpUser基础控制器继承BaseController│││├─...││├─Model公共模型目录│││├─BaseModel.class.php应用最基础的Model│││├─ArticleModel.class.php文章model继承BaseModel│││├─UserModel.class.php用户model继承BaseModel│││├─...││├─Tag公共标签目录│││├─My.class.php自定义的标签库│││├─...│├─HomeHome模块││├─ControllerHome控制器目录继承HomeBaseController│││├─ArticleController.class.php文章控制器目录│││├─IndexController.class.php首页控制器│││├─...│├─Admin结构同Home│├─User结构同Home├─Public资源文件目录│├─install安装引导目录│├─statics静态资源目录││├─bootstrapbootstrap框架││├─ueditorueditor编辑器││├─jsjquery等第三方js存放的目录││├─cssanimate.css等第三方css目录││├─...├─Template视图文件目录│├─Public公共目录││├─js公共js目录│││├─base.js全站都引用的js文件│││├─...││├─css公共css目录│││├─base.css全站都引用的css文件│││├─...││├─p_w_picpaths公共图片目录││├─public_head.html全站通用的公共头部││├─public_foot.html全站通用的公共底部││├─...│├─Home前台Home视图目录││├─Public前台Home的公共目录│││├─jshome下调用的js文件目录│││├─csshome下调用的css文件目录│││├─p_w_picpathshome下调用的图片文件目录││├─Index首页文件目录│││├─index.html首页│││├─...│├─Admin同Home│├─User同Home├─Upload公共上传目录│├─p_w_picpaths上传的图片目录││├─avatar头像目录││├─ueditorueditor编辑器上传的图片目录│││...││...├─Runtime运行时目录├─ThinkPHP框架系统目录

/Application/Common/Common/function.php 这个作为常用公共函数文件；

平时经常用的自定义函数都可以放里面；

比如说之前写过的p函数以符合人类阅读的方式打印php数组

然后还建议写：判断用户是否登陆的函数、获取当前登陆用户id的函数、上传函数、图片处理函数、验证码函数、分页函数等等；

/Application/Common/Conf 公共配置项目录下我建议至少创建如下3个文件

config.php、db.php、webconfig.php 为什么要创建3个配置项文件呢？我来详细的讲解这三个文件的作用；

config.php里面都是系统的配置项；我们这个文件主要是用来覆盖框架默认的配置项；这个文件好理解些；

db.php 数据库的账号密码等；单独放一个文件是因为很多时候；这个文件需要根据应用安装的时候填写的数据库账号密码生成的文件；

webconfig.php 这个文件独立出来的原因同上；

/Application/Common/Controller 公共控制器目录

这个目录下一定要建一个BaseController.class.php 为了开发维护的方便我们开发要尽量避免改动框架的文件；

所以呢；为了不改动框架的Controller.class.php 我们自己建一个BaseController以后所有的Controller都继承它；

这样只要在BaseController里面写的方法；所有的控制器都继承到了；都可以用到；

但是呢；我们开发的项目可能会比较复杂；只有一个BaseController会比较杂乱；所以我们还可以根据业务需求再建AdminBaseController.class.php 可以在__construct构造函数中判断如果不是管理员；禁止访问；我们只需要所有把所有需要有管理员权限才可访问的控制器全部继承AdminBaseController；这样这些控制器就不需要每个都判断是否是管理员了；

具体可以看thinkphp集成系列之rbac的升级版auth权限管理系统demo

UserBaseController.class.php 等其他xxBaseController同样道理；比如说用户的个人中心必须是登陆状态才可访问等等；

/Application/Common/Model 公共模型目录

这个目录一定要建一个BaseModel.class.php 为什么呢？

巴拉巴拉。。。

好吧；我在组织语言的时候；发现越写越多；所以我准备单独开一片文章来写BaseModel的问题；

传送门：thinkphp的model模型的设计经验总结

/Application/Common/Tag 公共标签目录

为了方便开发；我们还是必须要建一个自定义的标签库；My.class.php

什么是标签库呢？我们会发现在模板中tp内置好多标签很好用；比如说foreach、volist、eq；

官方的文档传送门：内置标签

什么？不知道怎么自定义标签？好吧；再来个传送门：thinkphp自定义模板标签