FuelPHP-パッケージ

パッケージはコードの再利用のモジュールに似ていますが、次の点で異なります。

Web URLにはマッピングされません
HMVCのリクエストではアプローチできません

要するに、パッケージはブログ、アルバムなどの直接的なWeb機能ではありません。代わりに、電子メール処理、ドキュメント作成、チャート作成、認証などのようにグループ化された機能のライブラリです。これにより、Webアプリケーションの開発が高速化されます。

パッケージの作成

パッケージを作成するには、まず次のように指定されたソースコードを配置する必要があります。

/fuel
  /packages
     /package (root directory of package)
        /bootstrap.php
     /classes
        /our.php
     /classes.php
        /here.php
     /config
        /config.php
        /and_so_on

パッケージの構造には、config.phpおよびbootstrap.phpファイルの2つのパッケージ固有ファイルがあります。構成ファイルの目的は、メインアプリケーションに影響を与えることなく、パッケージの構成をパッケージフォルダー自体の下にグループ化することです。ブートストラップファイルの目的は、オートローダーが適切にロードするようにネームスペースを設定することです。

名前空間を設定するいくつかの方法は次のとおりです。

Autoloader::add_namespace('Mypackage', __DIR__.'/classes/');
Autoloader::add_core_namespace('Mypackage');
Autoloader::add_core_namespace('Mypackage', true);
Autoloader::add_classes (array(
   'Mypackage\\Classname' => __DIR__.'/classes/classname.php',
   'Mypackage\\Anotherclass' => __DIR__.'/classes/anotherclass.php',
));

ブートストラップファイルが適切に構成され、パッケージがアプリケーションにロードされると、次のように使用できます。

$instance = new Myclass;
$instance = new Mynamespace\Myclass;

パッケージのインストール

通常、パッケージはfuel/packagesディレクトリに配置されます。デフォルトでは、次のパッケージがインストールされます。

auth -認証パッケージ
email -電子メールパッケージ
oil -燃料のコマンド、オイルパッケージ
orm -ORMパッケージ
parser -Markdownパーサーパッケージ

新しいパッケージをインストールするには、次の2つのオプションがあります。

オプション1 *-手動インストール-ダウンロードとインストール

パッケージを手動でインストールするには、最初に作成者のWebサイトからパッケージをダウンロードします。パッケージを展開し、 fuel/packages/ フォルダーに配置します。

オプション2 *-オイルコマンドを使用した自動方法

FuelPHPは、githubでホストされているパッケージを自動的にインストールする方法を提供します。次のコマンドを使用して、パッケージmytestpackageをインストールします。

php oil package install mytestpackage

gitクライアントを使用してパッケージのソースコードを複製し、fuel/packagesフォルダーに移動します。 gitクライアントが利用できない場合、次のように-directコマンド引数を使用して、パッケージをダウンロードしてインストールするようにコマンドに指示できます。

php oil package install mytestpackage --direct

パッケージの使用

パッケージは、アプリケーションにロードされると、アプリケーションで使用できます。パッケージをアプリケーションにロードするには、2つの方法があります。

オプション1 *-パッケージクラスを通じて

FuelPHPは、ロード、アンロード、およびロードされたメソッドを介してパッケージの可用性をそれぞれチェック、ロード、アンロード、およびチェックするクラス Package を提供します。 load メソッドには2つのパラメーターがあります。最初のパラメーター $ package はパッケージの名前で、2番目のパラメーター path はパッケージのパスです。パッケージが fuel/packages フォルダーにインストールされている場合、2番目のパラメーターはオプションです。

//load the orm package
Package::load('orm');

//load the parser package from a specific directory
Package::load('parser', '/path/to/packages/dir/');

//load the non-existent package
Package::load('awesome');//Throws a PackageNotFoundException

オプション2 *-設定ファイルを使用

パッケージを永続的にロードするには、メイン構成ファイル fuel/app/config/config.php の always_load 構成エントリの下にパッケージを追加するだけです。電子メールパッケージを読み込むには、次の構文を使用します。

'always_load' => array (
   'packages' => array (
      'email',
   ),
),

パッケージがアプリケーションにロードされると、次のように使用できます。

$instance = new Myclass;
$instance = new Mynamespace\Myclass;

Fuelphp-packages

目次

FuelPHP-パッケージ

パッケージの作成

パッケージのインストール

パッケージの使用