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

CakePHP中文手册【翻译】-Cake命名规则 Cake 规则第1节 规则,嗯 ? 没错，规则。根据thefreedictionary: 1. 一般约定或者对特定的实践或态度的认可：根据规则，北方一直在地图的最上方。 2. 在一个组里，一个广泛遵守的实践或和过程，特别能促进社会交互；一种习惯：握手的规则。 3. 一种广泛被使用或被接受的设备或者技术，例如在小说，文学或者绘画里：旁白的戏剧规则。 Cake的规则会变魔法，称之为自动魔法。Cake让你的生产率提高到一个令你害怕的水平，但又不失灵活性。Cake的规则确实非常简单，而且直观。他们是从最佳实践里提炼出来的，而这些最佳实践是web开发人员在web开发领域里多年使用的实践。第2节 文件名 文件名带有下划线。作为一般规则，如果你有一个MyNiftyClass类，那么在Cake里，它的文件应该命名为my_nifty_class.php。因此如果你找到一个小片段，你会自动知道：1. 如果它是一个命名为KissesAndHugsController的Controller，那么它的文件名必须为kisses_and_hugs_controller.php(注意文件名中的_controller）。 2. 如果它是一个名为OptionValue的Model，那么它的文件名必须为option_value.php. 3. 如果它是一个名为MyHandyComponent的组件，那么它的文件名必须为my_handy.php(在文件名里不需要_component) 4. 如果它是一个名为BestHelperEver的Helper，那么它的文件名必须为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结尾，因此如果你有一个名为 PostsController的Controller，其文件名应该为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.thtml的view。 MonkeysController:banana() 期望一个在/app/views/monkeys/banana.thtml的view。 你可以在动作的结尾，调用$this-render(没有.thtml的view文件名)来强制一个动作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扩展了对象。 使用$components = array(MyCo