PHP的PSR-0命名标准

PSR是Proposing a Standards Recommendation(提出标准建议)的缩写,是由PHP Framework Interoperability Group(PHP通用性框架小组,简称PHP-FIG)发起的,通过他们命名就可以看出,这是个主要是针对框架通用性而做努力的开放性小组,他们的在Github上有自己的仓库地址,目前只有一个被接受的标准,那就是PSR-0标准,标准定义了PHP自动加载的命名规范和文件路径规范。 针对PSR-0标准主要提到了以下几点:

要求

  • 一个完全合格的命名空间和类名必须有以下的结构“\<提供者名称>\(<命名空间>\)*<类名>”
  • 每个命名空间必须有顶级的命名空间(“提供者”)
  • 每个命名空间可以有任意多个子命名空间
  • 每个命名空间在被从文件系统加载时必须被转换为“操作系统路径分隔符”(DIRECTORY_SEPARATOR )
  • 每个“_”字符在“类名”中被转换为DIRECTORY_SEPARATOR 。“_”符号在命名空间中没有这个含义
  • 符合命名标准的命名空间和类名必须以“.php”结尾来加载文件
  • 提供商名称,命名空间,类名可以由大小写字母组成,其中命名空间和类名是大小写敏感的以保证多系统兼容性
  • 如果文件不存在需要返回false

上面说的比较难懂,看看以下:

1、PSR-0规范

[1]命名空间必须与绝对路径一致

[2]类名首字母必须大写

[3]除去入口文件外,其他“.php”必须只有一个类

[4]php类文件必须自动载入,不采用include等

[5]单一入口

例子:

\Doctrine\Common\IsolatedClassLoader => /path/to/project/lib/vendor/Doctrine/Common/IsolatedClassLoader.php
\Symfony\Core\Request => /path/to/project/lib/vendor/Symfony/Core/Request.php
\Zend\Acl => /path/to/project/lib/vendor/Zend/Acl.php
\Zend\Mail\Message => /path/to/project/lib/vendor/Zend/Mail/Message.php

扩展例子:

提供一个函数来展示如何使用上述标准。

<?php
function autoload($className)
{
    $className = ltrim($className, ‘\\‘);
    $fileName  = ‘‘;
    $namespace = ‘‘;
    if ($lastNsPos = strripos($className, ‘\\‘)) {
        $namespace = substr($className, 0, $lastNsPos);
        $className = substr($className, $lastNsPos + 1);
        $fileName  = str_replace(‘\\‘, DIRECTORY_SEPARATOR, $namespace) . DIRECTORY_SEPARATOR;
    }
    $fileName .= str_replace(‘_‘, DIRECTORY_SEPARATOR, $className) . ‘.php‘;

    require $fileName;
}

SplClassloader的实现

接下来这个gist实现了SplClassLoader可以加载你按照上面标准来实现的通用类库,这是5.3里面推荐的加载方式。

http://gist.github.com/221634

扩展实现

因为这个标准提到了如果文件不存在的时候应该范围false,但是在上面函数的例子中并没有实现该机制,所有有人实现了优化的SplClassLoader。

<?php

class ClassLoader
{
    /**
     * @var array Contains namespace/class prefix as key and sub path as value
     */
    protected $paths;

    /**
     * Construct a loader instance
     *
     * @param array $paths Containing class/namespace prefix as key and sub path as value
     */
    public function __construct( array $paths )
    {
        $this->paths = $paths;
    }

    /**
     * Load classes/interfaces following PSR-0 naming
     *
     * @param string $className
     * @return null|boolean Null if no match is found, bool if match and found/not found.
     */
    public function load( $className )
    {
        if ( $className[0] === ‘\\‘ )
            $className = substr( $className, 1 );

        foreach ( $this->paths as $prefix => $subPath )
        {
            if ( strpos( $className, $prefix ) !== 0 )
                continue;

            $lastNsPos = strripos( $className, ‘\\‘ );
            $prefixLen = strlen( $prefix ) + 1;
            $fileName = $subPath . DIRECTORY_SEPARATOR;

            if ( $lastNsPos > $prefixLen )
            {
                // Replacing ‘\‘ to ‘/‘ in namespace part
                $fileName .= str_replace(
                    ‘\\‘,
                    DIRECTORY_SEPARATOR,
                    substr( $className, $prefixLen, $lastNsPos - $prefixLen )
                ) . DIRECTORY_SEPARATOR;
            }

            // Replacing ‘_‘ to ‘/‘ in className part and append ‘.php‘
            $fileName .= str_replace( ‘_‘, DIRECTORY_SEPARATOR, substr( $className, $lastNsPos + 1 ) ) . ‘.php‘;

            if ( ( $fileName = stream_resolve_include_path( $fileName ) ) === false )
                return false;

            require $fileName;
            return true;
        }
    }
}

引用地址:https://github.com/andrerom/fig-standards/blob/psr2/proposed/PSR-2.md

写在后面

