An Introduction to eZ Components

There are three ways how to make eZ components available for your PHP environment, please read the whole of this article before continuing with the practical part:

• Use PEAR Installer for convenient installation via command line
• Download eZ components packaged in an archive
• Get the latest sources from SVN

Installing the eZ components with the help of the PEAR Installer is highly recommended, as it is the most convenient and safest way. The given instructions serve as guidelines on a Linux system, but are also useful for those who run PHP on Windows, of course they just need to adjust the paths accordingly.

PEAR Installer

After you have installed PHP 5.1.1 or a higher version, you will have the PEAR Installer available automatically. Simply issue the following commands in the shell:

pear channel-discover components.ez.no

This will let PEAR Installer connect to the server components.ez.no where the eZ components are stored for distribution.

pear install -a ezc/eZComponents

This final command will download and typically extract all eZ components to the directory where also the PEAR packages reside, but beneath the ezc/ subdirectory, with the absolute path being: /path/to/pear/ezc/

In case you already have installed the components before, you can simply do:

pear upgrade ezc/eZComponents

Download of Archives

The packaged releases of eZ components can be downloaded as .tar.bz2 or .zip archive from the download page. The bundles that we offer for download always include the whole library.

SVN

If you love to live on the edge and would like to work with the latest development version of the eZ components, you can get it from SVN. For a successful installation from SVN, procede in the given order.

First, create a directory where you want the eZ components to be placed.

Next, you should checkout the tree. To checkout, do

svn co http://svn.ez.no/svn/ezcomponents/trun

When working with the SVN version, it is important to setup the environment for the eZ components. Hence, checkout the needed script with:

svn co http://svn.ez.no/svn/ezcomponents/scripts

and execute it:

./scripts/setup-env.sh

This will create the symlinks for autoload, which will of course not work on Windows.

From version 1.1 of the components there is also a script for Windows. Here you need to execute the following script instead:

scripts\setup-env.bat

This will create copies of necessary files for autoload.