목차
PSR-0 - 自动加载标准
PSR-1 - 基本编码标准
命名约定
代码约定:
PSR-2 - 高级编码标准
PHPCS - PHP 代码嗅探器
结论
백엔드 개발 PHP 튜토리얼 새 타이틀: 명백한 PSR!

새 타이틀: 명백한 PSR!

Aug 27, 2023 pm 09:41 PM
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。
  • 文件应该声明符号或使用它们。
  • PHP 代码的文件必须采用无 BOM 的 UTF-8 格式

其中大部分都是不言自明的,但中间的约定有点令人困惑。它本质上规定任何声明,无论是函数、类等,都应该分离到它们自己的文件中。这不仅促进了代码重用和分离等最佳实践,而且使您的代码保持整洁。

值得一提的是,每个 PSR 标准都建立在之前的 PSR 标准之上。因此,要符合 PSR-1,您还必须遵循 PSR-0。通过遵循这两个标准,您的代码将被正确命名并自动加载。确实没有理由不关注他们。

是的,一些开发人员抱怨 PSR 并更喜欢遵循其他约定,但通过遵循此标准,您可以与所有人共享代码,而不必担心其一致性。话虽如此,没有人强迫你这么做。这只是一个推荐指南。

下一个标准 PSR-2 深入探讨了如何构建代码的细节。


PSR-2 - 高级编码标准

PSR-2 深入探讨了如何构建代码的细节。

接下来,我们来看看 PHP 开发人员最难解决的一个标准:事实上,这就是我选择写这篇文章的原因。

PSR-2 定义了许多规则,其中许多规则如下:

  • 应使用四个空格而不是制表符。
  • 理想的行长度应低于 80 个字符,但所有行都应施加 120 个字符的软限制。
  • namespaceuse 声明下应有一个空行。
  • 方法或类的左大括号必须独占一行。
  • 方法或类的右大括号必须紧接在正文之后。
  • 所有属性和方法都需要可见性级别。
  • abstract”/“final”关键字应出现在可见性之前,而“static”则出现在可见性之后。
  • 控制结构关键字后必须跟一个空格。
  • 控制语句的左大括号应与语句出现在同一行。

请务必查看整个规范以获得完整的概述。

PSR-2 与 PSR-1(和 PSR-0)一样重要。它的目的是使代码易于阅读和维护。但是,正如他们所说,“细节决定成败。”有很多细节需要记住,如果您的编程习惯与标准定义的不同,那么记住这些细节可能会很困难。值得庆幸的是,如果您同意,有一些工具可以帮助您遵守 PSR-0、PSR-1 和 PSR-2。也许最好的工具是 Sublime Text 插件 PHPCS。


PHPCS - PHP 代码嗅探器

PHPCS 插件是我用过的最有帮助的工具,对于让代码成型。它不仅可以让您确保您的代码遵循 PSR 标准,还可以使用 PHP 的 linter 检查语法错误。这非常节省时间;在浏览器中测试代码时,您不必再担心语法错误。

通过 Sublime Package Control(称为 Phpcs)安装包,或者使用 Git,使用以下命令安装包:

cd ~/Library/Application\ Support/Sublime\ Text\ 2/Packages/
git clone git://github.com/benmatselby/sublime-phpcs.git Phpcs
로그인 후 복사

这将安装插件,但您需要一些依赖项才能配置 PHPCS。再次强调,最简单的安装方法是使用 Composer。浏览到您选择的目录并使用以下 JSON 创建 composer.json 文件:

{
    "name": "Nettuts PHPCS Demo",
    "require": {
        "squizlabs/php_codesniffer": "*",
        "fabpot/php-cs-fixer": "*",
        "phpmd/phpmd": "*"
    }
}
로그인 후 복사

这会将三个依赖项安装到当前文件夹中。打开一个终端窗口到您的安装位置并输入 composer install,它将下载必要的软件包。

现在您可以在 Sublime Text 中配置插件了。导航到“首选项”>“包设置”>“PHP 代码嗅探器”>“设置 - 用户”。

새 타이틀: 명백한 PSR!

插件需要知道三个依赖项所在的位置,以及我们希望代码遵守的标准:

{
    "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"
}
로그인 후 복사

这些设置告知 PHPCS 我们希望遵守 PSR2 标准并提供每个依赖项的路径。不要忘记将 DEPENDENCY_PATH 替换为您的实际路径。

重新启动 Sublime,代码嗅探器将在您保存 PHP 文件时扫描您的代码。

새 타이틀: 명백한 PSR!

在编辑器中右键单击还将列出几个新选项,例如清除错误标记和尝试修复非标准问题。但是,考虑到本文的目的是让您习惯该标准,我建议手动修复您的代码并避免使用自动修复程序功能。


结论

