Composer は PHP の依存関係管理ツールです。この記事では、他の人が Composer を通じてパッケージを簡単に使用できるように、パッケージを構築して Packagist に送信する方法を説明します。
コンポーザー パッケージを開発するには、いくつかの手順があります。
composer.json ファイルを初期化する
定義名前空間とパッケージ名
パッケージに実装する必要がある機能
GitHub に送信
パッケージを登録します
composer をインストールした後、composer init をローカルで実行し、対話型コマンドを使用して Composer.json を設定できますライン。
次に、いくつかの属性と一般的な設定を紹介します。
name この属性は、/ で区切られたパッケージ名を定義します。前にある属性は、サプライヤー名、パッケージ名に続いて、ベンダーは、パッケージを整理し、名前の競合を防ぐために、Packagist Web サイトによって開発者に提供される一意の名前を表します。したがって、送信するときは、https://packagist.org/packages/yourvendorname にアクセスし、URL 内の yourvendorname を希望の名前に置き換えることをお勧めします。ページに 404 がない場合は、登録されていることを意味します。
ライセンス ライセンス。ライセンスについては、オープンソース プロジェクト ライセンスの概要とライセンスの選択方法
の 2 つの記事を読むことをお勧めします。現在のパッケージをインストールするために必要な依存関係が必要です。現在のパッケージは、すべての依存関係がインストールされている場合にのみインストールされます。
autoload この構成では、主な設定は PSR-4 または PSR-0 です。PSR- を使用することをお勧めします。 4標準。
http://json-schema.org/ では、JSON スキーマの定義とそのさまざまな機能のさまざまな言語での実装が紹介されており、その中には JSON スキーマが含まれます。 Validator はオンライン検証サービスです。実際、最も簡単な方法は、composer validate combos.json を使用して、ファイルにエラーがあるかどうかを確認することです。
これは、composer.json のセットアップ方法を説明するビデオです
例として、私が開発したシングル サインオン SDK を取り上げます。 Laravel に基づいてサイトを実装します。 シングル サインオン システムに簡単にアクセスするには、アプリケーションをサーバーに登録し、SSO にアクセスするための指定されたインターフェイスを実装するだけで済みます。
プロジェクト構造は典型的な MVC 構造です。
.└── geo └── geosso ├── LICENSE ├── README.md ├── composer.json └── src ├── Contracts ├── Http │ ├── Controllers │ ├── Middleware │ └── Requests ├── ParamsBean ├── Providers ├── Support └── config12 directories
LICENSE、README.md、composer.json は、tree -d の実行後に手動で追加されます。
プロジェクトのルート ディレクトリは src で定義され、composer.json でも定義されているため、composer はこのパッケージを読み込むときに、名前空間を介してファイル パスを解決する方法を認識します。
HTTP ディレクトリはリクエストの応答を表し、以下のコントローラは正当なリクエストのコントローラを表し、ミドルウェアはリクエストの第 1 レベルを表し、ミドルウェアを通じてリクエストを傍受し、フロントエンドのリクエストとフィルタを取得するリクエストを表します。リクエスト。
コントラクトはインターフェース定義を表します。 ParamsBean は、アプリケーション層が基礎となるサービスと通信するときに、配列を渡す代わりに Bean を使用して各パラメーターを取得し、インターフェイスを呼び出すときに型検出を強制するため、パラメーターを大幅に統合できます。レイヤー間の転送。
プロバイダーは Laravel のサービス コンテナーを表し、サービス コンテナーを通じて、ルートと構成を登録し、ヘルパー クラスをロードし、インターフェイスとその実装をバインドできます。
サポートは、ロジックとは関係のない一般的に使用される関数をカプセル化するいくつかのヘルパー クラスです。config を通じて、グローバル関数 config() を使用して構成を簡単に設定および呼び出すことができます。
前の手順に従って、パッケージに基本的なスケルトンが作成されます。次の手順では、パッケージを GitHub にアップロードし、プロジェクトを構成し、継続的統合サービスを統合して、オープンソースプロジェクトのライセンス。
GitHub がプロジェクトを初期化するとき、.gitignore ファイルの生成、ライセンスの選択、README.md ファイルの初期化、ローカル プロジェクト ディレクトリへの切り替え、次の手順に従ってディレクトリをアップロードすることを選択できます。 GitHub:
>git init # 初始化仓库>git remote set-url origin --push --add git@github.com:jayxhj/geosso.git # 添加远程追踪仓库地址> git add .> git commit> git push origin master
Packagist は、composer がパッケージのメタデータ情報を取得した後、GitHub からコードをプルします。したがって、開発したパッケージを GitHub にアップロードした後、世界中の人々が Composer を通じてコードをプルできるように、パッケージを Packagist に登録する必要があります。
わずか 3 つのステップで Packagist に送信できます:
https://packagist.org/ でアカウントを登録します
Packages/submit開発パッケージを送信します
送信されたパッケージが更新後に時間内に Packagist に同期できるように Webhook を設定します
それ以降、基本パッケージ 開発は終了しました。 Composer を使用して PHP の依存関係を管理し、コンポーザー パッケージを作成して独自のクラス ライブラリを拡張し、他のクラス ライブラリを導入して独自の関数を補完できるため、車輪を再発明する必要がありません。