PHP Dialog: Create console based UIs with the dialog program

PHP Dialog v1.0
Author: Michele Brodoloni <[email protected]>

+--------------+
| DESCRIPTION  |
+--------------+
This class allows you to create pretty dialog boxes within your php-cli scripts. 
It relies on Linux "dialog" utility.

+--------------+
| REQUIREMENTS |
+--------------+
  * PHP 5.3 (due to a bug with proc_open() in PHP 5.1)
  * dialog 1.0 / 1.1 

+--------------+
| INSTALLATION |
+--------------+
  * Install the dialog utility using your favority package manager
    - apt-get install dialog     # (For Debian/Ubuntu)
    - yum install dialog         # (For RHEL/CentOS)
  * Download and extract this tarball
  * Place file class.dialog.php and the plugins directory wherever you want but in the same path.


+--------------+
| BASIC  USAGE |
+--------------+
To use this class just include it, and call the static factory() method to fetch the wanted object. 
Here's an example:

----------[ CODE:START ]--------------
<?php

    require_once 'path/to/class.dialog.php';
    $dialog = Dialog::factory($type, $params);

?>
----------[ CODE:END ]-----------------

* $type is the type of dialog requested. Possible choices are:
    - confirm
    - msgbox
    - gauge
    - inputbox
    - calendar
    - timebox
    - ... And so on. Just list files into 'plugins' directory.

* $params is an optional associative array which sets default params during object construction. 
  It could come handy when need to instantiate several dialog objects with the same values (such as title, backtitle, ecc..)


----------[ CODE:START ]--------------
<?php

 require_once 'path/to/class.dialog.php';

 $params = array(
    'backtitle' => 'My App',
    'title'     => 'Box title'
 );
 
 $d1 = dialog::factory('msgbox', $params);
 $d1->setCaption('Hello World #1')
    ->show();

 $secs=5;
 $d2 = dialog::factory('pause', $options);
 $d2->setCaption("Please wait $secs seconds.")
    ->setSeconds($secs)
    ->show();

?>
----------[ CODE:END ]-----------------


+---------------+
| DOCUMENTATION |
+---------------+

For further information please download and extract the zip file located
into the docs directory and then open the index.html file in the extracted
directory.