PHP 代码规范指南

为了提高代码的可读性、可维护性和协作效率,档规定了 PHP 代码书写规范。

命名规范:

  • 类名使用 PascalCase 命名法,例如 UserManager
  • 函数和方法名使用 camelCase 命名法,例如 getUserName()
  • 变量名使用 snake_case 命名法,例如 user_name
  • 常量名使用全大写字母和下划线命名,例如 DATABASE_HOST

代码格式:

  • 使用四个空格进行缩进。
  • 每个语句独占一行。
  • 运算符前后各留一个空格。
  • 控制结构关键字后留一个空格,例如 if (condition) { ... }
  • 函数和方法的参数列表中,每个参数后留一个逗号和一个空格。

注释规范:

  • 使用 // 进行单行注释。
  • 使用 /* ... */ 进行多行注释。
  • 为所有类、函数、方法和重要变量添加注释。

其他规范:

  • 避免使用全局变量。
  • 使用异常处理机制处理错误。
  • 遵循 PSR 编码规范。

示例代码:

<?php

class UserManager
{
    private $database;

    public function __construct($database)
    {
        $this->database = $database;
    }

    public function getUserById($user_id)
    {
        // 从数据库中获取用户信息
        $user = $this->database->getById($user_id);

        return $user;
    }
}

遵循以上规范可以编写出高质量、易于维护的 PHP 代码。

doc 文件大小:52KB