创建 PSR 标准是为了使代码可以轻松地在项目之间重用,而无需牺牲代码风格的一致性。虽然一开始可能会感到不知所措,但您可以使用本文中的想法和工具来帮助您完成过渡。

最后重申一次:没有人强迫您改变 PHP 编码的方式。它只是一个指南,最初是为了框架互操作性。也就是说,在 Nettuts+,我们认为这是值得遵循的最佳实践。现在你自己拿主意吧!如果您有任何疑问,请在下面听听!

위 내용은 새 타이틀: 명백한 PSR!의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!

본 웹사이트의 성명
본 글의 내용은 네티즌들의 자발적인 기여로 작성되었으며, 저작권은 원저작자에게 있습니다. 본 사이트는 이에 상응하는 법적 책임을 지지 않습니다. 표절이나 침해가 의심되는 콘텐츠를 발견한 경우 admin@php.cn으로 문의하세요.

핫 AI 도구

Undresser.AI Undress

Undresser.AI Undress

사실적인 누드 사진을 만들기 위한 AI 기반 앱

AI Clothes Remover

AI Clothes Remover

사진에서 옷을 제거하는 온라인 AI 도구입니다.

Undress AI Tool

Undress AI Tool

무료로 이미지를 벗다

Clothoff.io

Clothoff.io

AI 옷 제거제

AI Hentai Generator

AI Hentai Generator

AI Hentai를 무료로 생성하십시오.

뜨거운 도구

메모장++7.3.1

메모장++7.3.1

사용하기 쉬운 무료 코드 편집기

SublimeText3 중국어 버전

SublimeText3 중국어 버전

중국어 버전, 사용하기 매우 쉽습니다.

스튜디오 13.0.1 보내기

스튜디오 13.0.1 보내기

강력한 PHP 통합 개발 환경

드림위버 CS6

드림위버 CS6

시각적 웹 개발 도구

SublimeText3 Mac 버전

SublimeText3 Mac 버전

신 수준의 코드 편집 소프트웨어(SublimeText3)

Lumen 마이크로프레임워크에서 PSR2 및 PSR4 사양 적용 및 홍보 Lumen 마이크로프레임워크에서 PSR2 및 PSR4 사양 적용 및 홍보 Oct 15, 2023 am 11:21 AM

Lumen 마이크로프레임워크에서 PSR2 및 PSR4 사양의 적용 및 홍보 소개: PHP 언어의 광범위한 적용 및 개발로 인해 코드 사양은 코드 품질과 가독성을 유지하는 데 중요한 측면이 되었습니다. PHPFIG(PHPFIG, PHPFrameworkInteropGroup)는 PHP 개발에 대한 일련의 모범 사례 사양(PSR, PHPStandardsRecommendations)을 만들었으며 그 중 PSR2 및 PSR이 포함됩니다.

새 타이틀: 명백한 PSR! 새 타이틀: 명백한 PSR! Aug 27, 2023 pm 09:41 PM

Nettuts+의 이전 강의에서 PSR에 대해 배웠지만 이 기사에서는 이 코딩 스타일을 프로젝트에 통합하는 과정을 자세히 설명하지 않았습니다. 이 문제를 해결해 봅시다! 참고: 이 기사에서는 귀하가 PSR-Huh?를 읽고 PSR이 무엇을 의미하는지 이해했다고 가정합니다. 첫 번째 표준인 PSR-0부터 시작하겠습니다. PSR-0 - Autoload Standard PHPCS 플러그인은 제가 사용해 본 도구 중 가장 유용한 도구입니다. 과거에는 두 가지 방법 중 하나로 PHP 파일을 포함시켰습니다. 즉, 각 파일 상단에 많은 include 문을 사용하는 것입니다. 단일 파일에 모든 포함 항목을 나열하고 해당 단일 파일을 프로젝트에 포함합니다. 두 접근 방식 모두 장단점이 있습니다. 하지만 둘 다 최선이거나 현대적인 솔루션은 아니라는 데 모두 동의할 수 있을 것 같습니다.

CodeIgniter 개발에서 PSR2 및 PSR4 사양의 홍보 및 실행 CodeIgniter 개발에서 PSR2 및 PSR4 사양의 홍보 및 실행 Oct 15, 2023 am 11:25 AM

CodeIgniter 개발에서 PSR2 및 PSR4 사양의 홍보 및 실행 소개: CodeIgniter 개발 프로세스에서 코딩 사양을 따르는 것은 중요한 측면입니다. 그중 PSR2 및 PSR4 사양은 PHP 커뮤니티에서 널리 채택되는 표준으로, 코딩 스타일을 통합하고 팀 협업 효율성을 향상시키는 데 도움이 됩니다. 이 기사에서는 CodeIgniter 프로젝트에서 이 두 가지 사양을 홍보하고 실행하는 방법을 소개하고 구체적인 코드 예제를 제공합니다. 1. PSR2 및 PSR4 사양 PSR2란 무엇입니까?

