Previous Up Next
Installation Installation Manual Install

PEAR Installer

How to install Mach-II for PHP using the PEAR installer

Alan Richmond
Copyright 2004 Ben Edwards, Inc.

PEAR Installer

The preferred method of installation is to use the PEAR installer. It has several advantages over a manual installation. Installation can be as simple as a single command line. It varifies that each file in the package is uncorrupted, automatically places the core files in your include_path, validates dependencies (important for cache, filter and plugin extensions), allows managing of packaged extensions and makes upgrading very simple.

Note: PEAR installer requires PHP 4.2.0 or newer.

Step 1

If PEAR is already installed and configured, skip to step 1b; otherwise continue to step 1a.

Step 1a

The installer has been included by default with PHP since 4.3.0 but was not always usable with Windows "out of the box" until more recently. Also, versions included with Linux distributions often are out of date. If you need help installing PEAR see the documentation here.

Step 1b

Unless you just installed PEAR, it is generally best to upgrade to the latest beta version of the PEAR core:

pear config-set preferred_state beta
pear upgrade pear
pear config-set preferred_state {your preferred state, if other than beta}

Step 2

There are several ways to install the Mach-II core, directly from the server (step 2a) or from the package file (step 2b).

Step 2a

At the command line:

pear config-set master_server php.mach-ii.com
pear install machii

This will install the latest version on Mach-II for PHP for your configured preferred_state. If you won't be installing any more Mach-II packages for the time being but will be using PEAR, restore the master_server setting to pear.php.net. In the future the installer will support multiple servers and it won't be necesary to change it back and forth.

All PEAR command line features apply, so alternatively:

pear install http://php.mach-ii.com/get/MachII

The latest beta or better:

pear install http://php.mach-ii.com/get/MachII-beta

You're done! Skip to step 3.

Step 2b

Download the Mach-II core from it's package description page. All public releases are available here.

Or direct download the latest stable version: http://php.mach-ii.com/get/MachII-stable

And install it:

pear install /path/to/MachII-x.x.x.tgz

You're done! Skip to step 3.

Step 3

Remember the -R or --installroot option can be used to override the default install directory. (Usually, /usr/share/pear on UNIX-like systems and C:\PHP\PEAR on Windows systems.) If you set another install directory, don't forget to add it to your PHP include_path.

You are ready to installtest.pkg your Mach-II installation!

Previous Up Next
Installation Installation Manual Install

Documentation generated on Thu, 20 Jan 2005 10:47:24 -0800 by phpDocumentor 1.3.0RC3