欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  后端开发

PHP代码式样

程序员文章站 2022-05-02 16:19:02
...
PHP代码样式
如果使用第三方框架,并且有提供代码样式说明,则遵循其代码样式标准,否则如下!

== 格式:

* 使用UTF-8编码

* 使用4个空格缩进,禁止使用Tab

* Unix样式换行符(LF)

* 在逗号、冒号和分号操作符使用空格

* 在 (,[ 后面、],) 前面不使用空格

* 在代码块中使用4个空格缩进

* 采用层级缩进

* 在return方法的返回值前使用空行(除非只有一行代码)以及在两个方法中使用空行区分

* 在两个大的逻辑代码段之间使用空行区分

* 保持行字数在80字以内,最多不超过120

* 使用标准的PHP标签定界,禁止使用短标签( //... ?>),对于只包含有PHP代码的文
件,禁止使用PHP结束标志("?>"),文件末尾使用注释说明"/* End of file */"

* 单行代码也必须使用分号(;)结束

== 命名:

* 文件名使用snake_case方式,禁止使用臃肿的文件名

* 变量名使用snake_case方式,禁止使用臃肿的变量名
* 禁止使用单字符做为局部变量(如$i),在for循环中除外
* 禁止使用大写字母做为全局变量,如使用大写字母,应使用SCREAMING_SNAKE_CASE方式

* 类名使用CamelCase方式,方法名使用camelCase方式(保持像HTTP,RFC,XML缩写词的大写)

* 常量名使用SCREAMING_SNAKE_CASE方式

// bad
superclass.php
SuperClass.php
superClass.php

$i = "foobar";  // 单字符变量只充许使用在for循环中
$bufferdText   // 驼峰式变量,并且意思可以再精简些
$groupid        // 两个单词之间需要下划线分开
$name_of_last_city_used // 太长

MyConstant       // 应该用下划线并且字母没有全大写
N                     // 单字符
S_C_VER           // 意思不清楚

class superclass
class superClass

function fileproperties() // 意思不清楚并且没有驼峰式命名
function fileProperties() // 意思不清楚
function getfileproperties() // 好些了,但没有驼峰式命名

// good
super_class.php

for ($i = 0; $i 

== 语法:

对于嵌入HTML中的PHP代码,对于像if, for, foreach, while等代码块,采用if: ... endif; for: ... endfor; foreach: ... endforeach;以及 while: ... endwhile;方法块

...
isLoggedIn()): // checking logged in ?>


...


== 注释:

* 文档块必须和phpDocumentor格式兼容,请参考: http://phpdoc.org/

* 避免多余的意见

/**
 * 控制器类说明信息
 */
class Controller {
    private static $instance;

    public function __construct()  {
        ...
    }

    /**
     * 函数说明信息
     */
    public static function &get_instance() {
        ...
    }

/* End of file controller.php */


== 其他:

* 保持代码简单

* 保持一致性


参考:CodeIgniter,ZendFramework,Wordpress等
http://codeigniter.com/user_guide/general/styleguide.html
http://framework.zend.com/manual/zh/coding-standard.coding-style.html
http://codex.wordpress.org/WordPress_Coding_Standards

其他
Github https://github.com/styleguide
HTML/CSS 代码样式(英文)
http://google-styleguide.googlecode.com/svn/trunk/htmlcssguide.xml
Javascript 代码样式(英文)
http://google-styleguide.googlecode.com/svn/trunk/javascriptguide.xml
Ruby 样式参见(英文) https://github.com/chneukirchen/styleguide/blob/master/RUBY-STYLE

1 楼 huawei2772 2012-02-17

网友评论

文明上网理性发言,请遵守 新闻评论服务协议

我要评论
  • PHP代码式样
  • 专题推荐

    作者信息
    PHP代码式样

    认证0级讲师

    推荐视频教程
  • PHP代码式样javascript初级视频教程
  • PHP代码式样jquery 基础视频教程
  • 视频教程分类