パッケージ

アプリケーションは独立したcomposerパッケージです。

フレームワークは依存としてcomposer installしますが、他のアプリケーションも依存パッケージとして使うことができます。

アプリケーション・パッケージ

構造

BEAR.Sundayアプリケーションのファイルレイアウトは php-pds/skeleton に準拠しています。

bin/

スクリプトで実行可能なコマンドを設置します。

BEARのリソースはコンソール入力とWebの双方からアクセスできます。 呼び出すスクリプトによってコンテキストが変わります。

php bin/app.php options '/todos' # APIアクセス (appリソース）

php bin/page.php get '/todos?id=1' # Webアクセス (pageリソース）

php -S 127.0.0.1 bin/app.php # PHPサーバー

コンテキストが変わるとアプリケーションの振る舞いが変わります。 ユーザーは独自のコンテキストを作成することができます。

src/

アプリケーション固有のクラスファイルを設置します。

publc/

Web公開フォルダです。

var/

log,tmpフォルダは書き込み可能にします。var/wwwはWebドキュメントの公開エリアです。 confなど可変のファイルを設置します。

実行シーケンス

1. コンソール入力(bin/app.php, page.php)またはWebサーバーのエントリーファイル(public/index.php)がbootstrap.phpを実行します。
2. bootstrap.phpでは実行コンテキストに応じたルートオブジェクト$appを作成します。
3. $appに含まれるルーターは外部のHTTPまたはCLIリクエストをアプリケーション内部のリソースリクエストに変換します。
4. リソースリクエストが実行され、結果がクライアントに転送されます。

フレームワーク・パッケージ

フレームワークは以下のパッケージから構成されます。

ray/aop

Javeの AOPアライアンス に準拠したAOPフレームワークです。

ray/di

google/guice スタイルのDIフレームワークです。ray/aopを含みます。

bear/resource

PHPのオブジェクトをRESTサービスとして使用するRESTフレームワークです。ray/diを含みます。

bear/sunday

フレームワークのインターフェイスパッケージです。bear/resourceを含みます。

bear/package

bear/sundayの実装パッケージです。bear/sundayを含みます。

ライブラリ・パッケージ

必要なライブラリ・パッケージをcomposerインストールします。

ベンダー・パッケージ

特定のパッケージやツールの組み合わせをモジュールだけのパッケージにして再利用し、同様のプロジェクトのモジュールを共通化する事ができます。¹

Semver

全てのパッケージはセマンティックバージョニング に従います。マイナーバージョンアップでは後方互換性が破壊されることはありません。