Intro: What Xhwlay IS, and IS NOT ?

Xhwlay is a library, not a framework.

Xhwlay provides event-driven oriented statefull page flow control library. Xhwlay does NOT provides following features :

  • Input vaildation
  • Session/Cookie Management
  • Database Layer(like ORM)
  • Logging
  • Other helpful utilities

Why not ? - Because of Xhwlay's Concept described below. Xhwlay's concepts are following three:

  • Simple
  • Primitive
  • Small

I believe that these concepts lead ease to learn, ease to hack, ease to use, and more and more flexibility for developers. Xhwlay minds only page flow control. Other features cited above are have to be implemented by Developer's (equal your) own hands.
But, You'll requre less time to learn Xhwlay itself, than any other "PHP Framework" like symfony, cake to learn. Instead, you can use more and more time to consider your own business logics and implementing many codes as you like.

I hope you'll sense "FREEDOM" by using Xhwlay in your programming.

About

License

Apache Software License 2

Requirements

PHP : PHP4, PHP5
Unit Tested : PHP 4.4.7, PHP 5.2.4

Xhwlay depends on some PEAR packages and PEAR version must be larger than 1.4. Dependency will be resolved when you install by 'pear' command with "--alldeps" options.

Maintainer

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

Download and Install

Latest Release

Installation

Xhwlay(PHP) is provieded as PEAR package. You can install it into your PEAR environment like below:

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

Are you a normal user, not administrator of your sever ? Don't worry. PEAR provides some means for normal users to setup PEAR environment in user's local/home environment.
Please refer PEAR Manual :
>>"Installation -> Getting Manager" (In English)
In Japanese, you can refer same manual here :
http://www.phppro.jp/phpmanual/pear/installation.getting.html

After your installation, see tutorial document. By making some simple examples in this tutorial, you'll understand what Xhwlay and "event-driven stateful page flow control" is.

If you want to uninstall Xhwlay:

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

Follwing SVN(Subversion) repositry

  1. You must create accuont in SourceForge.net.
  2. You must understand usage of SVN tools.
  3. Try SVN checkout.
Subversion Server
https://xhwlay.svn.sourceforge.net
Path to Repositry
/svnroot/xhwlay
Example:
$ svn checkout \
    https://xhwlay.svn.sourceforge.net/svnroot/xhwlay/xhwlay-php
View only : http://xhwlay.svn.sourceforge.net/viewvc/xhwlay/

Documents

Tutorial

Xhwlay Tutorials (English) PDF : 274KB
After download and install Xhwlay, Let's make some simple example using Xhwlay. You'll find what xhwlay is, what event-driven stateful page flow control is.

Internal API Reference

Online PHPDOC HTML
Classes, methods, constants reference generated by phpDocumentor.

Theories and Implementations of Finite State Machine

If you don't know event-driven stateful page flow and "Finite State Machine(FSM)", please look following resources: (Thank you for Piece-Framework, Stagehand_FSM)

Special Thanks

Special Thanks for Piece Project.