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

用thinkphp开发了好些项目了；最近准备抽空写一些经验总结；希望能给刚开始接触tp的童鞋们提供一些开发的方案；少走一些弯路；少踩一些坑；这些绝对都是些精华干货；耐着性子阅读；相信收货大大的；
用thinkphp开发了好些项目了；最近准备抽空写一些经验总结；

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

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

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

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

1. thinkbjy 白俊遥博客
2. ├─Application 项目逻辑目录
3. │  ├─Common 公共模块
4. │  │  ├─Common  公共函数目录
5. │  │  │  ├─functioin.php 公共函数php文件
6. │  │  ├─Conf  公共配置文件目录
7. │  │  │  ├─config.php  tp的配置 用于覆盖框架默认配置项
8. │  │  │  ├─db.php  数据库配置 用户名 密码等
9. │  │  │  ├─webconfig.php  项目的配置；网站名；是否开启网站等
10. │  │  ├─Controller  公共控制器目录 
11. │  │  │  ├─BaseController.class.php 应用最基础的控制器
12. │  │  │  ├─HomeBaseController.class.php  Home基础控制器继承BaseController
13. │  │  │  ├─AdminBaseController.class.php  Admin基础控制器继承BaseController
14. │  │  │  ├─UserBaseController.class.php  User基础控制器继承BaseController
15. │  │  │  ├─...
16. │  │  ├─Model  公共模型目录
17. │  │  │  ├─BaseModel.class.php  应用最基础的Model
18. │  │  │  ├─ArticleModel.class.php 文章model  继承BaseModel
19. │  │  │  ├─UserModel.class.php  用户model 继承BaseModel
20. │  │  │  ├─...
21. │  │  ├─Tag  公共标签目录
22. │  │  │  ├─My.class.php  自定义的标签库
23. │  │  │  ├─...
24. │  ├─Home  Home模块
25. │  │  ├─Controller  Home控制器目录 继承HomeBaseController
26. │  │  │  ├─ArticleController.class.php 文章控制器目录  
27. │  │  │  ├─IndexController.class.php  首页控制器
28. │  │  │  ├─ ...  
29. │  ├─Admin  结构同Home
30. │  ├─User  结构同Home
31. ├─Public 资源文件目录
32. │  ├─install      安装引导目录
33. │  ├─statics      静态资源目录
34. │  │  ├─bootstrap bootstrap框架
35. │  │  ├─ueditor   ueditor编辑器
36. │  │  ├─js        jquery等第三方js存放的目录
37. │  │  ├─css       animate.css等第三方css目录
38. │  │  ├─ ...      
39. ├─Template 视图文件目录
40. │  ├─Public  公共目录
41. │  │  ├─js  公共js目录
42. │  │  │  ├─base.js 全站都引用的js文件
43. │  │  │  ├─ ...  
44. │  │  ├─css  公共css目录
45. │  │  │  ├─base.css 全站都引用的css文件  
46. │  │  │  ├─ ...  
47. │  │  ├─images 公共图片目录 
48. │  │  ├─public_head.html  全站通用的公共头部
49. │  │  ├─public_foot.html  全站通用的公共底部
50. │  │  ├─...  
51. │  ├─Home  前台Home视图目录   
52. │  │  ├─Public 前台Home的公共目录
53. │  │  │  ├─js  home下调用的js文件目录
54. │  │  │  ├─css  home下调用的css文件目录
55. │  │  │  ├─images  home下调用的图片文件目录
56. │  │  ├─Index  首页文件目录
57. │  │  │  ├─index.html 首页  
58. │  │  │  ├─ ...
59. │  ├─Admin  同Home
60. │  ├─User   同Home
61. ├─Upload  公共上传目录
62. │  ├─images   上传的图片目录
63. │  │  ├─avatar  头像目录
64. │  │  ├─ueditor ueditor编辑器上传的图片目录
65. │  │  │ ...
66. │  │ ...
67. ├─Runtime 运行时目录
68. ├─ThinkPHP 框架系统目录

复制代码

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

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

比如说 之前写过的p函数 以符合人类阅读的方式打印php数组http://www.baijunyao.com/article/20

然后还建议写：判断用户是否登陆的函数、获取当前登陆用户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； 这样这些控制器就不需要每个都判断是否是管理员了；

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


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

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

巴拉巴拉。。。

巴拉巴拉。。。

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

传送门： thinkphp的model模型的设计经验总结http://www.baijunyao.com/article/61


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

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

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

官方的文档传送门：内置标签http://document.thinkphp.cn/manual_3_2.html#inner_tag

什么？不知道怎么自定义标签？ 好吧；再来个传送门：thinkphp自定义模板标签http://www.baijunyao.com/article/21


/Public 资源文件目录

可以把boostrap、jquery等第三方插件扔到这里面


/Template 视图目录

建议把每个模块的View都移到这个目录中集中管理；不然开发的时候各种点目录切换；那酸爽；谁用谁知道；

/Template/default/Home/Public/js/base.js 和/Template/default/Home/Public/css/base.css 强烈建议全站都引用；里面写一些全站都可以用的样式或函数；比如css的reset；其他的看上面的目录就可以看明白的；就不多啰嗦了；


/Runtime 运行时目录

和Template一样；建议都移到最外层；方便我们删除缓存；