手書きPHP APIフレームワーク(1) PSR仕様-PHPチュートリアル-php.cn

手書きPHP APIフレームワーク(1) PSR仕様

藏色散人

リリース： 2023-04-11 10:28:02

転載

3449 人が閲覧しました

この記事は、PHP に関する関連知識を提供します。主にコーディング標準について説明します。また、開発中に標準に従うよう努めることをお勧めします。興味のある友人は一緒に見てみると良いでしょう。そうなることを願っています。みんな助けてくれます。

作成当初の意図

CURD の使用に飽きていませんか?
さまざまなフレームワークは少し面倒ですか?
自分でフレームワークを設計してみたことはありますか?
PHP 構文を学習しましたが、それを実践して強固な基礎を築くためのプロジェクトがありません

これが、あなたのフレームワークを迅速に構築するのに役立つことを願っています仕事や勉強に何らかのメリットをもたらす可能性があります。助けとインスピレーションを求めに来てください。

何が学べるのか

PSR仕様
composerの使用法
API インターフェイスフレームワークを迅速に構築
##さまざまなデータ型の Redis アプリケーション
フレームワークを開発する前に、フレームワーク開発に伴う仕様について説明します。

ほとんどのプログラミング言語には独自のコーディング標準があり、「世界最高の言語」である PHP には確かに独自のコーディング標準があります。この仕様は PHP 標準勧告 (略して PSR) です。

もちろん、私自身の仕事から、多くの PHP プログラマー、特にジュニアプログラマーは、PHP にそのような仕様があることを知らないことがわかりました。

PSR とは何ですか?

PSR を紹介する前に、この仕様を策定した組織である PHP-FIG を紹介する必要があります。正式名称は PHP Framework Interoperability です。組織のメンバーは仕様を策定し、独自のプロジェクトに実装します。公式の組織ではありませんが、CakePHP、Composer、Drupal、PEAR、Slim、Yii フレームワーク、Zend などのほとんどの PHP コミュニティプロジェクトを代表しています。フレームワークが待機します。そして、ますます多くのプロジェクトがこの標準に参加し、準拠しています。

PSR プロジェクトの目的は、フレームワーク作成者またはフレームワークの代表者間の議論を通じて、制限レベルが最も低いコラボレーション標準を開発することです。各フレームワークは、エンジニアがより適切に連携できるように、統一されたコーディング標準に従っています。

これまでに公式サイトに掲載されているアイテムは20点ですが、ドラフト中やボツになったものを除くと以下の13点となります。

これらの仕様を見てみましょう: 手書きPHP APIフレームワーク(1) PSR仕様

PSR-1 基本コーディング仕様

PHP コードファイルは

PHP コードファイルは BOM なしで UTF-8 でエンコードする必要があります

PHP コードは For 宣言のみを定義する必要がありますクラス、関数、定数などの操作、または副作用を引き起こすその他の操作 (ファイル出力の生成や .ini 構成ファイルの変更など) の場合は、2 つのうちの 1 つだけを選択できます。名前空間とクラスは PSR に準拠する必要があります。自動読み込み仕様 PSR-4
クラスの命名は、大文字で始まる StudlyCaps スタイルのキャメルケース命名仕様に従う必要があります。
定数のすべての文字クラスは大文字にする必要があり、単語はアンダースコアで区切る必要があります。
メソッド名は、小文字で始まるキャメルケーススタイルのキャメルケース命名規則に準拠する必要があります
PSR-12コードスタイル仕様
PSR-12 仕様は非常に詳細で、宣言、名前空間、クラスと継承、および制御構造の説明が含まれています。

最初にデモを見てみましょう:

<?php

declare(strict_types=1);

namespace Vendor\Package;

use Vendor\Package\{ClassA as A, ClassB, ClassC as C};
use Vendor\Package\SomeNamespace\ClassD as D;

use function Vendor\Package\{functionA, functionB, functionC};

use const Vendor\Package\{ConstantA, ConstantB, ConstantC};

class Foo extends Bar implements FooInterface
{
    public function sampleFunction(int $a, int $b = null): array
    {
        if ($a === $b) {
            bar();
        } elseif ($a > $b) {
            $foo->bar($arg1);
        } else {
            BazClass::bar($arg2, $arg3);
        }
    }

    final public static function bar()
    {
        // method body
    }
}

ログイン後にコピー

コードは [PSR-1] のコーディング仕様に従う必要があります

すべての PHP ファイルは Unix を使用する必要があります行終了文字として LF (改行);

すべての PHP ファイルは空行で終わる必要があります;

純粋な PHP コードファイルは最後の ?> 終了タグを省略する必要があります
理論的には、120 文字を超えてはなりませんが、厳密な制限はありません。空白行以外の行の後に余分なスペースがあってはなりません。
空行これによりコードが読みやすくなり、コードのブロックに役立ちます。
1 行に複数のステートメントを含めることはできません
コードは 4 つのスペースでインデントする必要があり、タブキーは使用しないでください
すべての PHP キーワードは次のとおりである必要があります。すべて小文字
コントロール構造の基本仕様は次のとおりです:

控制结构关键词后必须有一个空格。
左括号 ( 后一定不能有空格。
右括号 ) 前也一定不能有空格。
右括号 ) 与开始花括号 { 间一定有一个空格。
结构体主体一定要有一次缩进。
结束花括号 } 一定在结构体主体后单独成行。复制代码

ログイン後にコピー

# PSR-4 オートローディング

# ファイルパスから対応するクラスを自動的にロードするための関連仕様については、この仕様は相互運用可能であり、補足として使用できます。さらに、この PSR には、自動ロードされたクラスに対応するファイルストレージパスの仕様も含まれます。

ここでの「クラス」とは、すべてのクラス、インターフェイス、特性の再利用可能なコードブロック、およびその他の同様の構造を指します。

#完全なクラス名は次の構造にする必要があります:

 \<命名空间>(\<子命名空间>)*\<类名>

ログイン後にコピー

完全なクラス名は
- には 1 つ以上のサブ名前空間を持つことができます;
  ##完全なクラス名
- は最終クラス名を持たなければなりません;
  完全なクラス名のどの部分のアンダースコアにも特別な意味はありません;
#完全なクラス名 は、任意の大文字と小文字で構成できます。
#すべてのクラス名は、
でなければなりません 大文字と小文字が区別されます。
- は、対応する「ファイルベースディレクトリ」と
  一致する必要があり、その中の名前空間区切り文字がディレクトリ区切り文字として使用されます。
- は、接尾辞
  .php が付いた対応するファイルと同じ名前でなければなりません。
  オートローダーの実装
- いかなるレベルのエラーメッセージもトリガーしてはならず、
  すべき 戻り値があります。 #例

#完全なクラス名

名前空間プレフィックス

	#\Acme\Log\Writer\File_Writer	Acme\Log\Writer
\Aura\Web\Response\Status	Aura\Web	/path/to/aura-web/src/
\Symfony\Core \ Request	Symfony\Core	./vendor/Symfony/Core/

	クリックして最新の仕様提案を表示します