标准对于开发者来说是一个好事,如今已经越来越多的开源项目加入了这个标准Pear2、PHPBB、ComposerPackagist、Joomla、Drupal、SymfonyCakePHPDoctrine2等等,我常用的一个框架MicroMVC也在很早的时候就采用了这个标准。采用同样标准的项目可以无缝的接入,做为开发者最好要尝试并接收一个好的标准。

扩展阅读

PHP官方关于SplClassLoader的RFC:https://wiki.php.net/rfc/splclassloader PHP标准化组织论坛:https://groups.google.com/forum/?fromgroups#!forum/php-standards

原文:http://www.4wei.cn/archives/1002186

另一篇:http://www.tuicool.com/articles/Zj2Mfa

时间: 2025-01-02 18:19:13

PHP的PSR-0命名标准的相关文章

o o代码命名标准

o o 命名标准(作者:刘政鸿)     在html(id) css(图片) 本人是前端工程师,别的还没有测试哦. 中使用zt-数字-gt-数字. zt是在html中页面布局的第几块.gt是在一个页面中的第几块.块的排名按照div的从左到右,从上到下. (zt是总体 gt 是个体拼音首字母的缩写.) 加快开发速度是因为在html中插入图片你可以很块的输入.只需要复制粘贴然后更改数字.如果你用的是hbuilder(一个很快的文本编辑器)在插入的时候和修改会更加方便 加快软件维护性是因为开发人员再也

VC++6.0之标准using namespace std

最近一直在看由电子工业大学出版的吕老师编写的c<++语言程序设计(第三版)>,其中的程序代码书写我并不知道有一定的缺陷,我一直沉浸在他的书中,竟然没有再去看看其他的版本,原来新的C++已经明确提出不提倡用的一些规定这本书还在用,也是我在最近的做题陷入了一定的困境,很郁闷,后来在标准的习题中了解了一些编程代码书写规范.今天就好好学习一下标准的代码书写. 先来看看旧版的C++编程风格(就是目前我学的这本书) <font size="4"><span style

CPE命名标准 - Common Platform Enumeration

参考网站:https://nmap.org/book/output-formats-cpe.html 打开上面的网站,看第一段内容: Common Platform Enumeration (CPE) is a standardized way to name software applications, operating systems, and hardware platforms. CPE是(Common Platform Enumeration的缩写)以标准化方式为软件应用程序.操作系

html和css命名标准以及常用的框架

前端的工作很细,涉及的东西也很多,静态页面和js开发,调接口之类,有时还要自己设计.现在css管理使用less和sass,新东西起码要支持下,具体用与不用看公司的业务需求.前端人员之间的配合也很重要要有统一的文档,命名和一些规范.现在介绍一下网易的NEC,我觉得很不错.起码在命名和一些规范,动画效果上可以快速开发,代码写的快是王道我喜欢这句话.

servlet3.0 头部标准

<?xml version="1.0" encoding="UTF-8"?><web-app xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http

FIG-PHP PSR规范系列1-基础编码规范

1. FIG-PHP与PSR简介 FIG-PHP制定了一系列PHP开发规范,简称PSR,这里FIG是框架互操作工作组(Framework Interoperability Group)的简称,PSR是PHP标准推荐(PHP Standard Recommendation)的缩写.FIG-PHP工作组最初是源于项目代表讨论两个项目之间的共性时,找出可以共事的方式.主要的受众是双方项目组,但PHP界的其他人也在观望.如果其他人愿意采用这里的规范,那么欢迎,但这并非工作组的目标.工作组中没人会告诉你如

php开发规范-psr系列规范

转自:http://www.cnblogs.com/x3d/p/php-psr-standards.html PSR 是PHP Standard Recommendation的简写,它其实应该叫PSRs,即系列推荐标准:目前通过的规范有PSR-0(Autoloading Standard).PSR-1(Basic Coding Standard).PSR-2(Coding Style Guide).PSR-3(Logger Interface).PSR-4(Improved Autoloadin

前端变量命名之规则

无论是从技术角度还是开发视角,对于web前端开发规范文档都有一定规范,本文就css3和html5的发展前景总结了一系列的web开发文档,仅供大家参考. 规范目的: 为提高团队协作效率, 便于后台人员添加功能及前端后期优化维护, 输出高质量的文档, 特制订此文档. 本规范文档一经确认, 前端开发人员必须按本文档规范进行前台页面开发. 本文档如有不对或者不合适的地方请及时提出, 经讨论决定后方可更改. 基本准则: 符合web标准, 语义化html, 结构表现行为分离, 兼容性优良. 页面性能方面,

【MFC】ID命名和数字约定

ID命名和数字约定 MFC ID 命名和数字约定需要满足以下要求: 提供对 Visual C++ 资源编辑器支持的 MFC 库和 MFC 应用程序中使用的一致的 ID 命名标准. 这样就可以轻松地对程序员介绍了一种资源的类型和原点距其 ID 的. 基础 ID 之间的某些类型的密切的一对一关系. 符合已命名的 ID 的常用标准在窗口中. 分区 ID 号空间. ID 号可由程序员. MFC.窗口和 visual C++ 编辑的资源分配. 相应分区将有助于避免 ID 号的副本. ID 前缀命名约定 I