Classe: PEAR_Command  - X-Ref

PEAR command class, a simple factory class for administrative
commands.

How to implement command classes:

- The class must be called PEAR_Command_Nnn, installed in the
"PEAR/Common" subdir, with a method called getCommands() that
returns an array of the commands implemented by the class (see
PEAR/Command/Install.php for an example).

- The class must implement a run() function that is called with three
params:

(string) command name
(array)  assoc array with options, freely defined by each
command, for example:
array('force' => true)
(array)  list of the other parameters

The run() function returns a PEAR_CommandResponse object.  Use
these methods to get information:

int getStatus()   Returns PEAR_COMMAND_(SUCCESS|FAILURE|PARTIAL)
*_PARTIAL means that you need to issue at least
one more command to complete the operation
(used for example for validation steps).

string getMessage()  Returns a message for the user.  Remember,
no HTML or other interface-specific markup.

If something unexpected happens, run() returns a PEAR error.

- DON'T OUTPUT ANYTHING! Return text for output instead.

- DON'T USE HTML! The text you return will be used from both Gtk,
web and command-line interfaces, so for now, keep everything to
plain text.

- DON'T USE EXIT OR DIE! Always use pear errors.  From static
classes do PEAR::raiseError(), from other classes do
$this->raiseError().