PSR-1 Basic Coding Standard(译)-- 基础编码规范

时间 2019-11-16

标签 psr basic coding standard 基础编码规范栏目字符编码繁體版

原文原文链接

注:本文算是笔者对PSR规范翻译/学习笔记，以后会陆续翻译剩余的规范，可能翻译的有错误的地方，但愿读者可以指正，很是感谢.php

什么是PSR？

PSR是PHP Standards Recommendations(PHP标准建议) 的简写，是由PHP-FIG组织(PHP Framework Interop Group-PHP框架交互操做组织)提出。PHP-FIG的工做是寻找项目之间的共性，以及让开发者能更好协同工做的方式。读者可能在浏览一些PHP技术文章的时候，可能会看到PSR-1,PSR-2,PSR-4,PSR-7等，这些是PHP-FIG的标准建议，这些标准建议的命名构成是以'PSR-'+'序号'，每一个PHP_FIG标准建议都是为了解决大部分框架频繁遇到的一个特定的问题，而与此同时框架不须要本身再去重复解决问题,而是遵循PSR标准建议，采纳共享的解决方案.html

目前PSR规范有哪些?

PSR规范框架

PSR-1: Basic Coding Standard
PSR-2: Coding Style Guide
PSR-3: Logger Interface
PSR-4: Autoloader
PSR-6: Caching Interface
PSR-7: HTTP message interfaces
PSR-11: Container interface
PSR-13: Link definition interfaces
PSR-16: Common Interface for Caching Libraries

什么是 PSR-1?

原文连接:PSR-1 Basic Coding Standardide

Aims to ensure a high level of technical interoperability between shared PHP code.学习

PSR-1 就是为了可以使共享的PHP代码之间有高度的互操做性.ui

OverView (概览)

PHP文件(MUST)必须只使用<?php 和 <?= 标签.
PHP文件(MUST)必须只能使用无BOM头的UTF-8编码格式.
PHP文件(SHOULD)应该要么声明 classe，functions。constants 等等,或者 general ouput(通用输出?),改变php.ini的配置等等，可是(SHOULD Not)不该该两个都有.
命名空间和类(MUST)必需要遵循自动加载的PSR规范[PSR-0,PSR-4];
类名明明(MUST)必须以大驼峰式.
类中的常量的命名(MUST)必须为如下划线分割的大写字母.
方法名(MUST)必须为小驼峰式.

PHP Tags

PHP代码(MUST)必须使用长标签<?php ?> 或者短标签 <?= ?>;(MUST NOT)不能有其余类型的写法.编码

Character Encoding

PHP代码(MUST)必须只使用无BOM头的UTF-8编码格式.spa

Side Effects

一个PHP文件(SHOULD)必需要声明一些class,function,constant等,而且没有side effects (执行逻辑),或者(SHOULD)应该有side effects(执行逻辑),可是(SHOULD NOT)不该该两个都同时存在.翻译

'side effects'表明的就是和声明class,function,constant等不直接相关联的执行逻辑，仅仅来自这个包含的文件。code

'Side effects' 包含如下操做,但不只限于此：general output(通用输出), 'require'和'include'的使用,链接外部服务,修改php.ini的设置,触发错误或者抛出异常,修改全局或者静态变量,读取或者写入文件操做等等.

如下是一个咱们要避免的例子,就是一个具备'declarations'和side effects的PHP文件。

<?php
// side effect: change ini settings
ini_set('error_reporting', E_ALL);

// side effect: loads a file
include "file.php";

// side effect: generates output
echo "<html>\n";

// declaration
function foo()
{
    // function body
}

如下是一个是正确的例子，只包含了'declaraion'没有'side effects'.

<?php
// declaration
function foo()
{
    // function body
}

// conditional declaration is *not* a side effect
if (! function_exists('bar')) {
    function bar()
    {
        // function body
    }
}

Namespace and Class Names

This means each class is in a file by itself, and is in a namespace of at least one level: a top-level vendor name

命名空间和类(MUST)必需要遵循自动加载规范【PSR-0，PSR-4】,这意味着每一个类在一个文件中，而且至少在一个level的命名空间中:最高level的vendor名称.

类名命名必须以大驼峰式.

PHP5.3及之后版本中，写代码(MUST)必须使用正式的命名空间.

For example:

<?php
// PHP 5.3 and later:
namespace Vendor\Model;

class Foo
{
}

PHP5.2.x以及以前的版本(SHOULD)应该使用pseudo-namespacing(伪命名空间)的惯例：在类名前+'Vendor_'前缀.

<?php
// PHP 5.2.x and earlier:
class Vendor_Model_Foo
{
}

The term “class” refers to all classes, interfaces, and traits.

本文中的术语class,表明的是全部的class,interface,traits。

Constants

类中的常量(MUST)必须为如下划线分割的大写字母.
for example:

<?php
namespace Vendor\Model;

class Foo
{
    const VERSION = '1.0';
    const DATE_APPROVED = '2012-06-01';
}

Properties

对于类的属性，本文档有意省略了对属性名的命名方式.(大驼峰/小驼峰/下划线等)

不管采用什么样的命名方式(SHOULD)应该和其所在scope相一致.scope 可能为vendor级别，package级别，class级别,或者method级别.

Methods

方法名(MUST)必须声明为小驼峰式.

1. C++ Coding Standard - C++ 编程规范
2. PSR-1: 基础编码规范
3. FIG-PHP PSR规范系列1-基础编码规范
4. PRS编码规范
5. JavaScript 编码规范(Google Coding-style for JavaScript)
6. Coding Standard
7. ESLINT STANDARD 规范
8. Go编程基础—代码规范
9. C Coding Standard
10. C++ Coding Standard
更多相关文章...
• XML 编码 - XML 教程
• Eclipse 编译项目 - Eclipse 教程
• Kotlin学习（一）基本语法
• ☆基于Java Instrument的Agent实现