鹅厂php代码规范.docx
OMG网络媒体技术部?海豹平台开发标准v1.0?
精力。而且在一致的环境下,也可以减少编码出错的时机。?
缺陷是由于每个人的标准不同,所以需要一段时间来适应和改变自己的编码风格,暂时性的降底了工作效率。从使工程长远健康的开展以及后期更高的团队工作效率来考虑暂时的工作效率降低是值得的,也是必须要经过的一个过程。标准不是工程成功的关键,但可以帮助我们在团队协作中有更高的效率并且更加顺利的完成既定的任务。???
1)?程序员可以了解任何代码,弄清程序的状况??2)?新人可以很快的适应环境??
3)?防止新接触PHP的开发出于节省时间的需要,自创一套风格并养成终生的习惯??4)?防止新接触PHP的开发一次次的犯同样的错误??5)?在一致的环境下,可以减少犯错的时机??
2?目录结构标准?
2.1?框架路径?
框架引用路径必须采用绝对路径,托管的开发、测试和正式环境必须为:?
/data/php/framework?
2.2?应用目录结构?
应用需要严格参考以下目录安排代码位置:?
webroot/?
???index.php?????????????????Web?应用入口脚本文件???
?index-test.php?????????????功能测试使用的入口脚本文件???
?assets/???????????????????包含公开的资源文件????
css/??????????????????????包含?CSS?文件????
images/??????????????????包含图片文件???
?themes/??????????????????包含应用主题?
??protected/????????????????包含受保护的应用文件?
modc??????????????????命令行脚本?
??????modc.bat???????????????Windows?下的命令行脚本?????
??modc.php??????????????命令行?PHP?脚本???????
commands/????????????包含自定义的?modc?命令??????
?components/???????????包含可重用的用户组件??????
?config/????????????????包含配置文件?????
??controllers/????????????包含控制器的类文件??????????
SiteController.php????默认控制器的类文件???????
extensions/????????????包含第三方扩展?
?messages/?????????????包含翻译过的消息(i8n相关)??????
?models/???????????????包含模型的类文件??????
?runtime/??????????????包含临时生成的文件??????
?tests/?????????????????包含测试脚本?
??????views/????????????????包含控制器的视图和布局文件?????????
?layouts/????????????包含布局视图文件?????????????
main.php????????所有视图的默认布局??
?
site/????????????????包含?site?控制器的视图文件?
?????????system/????????????包含系统视图文件
2.2.1?配置config?
存放应用配置目录,具体参考WIKI人口脚本?
2.2.2?控制器controllers?
存放控制逻辑的类目录,具体参考WIKI控制器?
2.2.3?模型models?
存放模型定义的类目录,具体参考WIKI模型
2.2.4?
视图views?
存放视图文件的目录,具体目录参考WIKI视图?2.2.5?
国际化messages?
存放国际化定义文件的目录?
2.2.6?
组件components?
存放组件的类目录,具体目录参考WIKI组件?2.2.7?
命令commands?
存放Console命令的类目录,具体目录参考WIKI之Cli使用?
2.2.8?临时目录runtime?
目录权限777,可用于存放临时生成的文件。?
2.3?路径别名?
1)?system:?表示平台框架目录,默认为/data/php/framework。?2)?webroot:?表示入口脚本文件所在的目录,一般为应用的根目录。?3)?application:?表示应用的根底目录,一般为webroot/protected。?
4)?ext:?表示包含了所有第三方扩展的目录,一般为webroot/protected/extensions。??
通过使用?Mod::getPa