2.PSR-1：基本的代码风格.pdfVIP

2.PSR-1：基本的代码风格 学习要点： 1.PSR-1 概述 2.PSR-1 编码规范 主讲教师：李炎恢 本课程属于 直播班专题 课程 本节课我们需要了解PSR-1：基本的代码风格。 一．PSR-1 概述 1.PSR-1 是最为基础的PHP 代码规范，也是最容易遵守的标准。 二．PSR-1 编码规范 1.标签风格 必须严格的把PHP 代码放在?php ?或?= ?标签中，不可以使用其它任何自定义的 标签句法。 //多行 ?php echo 多行风格 ? //单行 ?=单行风格? 2.字符编码 PHP 文件必须严格使用无BOM 的UTF-8 编码，在PHP 专用的IDE 上，设置的UTF-8 编 码基本都是无BOM 的。在文本编辑器上，UTF-8 编码有BOM 和无BOM 的选择。 3.副作用 在一个PHP 文件中应该(并不强制)只定义新的声明(包括：类、函数或常量)，或者只 书写产品的逻辑操作。不应该同时具有两种，否则将会产生副作用。 换言之：不去在直接在执行的业务操作的文件中声明类、函数和常量等，而是通过包含 文件将声明引入进来。也就是说，一个文件只做一件事，尽可能让它功能单一，而不要添加 其它的 “副作用”。 所以现在流行的开发模式为：程序入口 + 引导文件 + 自动加载 + 大量类库 + 开发 者的MVC 层。 可能产生副作用的有如下： (1).生成输出； (2).显现直接的加载文件：require 或include； (3).连接外部服务； (4).修改ini 配置； (5).抛出错误或异常； (6).修改全局或静态变量； (7).读写文件等。 //引入文件，产生了 “副作用” include conn.php; //生成输出html，产生了 “副作用” echo strong; //声明一个函数 function fnTest() { //函数主体 } 上面的代码，本身是一个函数创建的文件，却有引入文件和HTML输出的操作，产生了 两个副作用。这种构建代码的方式，是不推荐的。 //声明一个函数 function fnTest() { //函数主体 } //判断函数是否存在，不属于副作用 if (!function_exists(fnFoo)) { //声明一个函数 function fnFoo() { //函数主体 } } 如果这个页面是声明函数相关的，附加了判断函数是否存在再创建函数，这种情况下， 不算作 “副作用”。 4.命名空间和类 (1).命名空间以及类的命名必须严格遵循PSR-4(自动加载控制器规范)； (2).每个类都独立为一个文件，且命名控件至少有一个层次：顶级的组织名称(vendor name)； (3).类的命名必须遵循大写开头的驼峰是规范，比如：Test； (4).PHP5.3 及以后的版本代码必须使用正式的命名空间。 //命名空间 namespace Vendor\Model; //类 class Test { } 关于常量：类的常量所有字符必须大写，词间用下划线分割。 //常量命名规范 const PI = 3.14; const BATE_VERSION = 2.1.3; 关于属性：类的属性命名可以遵循(不做强制要求，但选择一种模式后，团队开发时必 须统一规范风格)： (1).大写开头的驼峰式($WebName)； (2).小写开头的驼峰式($webName); (3).下划线分割式($web_name); //属性命名规范 protected $WebName = 瓢城Web 俱乐部; 关于方法：方法名称必须严格符合小写开头