《HongCMS开发者手册》二次开发指南.doc

《HongCMS开发者手册》--二次开发指南 模板语法参阅：/bbs/?thread-index-fid-1-tid-19.htm一、前言：说实在的，很怕写文档，特别是这种开发文档，无法知道别人需要什么样或者说什么程度的描述，自己高兴的事别人未必开心。所以，这个文档总的想法是将重点介绍清楚，让用户了解系统脉络，细枝末节的技术google就行了。前些日子因参与其它公司的项目，研究了些PHP开发框架，如CI, ThinkPHP等这些，觉得这些小型框架对我来说很不爽，因为本人一直喜欢4S的开发理念，即：Safe, Simple, Small, Stable (安全，简单，小巧，稳定)，不刻意追求大而全的东西，认为简单是最美的。这和性格有关，也很难改变。就拿CI来说吧，前台游客只要一进入网站，就有至少1个数据库写入及1个session生成，一个session在服务器就要写入一个文件，试想如果网站同时来了1万个用户访问，文件IO开销巨大，说得不好听点，服务器可能就死球了。对于框架，业内一直有这么一句话：学之者生，用之者死。本人觉得这句话很值得琢磨一下。如今没有几个公司不要求程序员有MVC的开发理念，MVC确实有好处，本人也喜欢，但也不去刻意追求. 当然也有反对MVC的, 包括PHP创始人。HongCMS开发中有V和C，M基本没有，因为不需要或者说使用M编程反而累了，但完全可以使用Model，系统框架已经为它设计好了，程序包models/目录下有实例。特别是后台admin/models/目录下的admin.php, 它就是后台用户（管理员）的模型。说白了，模型就是一些类啦。HongCMS系统框架APP.php非常小巧，仅5K大小，再加上XTpl超小模板引擎，HongCMS核心非常小巧、快速和高效。有基础的朋友，如果对HongCMS进行二次开发，或是参考其中的理念，足可以开发出大型系统来。这些思想，加上多年做双语企业网站的经验，同时有朋友要我开发一个中英双语的小型企业网站，于是HongCMS出生了。对于一些从事网站开发的朋友来说，我想HongCMS更适合成为你的工具，像很多使用weenCompany的用户能赚钱一样，使用HongCMS当然能赚钱，同时在技术上会有更大的提高。对于一般用户，HongCMS是中英文网站系统，对于懂程序的朋友来说，它是小型开发框架，开发由你。二、目录布局与重要文件介绍1. 根目录下的几个文件??? .htaccess:? 此文件是apache服务器下的伪静态规则文件，另外此文件还限制了浏览器可以访问或进入哪个目录或文件夹，增强了系统安全性。如果你添加了一个目录如blog，这个目录下独立安装了另一个blog系统，那么需要修改htaccess文件，以便允许浏览器访问blog目录。??? index.php:? HongCMS是单入口系统，所有前台页面的访问均从index.php进入。??? robots.txt:?? 此文件列举了一些目录，禁止SEO进入。基本上HongCMS除index.php文件夹都不希望SEO进入，因为SEO在其它目录或文件上抓不到有用的信息，但如果进入的话，反而可能会增加网站负担。2. Admin目录:? 后台管理目录, 里面存放的是后台管理入口文件，控制器和模型，也就是说，基本上后台管理的功能由其中的文件来完成。3.0.0版本开始， 后台管理有自己独立的入口文件index.php，同时后台管理目录可以任意修改。后台管理相当于一个独立的模块。3. Cache目录:? 此目录动态保存模板的缓存文件，一般不需要手动管理其中的文件。4. Config目录:? 系统配置目录，此目录下的config.php保存数据库连接信息等；settings.php保存网站基本设置信息，可以在后台管理中设置其中的信息，当然也可以手动直接修改其中的内容。5. Controllers目录:? 前台控制器文件目录，基本上前台的功能由此目录下的文件完成。6. Images目录:? 此目录为预留目录，在.htaccess中已经设置好了浏览器可以进入此目录，方便用户上传一些图片等，然后在文章内容中直接显示。7. Includes目录:? 此目录存放函数库文件或系统加载的核心文件，在core.php中对系统加载进行基本配置，functions.admin.php后台管理的函数库文件，mon.php前台需要使用的函数库文件，functions.global.php里面是前后台都需要使用的函数库文件。8. Install目录:? 系统安装目录，在浏览器中进入此目录安装HongCMS。9. Medels目录:? 前台模型文件目录。10. Public目录: