PHP代码规范（1）-阿里云开发者社区

PHP代码规范（1）

2022-05-11 258

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

简介： PHP代码规范

为什么我们要培养自己的编码规范？

我们写代码的时候，一个好的编码规范，对我们来说能够起到很多意向不到的效果。至少会有一下的好处：

1、提高我们的编码效率。整齐划一的代码方便我们进行复制粘贴嘛！

2、提高代码的可读性。

3、显示我们专业。别人看到了我们的代码，发现整个代码的书写流程都整齐划一，瞬间逼格就上去了！

4、方便团队协同工作。大家使用同一的规范，这样就消除了五花八分的书写方式，同一协调！

编码规范包含两大块，代码规范和注释规范

其实我们所写的php脚本，其实也就是由两大块组成的，即对代码的书写、对代码的注释！不同的框架，甚至不同的公司，对这方面都会有所不同，这里只是已将之言，仅仅是对自己的书写规范进行一个总结！希望能对其他的朋友以启示

1、代码的书写规范

文件夹的命名：

文件夹同一使用小写字母。如存放控制器的文件夹，直接命名为controller即可

文件的命名：

如果是类文件的话，那么文件的命名应该同类名称保持一致，统一使用大驼峰。如Session.class.php , 对应类名称为Session，

如果是普通的工具脚本，那么统一使用小驼峰，如common.php

类名称的命名：

类名称同一使用大驼峰，Cookie类

方法名的命名：

统一使用小驼峰，一般使用动词 + 名次的形式来描述该方法的功能，如sendMessage,发送短信。

在面向对象中，遵循同样的规则，但是个别地方有所区别：

public getUserName()

protected _getTotalAmount()

private _setBlanceAmount()

变量的命名规范：

关于变量，我们需要多说几点：

1、无论在面向对象还是非面向对象的语法中，变量统一使用小驼峰，如：$workYears。

但是在面向对象中又有所不同，public 、 protected 、 private ,protected或者private属性的时候，前面加上了 _ 作为区别

public $startPosition = 1;

protected $_salaryAmount =1000;

private $_sex = 'formale';

2、如果是常量的话，统一使用大写，中间使用下划线进行分割。

define('CURRENT_SCRIPT', 'index.php');

const TRANSACTION_TYPE = 'income';

3、全局变量，使用大驼峰，前缀加上 _ ,所有的单词首字母大写。因为知道一个变量的作用域是非常重要的，所以局部变量和全局变量应该很明显的进行分开！

$_System_Config;

$_Root_Path;

缩进符

关于编码的缩进符号，我们统一使用制表符缩进！也许有的人会问为什么不适用空格缩进的呢？

原因很简单，大部分的编辑器都支持制表符等于多少个空格，而使用空格就没得调了！

运算符号

所有的两元运算符号，都应该前后使用空格进行

$name = 'zero';

$age > 18 ? 'adult' : 'children';

常见的流程语句规划

我们约定，所有的流程语句的花括号都单独占据一行。理由：如果遇到较为复杂的业务逻辑，花括号会出现很多的嵌套，这样一来我们会混淆个个对应的花括号！

1、分支语句

if($age >= 18 && $age <= 30) 
{
  echo 'young man';
}
else if($age > 30 && $age <= 60)
{
  echo 'middle aged';
}
else
{
  echo 'old man';
}
//下面这段代码高手我们一个问题，在if语句中，即使在可以不要花括号的情况下，花括号也是要写上的
if($age > 60)
{
  echo 'I am very old';
}
switch($status)
{
  case 'forbiden'：
    echo 'login forbidden';
    break;
  case 'normal':
    echo 'login in';
    break;
  default:
    echo 'status is wrong' ：
    break;
}

2、循环语句

while($condition)
{
  statesments......;
}
foreach($arrayList as $arrayKey => $arrayItem)
{
  states......;
}
do
{
  statements......;  
}
while($condition)
for($start; condition; changenumber)
{
  statements......;
}