新标题：明显的PSR！

在 Nettuts+ 的上一课中，您了解了 PSR；但是，该文章没有详细说明将该编码风格集成到项目中的过程。让我们解决这个问题！

注意：本文假设您已阅读 PSR-Huh?，并了解 PSR 指的是什么。让我们从第一个标准开始：PSR-0。

PSR-0 - 自动加载标准

PHPCS 插件是我用过的最有用的工具。

过去，我们通过以下两种方式之一包含 PHP 文件：

• 在每个文件的顶部使用大量包含语句。
• 列出单个文件中的所有包含内容，并将该单个文件包含在您的项目中。

这两种方法各有利弊，但是，我认为我们都同意这两种方法都不是最佳或现代的解决方案。 PHP5引入了根据类名自动加载文件的概念；因此，PSR-0 旨在保持文件名一致。

命名空间与文件名或自动加载无关；从技术上讲，您可以在同一文件中声明不同的名称空间。例如，下面的代码是完全有效的。

<?php
namespace Nettuts;

Class Hello
{
    public function __construct()
    {
        echo "Nettuts+";
    }
}

namespace Gabriel;

Class Hello
{
    public function __construct()
    {
        echo "Gabriel";
    }
}

$h = new \Nettuts\Hello();
$h = new \Gabriel\Hello();

这个文件中有两个 Hello 类，但它们驻留在不同的命名空间中。此代码的最后两行在各自的命名空间上实例化 Hello() 类。第一个输出“Nettuts+”，而第二个输出“Gabriel”。命名空间允许您区分具有相同名称的两个类，就像您可能习惯于桌面上的文件夹一样。 PSR-0 标准简单地利用了命名空间的优势，使自动加载类变得容易。通过一致地命名文件，您可以创建一个自动查找必要文件的函数。

要符合 PSR-1 标准，您还必须遵循 PSR-0。

请务必阅读完整的标准，但总结一下：

• 每个类都必须以项目（或创建者）的名称命名。
• 类名称中的下划线应转换为目录分隔符。
• 文件必须具有 .php 扩展名。

例如，类引用：

\Nettuts\Database\SQL_Postgres

如果遵循 PSR-0，应转换为此路径：

./Nettuts/Database/SQL/Postgres.php

我们如何实现此功能？最明显的解决方案是使用 Composer，它附带了符合 PSR-0 标准的自动加载器。如果您在项目中使用 Composer（您应该这样做），那么请选择它的自动加载器，而不是编写自己的自动加载器。

符合 PSR-0 的加载程序允许您指定基本路径，通知加载程序首先查看哪个目录。首先，创建一个简单的 composer.json 文件，其中包含以下 JSON：

{
    "autoload": {
        "psr-0": {
            "Nettuts": "./",
            "Gmanricks": "vendor/"
        }
    }
}

这个 JSON 文件告诉 Composer 我们要使用 PSR-0 标准自动加载所有以当前目录（根文件夹）为基本路径的 Nettuts 命名空间文件。我们还希望使用 Gmanricks 命名空间自动加载相对于 vendor 文件夹的所有类（例如 ./vendor/Gmanricks/ClassName）。

现在，输入“composer install”以生成自动加载类，或在后续编辑中输入“composer dump-autoload”以重新生成自动加载类。另外，不要忘记在项目早期的某个地方需要自动加载器。

<?php

require 'vendor/autoload.php';

Composer 是您的最佳选择，但在某些情况下您可能需要一个小型、简单的自动加载器。 PHP-FIG 提供了一个可供您使用的示例自动加载器：

function __autoload($className)
{
    $className = ltrim($className, '\\');
    $fileName  = '';
    $namespace = '';
    if ($lastNsPos = strrpos($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;
}

需要注意的是，此加载器尝试加载当前目录中使用 PSR 标准的所有类。

现在我们已经成功地自动加载类了，让我们继续讨论下一个标准：基本编码标准。

PSR-1 - 基本编码标准

PSR-1 定义了通用编码指南，可以分为两部分。

命名约定

命名空间允许您区分具有相同名称的两个类。

与任何编程语言一样，遵循命名约定最终会使您的代码更易于阅读和维护。以下是一些需要遵循的规则：

• 类名称使用PascalCase。
• 方法名称应采用驼峰命名法。
• 常量要求全部大写字母，并用下划线分隔每个单词（例如 CONSTANT_VARIABLE）。

代码约定：

它不仅仅是命名约定；还请遵循以下准则：

• 仅在代码中使用 或 。不要在类中关闭 PHP。
• 文件应该声明符号或使用它们。
• PHP 代码的文件必须采用无 BOM 的 UTF-8 格式

cd ~/Library/Application\ Support/Sublime\ Text\ 2/Packages/
git clone git://github.com/benmatselby/sublime-phpcs.git Phpcs

{
    "name": "Nettuts PHPCS Demo",
    "require": {
        "squizlabs/php_codesniffer": "*",
        "fabpot/php-cs-fixer": "*",
        "phpmd/phpmd": "*"
    }
}

{
    "phpcs_additional_args": {
        "--standard": "PSR2",
        "-n": ""
    },
    "phpcs_executable_path": "DEPENDENCY_PATH/vendor/bin/phpcs",
    "phpmd_executable_path": "DEPENDENCY_PATH/vendor/bin/phpmd",
    "php_cs_fixer_executable_path": "DEPENDENCY_PATH/vendor/bin/php-cs-fixer"
}