php开发规范

180 阅读3分钟

Composer 使用

开发环境用

composer require laracasts/generators --dev

生产环境

composer install --no-dev

命名

路由:

1、使用复数形式,如:/photos/create/photos/{photo}

控制器:

1、必须使用资源的复数形式,如:类名:PhotosController,文件名:PhotosController.php

模型:

1、数据模型类名文件名必须为「单数」,如:App\Models\Photo

2、数据库表名字 必须 为「复数」,如:如:photos, my_photos

3、数据库字段名必须 为「Snake Case」,如:view_count, is_vip

4、数据库表外键 必须 为「resource_id」,如:user_id, post_id

5、数据模型变量 必须 为「resource_id」,如:$user_id, $post_id

6、当表的全名超过30字符时,可用缩写来减少表名的长度,如description,descinformation ,infoaddress , addr

7、同类数据库对象要有统一的前缀名,比如权限管理相关的表可以统一加一个前缀p_。用户表p_user;角色表p_role;组织表p_orgnization

API 设计规范

标题描述
GET获取资源,单个或多个
POST创建资源
PUT更新资源,客户端提供完整的资源数据
PATCH更新资源,客户端提供部分的资源数据
DELETE删除资源

如:

GET /issues 列出所有的 issue

GET /orgs/:org/issues 列出某个项目的 issue

GET /repos/:owner/:repo/issues/:number 获取某个项目的某个 issue

POST /repos/:owner/:repo/issues 为某个项目创建 issue

PATCH /repos/:owner/:repo/issues/:number 修改某个 issue

PUT /repos/:owner/:repo/issues/:number/lock 锁住某个 issue

DELETE /repos/:owner/:repo/issues/:number/lock 解锁某个 issue

单数与复数

1、一般情况下,在单数名词的后面加-s构成。例如:game-games,boy-boys等。

2、以s、x、sh、ch结尾的单数名词变复数,在词尾加-es构成。例如:box-boxes,bus-buses,peach-peaches,dish-dishes,city cities,baby babies,enemy enemies。

3、以o结尾,表示有生命的事物的单数名词变复数加-es;表示没有生命的事物的单数名词变复数加-s。例如:potato-potatoes,tomato-tomatoes,photo-photos,piano-pianos等。

4、以辅音字母加y结尾的单数名词变复数,将y改成i后再加-es。例如:factory-factories,story-stories,family-families。

5、以f或fe结尾的单数名词变复数,将f或fe改成v,然后再加-es。例如:leaf-leaves,life-lives,knife-knives等。

6、名词单数变复数,除了有规则可循的变化之外,还有一部分的变化是不规则的,我们将这部分名词的变化叫做不规则复数变化。

这些词有:goose geese,foot feet,tooth teech,man men,woman women,mouse mice,sheep sheep,deer deer,fish fish,child children,ox-oxen。

英语中什么是单数和复数

单数就是一个复数就是多个,单数后面不用加s而复数后面就要加s或者es。

单数就是一个比如一个苹果就用an apple ;两个或两个以上就是两个苹果用复数例如two apples。

复数指语言中与单数相对,两个及两个以上的可数名词。

元音字母和大多数除s,z,x,sh,ch之外的辅音字母(或字母组合)直接加-s,清辅音后的s读作/s/ ,元音和浊辅音后的s读作/z/。如:bag-bags,biscuit-biscuits,egg-eggs.

当单数名词结尾为se,ze,ge,ce时(其词尾辅音为/s,z,ʃ,ʒ/等),加s后读作/iz/

如vase-vases,fridge-fridges