イントロ:Xhwlayでできること、できないこと

Xhwlayはライブラリであって、フレームワークではありません。

Xhwlayはイベント駆動指向のステートフルページフロー実行エンジンライブラリです。 Xhwlayは以下に示すような機能は提供しません。

  • 入力値のバリデーションシステム
  • セッション・クッキー管理機能
  • データベース操作ライブラリ(ORM等)
  • ロギング機能
  • その他"フルスタック"と呼ばれるフレームワークが備えている機能

なぜXhwlayではこれらを提供しないのか?それは、以下に示すXhwlayの基本コンセプトが理由となります。 Xhwalyの三大基本コンセプト、それは・・・

  • Simple(概念やクラス構造が簡潔であること)
  • Primitive(実装が原始的であること)
  • Small(コードサイズ全体が小さいこと)

この三大基本コンセプトが、学習が簡単で、内部構造の理解(hack)が簡単で、使い方が簡単で、そしてなによりも柔軟性を開発者にもたらすと信じて止みません。 Xhwlayはページフローの制御のみを担当します。上で述べたような機能は、アプリケーションの開発者自身の手により実装される必要があります。
しかし、Xhwlayを使いこなすための学習時間は、他のPHPフレームワーク(symfonyやCakeなど)のそれよりも短く済ませることができるはずです。 現場では、開発者は本当に注力したいビジネスロジックや他の多くのコードを、自分たちの好きなように作り込む為の時間を確保できるのです。

Xhwlayは開発者を「フレームワーク病」から解放し、かつてあった「自由」を取り戻してくれることでしょう。

Xhwlayについて

ライセンス

Apache Software License 2

動作環境

PHP : PHP4, PHP5
動作確認済 : PHP 4.4.7, PHP 5.2.4

Xhwlayは幾つかのPEARパッケージに依存しています。また、PEAR自体のバージョンは1.4以上である必要があります。 PEARパッケージへの依存性は、pearコマンドでインストールする際に "--alldeps" オプションを付けることで解決されるでしょう。

メンテナ

msakamoto-sf at users.sourceforge.net
(Another H.N : FengJing)

ダウンロードとインストール

最新リリース

インストール

PHP用のXhwlayはPEARパッケージで提供されています。 以下のように、pearコマンドでインストール可能です。

$ su (if you needed)
# pear install \
http://xhwlay.sourceforge.net/packages/xhwlay-php/Xhwlay-0.9.3.tgz

もしあなたがサーバーの管理者でなく、システムのPEARパッケージを操作できないとしても、心配する必要はありません。 PEARは一般ユーザー権限でもローカル環境にセットアップできる幾つかの方法を提供しています。
以下のPEARマニュアルを参照して下さい。
>>"Installation -> Getting Manager" (In English)
日本語では以下のURLが利用可能です:
http://www.phppro.jp/phpmanual/pear/installation.getting.html

インストールが終われば、チュートリアルを参照してみて下さい。 チュートリアル中での簡単なサンプルの作成を通して、Xhwlayの使い方や"イベント駆動指向ステートフルページフロー"の概念を学べます。

アンインストールしたい場合は以下のようにして下さい。

$ su (if you needed)
# pear uninstall __uri/Xhwlay

SVN(Subversion)リポジトリを追い掛ける

  1. 最初に SourceForge.net でアカウントを作成します。
  2. SVNのツールや使い方について熟知して下さい。
  3. SVNからcheck outします。
Subversion Server
https://xhwlay.svn.sourceforge.net
Path to Repositry
/svnroot/xhwlay
チェックアウト例:
$ svn checkout \
    https://xhwlay.svn.sourceforge.net/svnroot/xhwlay/xhwlay-php
View only : http://xhwlay.svn.sourceforge.net/viewvc/xhwlay/

ドキュメント

チュートリアル

Xhwlay Tutorials (Japanese) PDF : 339KB
Xhwlayのダウンロードとインストールが終われば、Xhwlayを使った簡単なサンプルを作ってみましょう。 Xhwlayの使い方や"イベント駆動指向ステートフルページフロー"の概念を学べます。

内部APIリファレンス

Online PHPDOC HTML
クラス、メソッド、定数のリファレンス(phpDocumentorによる自動生成)

有限状態遷移マシンの理論と実装

イベント駆動のステートフルページ遷移や、「有限状態遷移マシン(Finit State Machine: FSM)」の詳細については、以下のリソースで知ることができます。 (Piece Framework の Stagehand_FSMに感謝)

Special Thanks

Piece Projectに格別の感謝を捧げます。