您好,登錄后才能下訂單哦!
源文件
代碼使用<?php開頭,忽略閉合標簽?>
文件格式必須是無BOM UTF-8格式
一個文件只聲明一種類型,如class和interface不能混寫在一個源文件中
縮進
使用4個空格來縮進,IDE可以設置
行長度
每行120個字符
關鍵字
所有關鍵字均為小寫,如true、false
命名
類名為大駝峰法,如UserModel
類方法名為小駝峰法,如getUserId()
函數使用小寫字母加_組合,如get_cookie()
變量名使用小駝峰法,如$userId
常量定義為大寫字母加_組合,如IS_DEBUG
代碼注釋標簽
類文件中對類、方法、屬性進行注釋,使用@param @return @throwns
@param注釋寫出詳解,如@param string $username 用戶名
業務模塊
路由為小寫字母加_組成,如/api/get_user_info
View層負責數據展示
Controller層負責輸入參數校驗,最外層捕捉異常,調用Logic和View視圖層
Logic層負責具體業務邏輯,調用Model層,返回處理數據
Model層負責數據表查詢和關聯關系
異常類需分清功能,如ParamException表示參數錯誤,UserException表示自定義異常
異常需分類定義code,使用PHP類常量代替,如
<?php namespace app\exceptions\codes; class UserExceptionCode extends BaseExceptionCode { const NO_AUTH = 1000001; const NO_AUTH_MSG = '不具有權限'; const STATUS_EXCEPTION = 1000002; const STATUS_EXCEPTION_MSG = '狀態異常'; }
數據表文件如有Enum類型,使用PHP類常量代替,如
<?php <?php namespace app\enums; class UserEnum extends BaseEnum { const STATUS_DELETED = -1;// 已刪除 const STATUS_DISABLE = 0;// 禁用 const STATUS_ENABLE = 1;// 正常 const AUTH_GUEST = 1;// 匿名用戶 const AUTH_GENERAL_ADMIN = 2;// 普通管理員 const AUTH_SUPER_ADMIN = 3;// 超級管理員 }
其中STATUS和AUTH為數據表映射字段名
Api接口輸出,示例
{ "code" : 0, "msg" : "success", "data" : { "userId" : 100 } }
其中code與msg為必填字段,data為空的情況下不填,示例
{ "code" : 0, "msg" : "success", "data" : { "userId" : 100 } }
其它
數組,鍵為字符串時候使用單引號,只有一個鍵時候使用單行,示例
$arr = [ 'userId' => 100 ];
多個鍵時候使用多行,示例
$arr = [ 'id' => 100, 'username' => 'admin', ];
以上就是php開發規范有哪些的詳細內容,更多請關注億速云其它相關文章!
免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。