本文主要和大家分享php一些规范实例。希望能帮助到大家。制定规范时要注意：一般不要出现2个都行的情况。比如tab和4个空格都行，结果导致代码混乱。
通用原则：
1、语义化
看到名字，就知道意思。
2、通用前缀
is表示是否、get表示读、set表示写。is后面优先跟形容词，而不是名词，比如是否多语言文字，应使用is_multilingual，而不是is_multilanguage。
3、单数与复数
参考js的函数命名规则：getelementbyid、getelementsbytagname、getelementsbyname。
例如：
取我的多个好友的名字，应使用getfriendsname，而不是getfriendnames或者getfriendname
取一个用户，是getuser
取多个用户，是getusers
4、冗余后缀
尽量不使用data、list、info后缀，除非特殊情况。
比如，js的命名就很注意，使用getelementsbytagname而不是getelementsinfobytagname。
应该使用getfriends或者getfriendsuserid，而不是getfriendslist；应该使用getuser，而不使用getuserinfo或者getuserdata。
不过有时候很难避免，比如有2个函数，分别是取用户基本信息，和取用户详细信息。
取用户基本信息：昵称、头像uri，函数名getuserbasic还是getuserbasicinfo？函数名以形容词结尾感觉不合适。待讨论。讨论结果：getuserbasicinfo合适。
取用户详细信息：昵称、头像uri、签名、生日，函数名getuser没问题。
5、含义模糊的类名、文件名、目录名
每当使用common、util、functions、class、object、basic作为文件名时要慎重，由于这些词太通用，发展下去里面东西可 能越来越多，变成垃圾箱。要给这些起一个准确的名字，比如要做字符串处理的类，可以叫stringlib.php，放在lib目录里。
6、lib、plugin与addon的区别
有些类、函数算做lib、plugin还是addon。待讨论。讨论结果：目前增强函数算是lib，以后再考虑plugin和addon。
7、常用词汇
优先使用uri，而不是url。因为更严谨，新的命名开始使用uri。比如js的encodeuri，php的$_server['request_uri']。
deadline与ttl：deadline表示最后时刻，ttl表示存活时间。比如现在时间是1310449710，ttl是60秒，则deadline是1310449710 + 60 = 1310449770。
类名：
大写字母开头，驼峰命名。一般使用名词，比如配置解析类configparser，而不是parseconfig。
与java、c++一致。
例如：class usermodel
类的文件名：
与类名相同。这与php autoload有关，为了autoload，类名总要很长。待讨论。讨论结果：遵守驼峰，也能实现自动类载入。
与java一致。
例如：class usermodel的文件名为usermodel.php
非类文件名：
全小写，下划线分隔，不得使用空格。比如get_user.php。
目录名：
全小写，下划线分隔，不得使用空格。比如model、www。
函数名：
小写字母开头，驼峰命名，例如：function addblog()。
与java、c++一致。
函数表示功能，即动作，所以动词优先，例如使用editblog，而不用blogedit。
php内置函数由于历史原因，有多种风格，do_something,something_do,dosomething,比较新的函数用了dosomething，才与目前主流语言保持一致。
比如：paser_str、json_encode、substr、fetchall。
历史原因可能无法改变，但我们能保证新的代码是严谨的，不要让自己成为历史原因。
类中的函数：
两个函数中间空一行。如果有时间的话，各个函数按英文字母排序，免得太混乱。
例如：
class blogmodel
{
public function addblog()
{
}
public function updateblog()
{
}
}
文件注释：
注释紧跟<?php下一行。注明作者。@version暂不需要写，因为svn提供了版本管理。
格式按照phpdoc的要求：http://manual.phpdoc.org/htmlframesconverter/default/phpdocumentor/tutorial_tags.author.pkg.html
<?php
/**
* blog的各种业务：添加、更新
* @author sink
*
*/
class blogmodel
{
}
?>
api注释：
一定要写输入参数，和输出格式。写清楚正确时输出什么，错误时输出什么。
否则别人无法使用。
函数注释：
一定要写输出格式。写清楚正确时输出什么，错误时输出什么。
如果输入参数比较复杂，包含数组，看参数无法一目了然，则要写输入参数的注释。
文档注释与函数之间不能有空行。
如果函数内部步骤比较复杂，需要写“行内注释”。
例如：
/**
* 更新blog
* @param int $id blog_id
* @param array $data array(
"content" => "", //内容
"tags" => "", //标签
"update_time" => "", //更新时间
)
* @return bool
*/
public function updateblog($id,$data)
{
step1 //第一步：asdf
step2 //第二步：qwer
}
uri：
根据rfc1034国际标准的规定，域名中禁止出现下划线“_”，域名不区分大小写。
比如http://dl_dir.qq.com/是错误域名。
http://example.com与http://example.com相同。
所以优先在uri中使用全小写，get的name小写，但是get的值除外。
比如
http://www.google.com/?hl=zh-cn
http://www.google.com/?hl=zh-cn
uri中非参数的专有名词的缩写是否使用小写，有争议无定论。
比如
http://fedoraproject.org/zh_cn/
http://zh.wikipedia.org/zh-cn/
http://code.google.com/intl/zh-cn/
http://www.microsoft.com/en-us/
语言文字代码是专有名词，iso规定必须是减号，且建议地区使用大写。
fedora的用法很奇怪，使用了自己制造的zh_cn，而不是zh-cn。而且不建议在uri中使用下划线。
wiki用了小写，google用了大写，微软用了小写。
优先在uri中使用减号“-”，而不是下划线，get的name除外。
比如
http://example.com/1-2-2
http://example.com/?user_id=123
如果希望用户手动输入uri，则不要区分大小写，且优先使用小写，因为用户输入更方便。
实际情况是：用户一般是手动输入域名，而不手动输入uri，因为uri很长。在这种情况下，uri小写是否有意义，如果使用 http://example.com/?userid=123，变量名就可以使用驼峰$userid = $_get['userid']，就能够和java、c++保持一致，这样数据库也要驼峰命名。待讨论。讨论结果：使用?user_id=123。
变量：
全小写，下划线分隔，例如：$user_id。
与java、c++不一致。讨论结果：使用$user_id。
类的成员变量、函数的形参、类实例化成一个对象，都遵守变量的命名规则。
原因：uri、数据库有小写惯例，从$_get、$_post中获得参数入库，所以用小写。
php内置变量$_get、$_post使用下划线开头，全大写。自定义的变量无论多么重要，都不要使用下划线开头，以免将来与内置变量冲突。
比如：不要使用$_put、$_delete。
常量：
全大写，下划线分隔。例如：const memcache_ttl = 600;
php短标签：
使用<?php ?>，不使用短标签<? ?>。因为与xml冲突，且不利于部署。
类大括号换行：
可以采用大括号单独占一行，也可以大括号与别的放在一行，有争议无定论，待讨论。讨论结果：使用“同行”。
class usermodel {
}
支持换行者：
http://www.php.net/manual/zh/language.oop5.basic.php
http://pear.php.net/manual/en/standards.classdef.php
函数大括号换行：
有争议无定论，待讨论。讨论结果：使用“同行”。
function getuser() {
}
支持换行者：
http://www.php.net/manual/zh/language.oop5.basic.php
http://pear.php.net/manual/en/standards.funcdef.php
if大括号换行：
有争议无定论，待讨论。讨论结果：使用“同行”。
例如：
if(!empty($name)){
}
或者
if(!empty($name)) { //确定
}
支持换行者：
http://www.possibility.com/cpp/cppcodingstandard.html#brace
http://www.php.net/manual/zh/language.oop5.basic.php
http://pear.php.net/manual/en/standards.control.php
switch大括号换行：
讨论结果：使用“同行”。
switch (...) {
case 1:
...
break;
default:
}
支持换行者：
http://www.possibility.com/cpp/cppcodingstandard.html#switch
数组小括号换行：
有争议无定论。讨论结果：使用“同行”。
$user = array(
"id" => "123",
"name" => "user1",
"email" => "a@example.com",
)
支持同行者：
http://pear.php.net/manual/en/standards.arrays.php
数组内部换行：
2维及以上数组的数组内部换行。
如：
$user = array(
'id' => '123',
'name' => 'user1',
'email' => 'a@example.com',
);
1维数组内部不换行。讨论结果：1维数组内部不换行。
如：
$users_id = array('23','12','24');//确定
数组最后的逗号：
数组每一行最后要有逗号，这样方便以后添加。不过前端json最后不能有逗号，否则有的浏览器不支持，待讨论。讨论结果：都行，因为后端不用考虑ie前端。
比如
$user = array(
'id' => '123',
'name' => 'user1', //都行，优点：大数组，经常添加一行，方便。如果没有逗号，确实太难以添加了。
);
$user = array(
'id' => '123',
'name' => 'user1' //都行，优点：严谨，逗号表示分隔，最后一个不需要分隔。
);
单引号与双引号：
优先使用单引号，当需要转义时使用双引号，变量不放在双引号中。这与json不同，json全是双引号，待讨论。讨论结果：优先使用单引号。
比如：
echo 'name is:' . $name . '.' . "\n";
$user = array(
'id' => '123',
);
条件判断的大括号：
必须有大括号，即使只有一行。
正确：
if(!empty($name)){
dosomething();
}
错误：
if(!empty($name))
dosomething();
回车换行：
使用换行lf（\n，0a，unix风格）。不使用cr+lf（windows风格）。
参考：http://zh.wikipedia.org/zh-cn/%e6%8f%9b%e8%a1%8c
eclipse——》workspace——》new text file line delimiter——》other：unix
编码：
使用utf-8 no bom。不得使用windows记事本进行保存，因为记事本是utf-8 bom cr+lf。
eclipse——》workspace——》text file encoding——》other：utf-8
缩进：
使用4个空格进行缩进，也可以采用tab进行缩进。讨论结果：4个空格。
支持4个空格者：//确定
http://www.oracle.com/technetwork/java/codeconventions-136091.html#262
支持2个空格者：
http://google-styleguide.googlecode.com/svn/trunk/cppguide.xml#spaces_vs._tabs
支持3、4或8个空格者：
http://www.possibility.com/cpp/cppcodingstandard.html#indent
要保证缩进正确，如果使用4个空格，一定不要出现5个空格或者11个空格。
eclipse——》general——》editor——》text editors——》show whitespace characters
vim ~/.vimrc
set expandtab
set softtabstop=4
set shiftwidth=4
set autoindent
http协议缓存：
文章使用last modified表示最后修改时间，不禁止缓存。
header('last modified:sat, 30 oct 2010 13:21:21 gmt');
需要用户登录的页面，禁止缓存。
header('cache-control:max-age=0');
header('cache-control:private');
http协议编码与mime：
http输出一定要声明编码与mime。charset与分号之间要有一个空格。小写utf-8还是大写utf-8，尚未找到文档，待调研。
比如
header('content-type:application/json; charset=utf-8');
header('content-type:application/xml; charset=utf-8');
header('content-type:application/xhtml+xml; charset=utf-8');
header('content-type:text/plain; charset=utf-8');
header('content-type:text/html; charset=utf-8');
专有名词大小写：
在类、函数、文件名、目录名等各种地方，不特殊对待专有名词，不采用全大写。讨论结果：使用小写。
原因：专有名词难以界定，比如html、css、crud。而且全大写导致与驼峰冲突，比如页面助手类，全大写是htmlhelper，不如htmlhelper。
支持不特殊处理：
html是专有名词，但mime中就使用content-type:text/html，而不是text/html。
例子：
采用userdb.php，而不是userdb.php。
相关推荐：
php规范解析
以上就是php一些规范实例分享的详细内容。