パッケージ

アプリケーションは独立した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/

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

public/

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

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

ray/di

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

bear/resource

bear/sunday

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

bear/package

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

ライブラリ・パッケージ

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

ベンダー・パッケージ

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

Semver

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