中文字幕av专区_日韩电影在线播放_精品国产精品久久一区免费式_av在线免费观看网站

溫馨提示×

溫馨提示×

您好,登錄后才能下訂單哦!

密碼登錄×
登錄注冊×
其他方式登錄
點擊 登錄注冊 即表示同意《億速云用戶服務條款》

PHP編碼開發規范是什么

發布時間:2020-10-29 11:40:33 來源:億速云 閱讀:131 作者:小新 欄目:編程語言

小編給大家分享一下PHP編碼開發規范是什么,希望大家閱讀完這篇文章后大所收獲,下面讓我們一起去探討吧!

這幾天看了一下阿里技術發布的一套Java開發規范《阿里巴巴Java開發手冊》,里面寫了阿里內部的Java開發規范標準,寫的很好。這套Java統一規范標準將有助于提高行業編碼規范化水平,幫助行業人員提高開發質量和效率、大大降低代碼維護成本。

看完我去搜下了一些PHP的一些開發規范標準,其中了解到了PSR規范是PHP行業中常用的一套開發標準。感嘆自己學得那么少,標準的規范這么晚才發現。

其實對于新手或者有幾年經驗的開發者來說,這些規范我們都要掌握的,很多時候我們做好這些規范,在協同開發中,能提高我們的開發質量和效率。

什么是PSR?

PSR 是 PHP Standard Recommendations 的簡寫,由 PHP FIG 組織制定的 PHP 規范,是 PHP 開發的實踐標準。

PHP編碼開發規范是什么

PHP FIG目前已表決通過了 6 套標準,已經得到大部分 PHP 框架的支持和認可。

其中已經通過的有:

  • PSR-1 基礎編碼規范
  • PSR-2 編碼風格規范
  • PSR-3 日志接口規范
  • PSR-4 自動加載規范
  • PSR-6 緩存接口規范
  • PSR-7 HTTP 消息接口規范

*注:其中PSR-0已被棄用,PSR-5還在起草中,以后再補充

這里先介紹PSR-1 基礎編碼規范

1、 概覽

PHP代碼文件 必須 以 <?php 或 <?= 標簽開始;

PHP代碼文件 必須 以 不帶 BOM 的 UTF-8 編碼;

PHP代碼中 應該 只定義類、函數、常量等聲明,或其他會產生 副作用 的操作(如:生成文件輸出以及修改 .ini 配置文件等),二者只能選其一;

命名空間以及類 必須 符合 PSR 的自動加載規范:[PSR-4]() 中的一個;

類的命名 必須 遵循 StudlyCaps 大寫開頭的駝峰命名規范;

類中的常量所有字母都 必須 大寫,單詞間用下劃線分隔;

方法名稱 必須 符合 camelCase 式的小寫開頭駝峰命名規范。

2. 文件

2.1. PHP標簽

PHP代碼 必須 使用 <?php ?> 長標簽 或 <?= ?> 短輸出標簽;

一定不可 使用其它自定義標簽。

2.2. 字符編碼

PHP代碼 必須 且只可使用 不帶BOM的UTF-8 編碼。(這點很重要)

2.3. 副作用

一份 PHP 文件中 應該 要不就只定義新的聲明,如類、函數或常量等不產生 副作用 的操作,要不就只書寫會產生 副作用 的邏輯操作,但 不該 同時具有兩者。

「副作用」(side effects) 一詞的意思是,僅僅通過包含文件,不直接聲明類、函數和常量等,而執行的邏輯操作。

「副作用」包含卻不僅限于:

  • 生成輸出
  • 直接的 require 或 include
  • 連接外部服務
  • 修改 ini 配置
  • 拋出錯誤或異常
  • 修改全局或靜態變量
  • 讀或寫文件等

以下是一個 反例,一份包含「函數聲明」以及產生「副作用」的代碼:

<?php
// 「副作用」:修改 ini 配置
ini_set('error_reporting', E_ALL);
// 「副作用」:引入文件
include "file.php";
// 「副作用」:生成輸出
echo "<html>\n";
// 聲明函數
function foo()
{
   // 函數主體部分
}

下面是一個范例,一份只包含聲明不產生「副作用」的代碼:

<?php
// 聲明函數
function foo()
{
   // 函數主體部分
}
// 條件聲明 **不** 屬于「副作用」
if (! function_exists('bar')) {
   function bar()
   {
       // 函數主體部分
   }
}

3. 命名空間和類

命名空間以及類的命名必須遵循 [PSR-4]()。

根據規范,每個類都獨立為一個文件,且命名空間至少有一個層次:頂級的組織名稱(vendor name)。

類的命名 必須 遵循 StudlyCaps 大寫開頭的駝峰命名規范。

PHP 5.3 及以后版本的代碼 必須 使用正式的命名空間。

例如:

<?php
// PHP 5.3及以后版本的寫法
namespace Vendor\Model;
class Foo
{
}

5.2.x 及之前的版本 應該 使用偽命名空間的寫法,約定俗成使用頂級的組織名稱(vendor name)如 Vendor_ 為類前綴。

<?php
// 5.2.x及之前版本的寫法
class Vendor_Model_Foo
{
}

4. 類的常量、屬性和方法

此處的「類」指代所有的類、接口以及可復用代碼塊(traits)。

4.1. 常量

類的常量中所有字母都 必須 大寫,詞間以下劃線分隔。

參照以下代碼:

<?php
namespace Vendor\Model;
class Foo
{
   const VERSION = '1.0';
   const DATE_APPROVED = '2012-06-01';
}

4.2. 屬性

類的屬性命名 可以 遵循:

  • 大寫開頭的駝峰式 ($StudlyCaps)
  • 小寫開頭的駝峰式 ($camelCase)
  • 下劃線分隔式 ($under_score)

本規范不做強制要求,但無論遵循哪種命名方式,都 應該 在一定的范圍內保持一致。這個范圍可以是整個團隊、整個包、整個類或整個方法。

4.3. 方法

方法名稱 必須 符合 camelCase() 式的小寫開頭駝峰命名規范。

看完了這篇文章,相信你對PHP編碼開發規范是什么有了一定的了解,想了解更多相關知識,歡迎關注億速云行業資訊頻道,感謝各位的閱讀!

向AI問一下細節

免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。

php
AI

积石山| 类乌齐县| 高密市| 玛多县| 乌兰察布市| 甘孜县| 惠州市| 罗源县| 芮城县| 习水县| 四平市| 蒙阴县| 台北市| 阿尔山市| 嘉鱼县| 舒城县| 德昌县| 北京市| 宁国市| 罗定市| 乃东县| 麟游县| 石河子市| 霍林郭勒市| 英德市| 宜黄县| 安陆市| 南昌县| 右玉县| 安泽县| 于田县| 陕西省| 鱼台县| 仪征市| 马龙县| 临颍县| 焉耆| 泰兴市| 宜川县| 当阳市| 清涧县|