Fat-Free 프레임워크에서 PSR2 및 PSR4 사양 적용 및 홍보 Fat-Free 프레임워크에서 PSR2 및 PSR4 사양 적용 및 홍보 Oct 15, 2023 am 10:24 AM

Fat-Free 프레임워크에서 PSR2 및 PSR4 사양의 적용 및 홍보 PHP 언어의 지속적인 개발과 적용 범위의 확장으로 인해 많은 개발자는 표준화된 코드를 작성하는 것이 프로젝트의 장기적인 유지 관리에 매우 중요하다는 것을 깨닫습니다. 그리고 팀 협업. 이를 위해 PHPFIG(PHP Developers Interest Group)에서는 PSR2 및 PSR4 사양을 포함한 일련의 코딩 사양을 개발했습니다. 이 기사에서는 Fat-Free 프레임워크에서 이 두 가지 사양을 적용하고 홍보하는 데 중점을 두고 해당 코드 예제를 제공합니다. 첫 번째

PHP PSR2 및 PSR4 사양이 코드 품질에 미치는 영향 PHP PSR2 및 PSR4 사양이 코드 품질에 미치는 영향 Oct 15, 2023 pm 02:21 PM

코드 품질에 대한 PHPPSR2 및 PSR4 사양의 영향에는 특정 코드 예제가 필요합니다. 소개: 소프트웨어 개발 프로세스에서 개인과 팀 모두 고품질 코드를 작성하기를 희망합니다. PHPPSR(PHPStandard Recommendation) 2와 PSR4는 PHP 커뮤니티에서 출시한 두 가지 사양으로, 코드의 가독성과 유지 관리성을 향상시킬 뿐만 아니라 팀 협업 시 일관된 코딩 사양을 제공합니다. 이 기사에서는 PSR2 및 PSR4를 소개합니다.

PHP의 PSR2 및 PSR4 사양을 기반으로 한 코드 사양 확인 도구 PHP의 PSR2 및 PSR4 사양을 기반으로 한 코드 사양 확인 도구 Oct 15, 2023 pm 05:33 PM

PHP의 PSR-2 및 PSR-4 사양을 기반으로 한 코드 사양 검사 도구: 구현 및 예제 소개: 소프트웨어 개발 프로세스에서 좋은 코드 사양은 프로그램 품질과 유지 관리 가능성을 보장하는 중요한 요소입니다. 개발자가 PHP 코드 사양을 따르도록 돕기 위해 PHP-FIG(PHPFrameworkInteropGroup)는 PSR(PHPStandardsRecommendations) 사양 시리즈를 제안했습니다. 그 중 PSR-2는 주로

PHP PSR2 및 PSR4 사양에 대한 예비 연구 PHP PSR2 및 PSR4 사양에 대한 예비 연구 Oct 15, 2023 pm 03:33 PM

PHPPSR2 및 PSR4 사양에 대한 예비 연구 소개: PHP 코드를 작성하는 과정에서 특정 코딩 사양을 따르는 것이 매우 중요합니다. 좋은 코딩 표준은 코드의 가독성과 유지 관리성을 향상시키고 팀워크를 촉진할 수 있습니다. PHP에는 일련의 코딩 사양이 있으며, 그 중 PSR2와 PSR4가 가장 널리 사용되는 두 가지 사양입니다. 이 기사에서는 PSR2 및 PSR4 사양에 중점을 두고 특정 코드 예제를 통해 이러한 사양을 따르는 방법을 설명합니다. 1. PSR2 사양 PSR2 사양은 주로 PHP 코드에 중점을 둡니다.

PSR2 및 PSR4 사양을 준수하는 PHP 프로젝트 버전 관리 및 릴리스 프로세스 PSR2 및 PSR4 사양을 준수하는 PHP 프로젝트 버전 관리 및 릴리스 프로세스 Oct 15, 2023 am 10:27 AM

PSR2 및 PSR4 사양을 준수하는 PHP 프로젝트 버전 관리 및 릴리스 프로세스에는 특정 코드 예제가 필요합니다. 소개: PHP 프로젝트를 개발하는 과정에서는 코딩 표준을 준수하는 것이 좋습니다. 그 중 PHP-FIG 단체에서 제안한 PSR2 사양은 PHP 코딩 사양의 기본 기반인 반면, PSR4 사양은 자동 로딩에 관한 사양이다. 이 기사에서는 PHP 프로젝트에서 PSR2 및 PSR4 사양을 준수하는 방법을 소개하고 해당 코드 예제를 제공합니다. 1. PSR2 사양 PSR2 사양은 다음과 같은 내용을 다룹니다.

See all articles