CakePHP中文手册【翻译】-Cake命名规则

Cake 规则

1

规则,  ?

没错,规则。根据thefreedictionary:

1.    一般约定或者对特定的实践或态度的认可:根据规则,北方一直在地图的最上方。

2.    在一个组里,一个广泛遵守的实践或和过程,特别能促进社会交互;一种习惯:握手的规则。

3.    一种广泛被使用或被接受的设备或者技术,例如在小说,文学或者绘画里:旁白的戏剧规则。

Cake的规则会变魔法,称之为自动魔法。Cake让你的生产率提高到一个令你害怕的水平,但又不失灵活性。Cake的规则确实非常简单,而且直观。他们是从最佳实践里提炼出来的,而这些最佳实践是web开发人员在web开发领域里多年使用的实践。

2

文件名

文件名带有下划线。作为一般规则,如果你有一个MyNiftyClass类,那么在Cake里,它的文件应该命名为my_nifty_class.php。因此如果你找到一个小片段,你会自动知道:

1.    如果它是一个命名为KissesAndHugsControllerController,那么它的文件名必须为kisses_and_hugs_controller.php(注意文件名中的_controller)。

2.    如果它是一个名为OptionValueModel,那么它的文件名必须为option_value.php.

3.    如果它是一个名为MyHandyComponent的组件,那么它的文件名必须为my_handy.php(在文件名里不需要_component)

4.    如果它是一个名为BestHelperEverHelper,那么它的文件名必须为best_heler_ever.php.

3

Model

1.    Model的类名是单数

2.    Model类名中,单个单词的model为大写,多个单词的model是大写的骆驼峰。

实例: Person, Monkey, GlassDoor, LineItem, ReallyNiftyThing

3.    多对多的join表应该命名为: 按字母排列的第一个表的复数_按字母排列的第二个表的复数.例如: tags_users

4.    Model文件名使用一个小写的带有下划线的语法。

实例: person.php, monkey.php, glass_door.php, line_item.php, really_nifty_thing.php

5.    model相关联的表也使用小写的带有下划线的语法,但是他们是复数的。

实例: people, monkeys, glass_doors, line_items, really_nifty_things

CakePHP的命名规则意味着流线型的代码创建,并且让代码更加具有可读性。如果你想他遵循你的方式,你可以覆写它。

1.    Model名:在你的Model定义里设置$name变量.

2.    Model相关的数据库名:在你的Model定义里设置$useTable变量.

4

Controller

1.    Controller名为复数

2.    对于单个词的controller,类名为大写,多个词的为大写的骆驼峰。而且Controller类名以'Controller'结尾。

实例: PeopleController, MonkeysController, GlassDoorsController, LineItemsController, ReallyNiftyThingsController

3.    Controller文件名采用小写的带有下划线的语法。Controller文件名也以'_controller'结尾,因此如果你有一个名为 PostsControllerController,其文件名应该为posts_controller.php.

实例: people_controller.php, monkeys_controller.php, glass_doors_controller.php, line_items_controller.php, really_nifty_things_controller.php

4.    对于保护成员的可见性,controller动作名应该预加一个'-'.

5.    对于私有成员的可见性,controller动作名应该预加一个'--'.

5

View

1.    view在他们显示的动作后命名。

2.    在动作名后命名view,小写。

实例: PeopleController::worldPeace() 期望一个在 /app/views/people/world_peace.thtmlview MonkeysController::banana() 期望一个在/app/views/monkeys/banana.thtmlview

你可以在动作的结尾,调用$this->render('没有.thtmlview文件名')来强制一个动作render一个指定的view

6

Helper

1.    Helper的类名是骆驼峰的,并以'Helper'结尾,文件名带有下划线。
实例: /app/views/helpers/my_helper.php中类MyHelperHelper 扩展了Helper

使用var $helpers = array('Html','MyHelper')将它包含在controller;view里,你可以使用$myHelper->methods()l来访问。

7

Component

1.    组件的类名是骆驼峰的,并以'Component'结尾,文件名带有下划线。
实例:/app/controllers/components/my_component.php里,类MyComponentComponent扩展了对象。

  1.  

使用$components = array('MyComponent')将它包含在Controller里。在Controller里,使用 $this->MyComponent->method()来访问

8

Vendor

vendor不遵循任何规则,原因非常明显:他们是第三方的代码,Cake没有对它们的控制权力。

Last Updated:2006-12-05
posted @ 2006-11-30 09:56  张太国  阅读(...)  评论(...编辑  收藏