PHP Requirements
As PHP version the eZ Components require version 5.2.1, although a later version is always recommended. The latest version of PHP can be downloaded here.
eZ Components versions before the 2008.1 release require PHP version 5.1.6. Please be aware that no updates for those releases are being made anymore.
Some of the components require that certain PHP extensions are enabled in the build. While most of them are enabled by default, some of them have to added explicitly. The table below lists all the components, and which extensions are required or optional.
Required and Preferred Extensions
Component | Extension (default) | Extension Required | Extension Optional |
---|---|---|---|
All | pcre, spl, reflection | ||
Authentication | openssl and bcmath or gmp for TypeKey and OpenID support, ldap for LDAP support | ||
AuthenticationDatabaseTiein | Same as Database | ||
Archive | zlib, posix | bz2 | posix for permission support |
Base | posix | posix to test if features are enabled | |
Cache | memcache and zlib for Memcache storage, apc for APC storage | ||
Configuration | posix | ||
ConsoleTools | |||
Database | pdo, pdo_sqlite | pdo_mysql, pdo_oci8, pdo_pgsql, pdo_mssql/pdo_dblib, depending on the database that you want to use | |
DatabaseSchema | simplexml | Same as Database | |
Debug | |||
EventLog | Same as Database, if you want to log to a database | ||
Execution | |||
Feed | dom | ||
File | |||
Graph | dom, xml | gd to generate bitmaps (with TrueType font support or Type1 font support), ming for generating Graphs as flash files | |
GraphDatabaseTiein | pdo | Same as Database | |
ImageAnalysis | ctype | exif | |
ImageConversion | gd | ||
iconv | fileinfo for better detection of mime-types when sending e-mails, mcrypt for NTLM SMTP authentication, openssl for SSL support | ||
PersistentObject | |||
PhpGenerator | |||
SignalSlot | |||
SystemInformation | win32ps (on Windows) | ||
Template | |||
Translation | ctype, simplexml | ||
TranslationCacheTiein | |||
Tree | dom | ||
TreeDatabaseTiein | pdo | Same as Database | |
Url | |||
UserInput | filter | ||
Webdav | fileinfo or mimetype for detection of mime-types of files | ||
Workflow | simplexml, dom | ||
WorkflowDatabaseTiein | Same as Database | ||
WorkflowEventLogTiein | Same as Database, if you want to log to a database |
Quick Reference on Enabling Extensions
Extensions that are enabled by default in PHP
Extension | Configure switch(es) |
---|---|
ctype | --enable-ctype |
dom | --enable-dom --enable-libxml |
iconv | --with-iconv |
pcre | --with-pcre-regex |
pdo | --enable-pdo |
pdo_sqlite | --with-pdo-sqlite |
posix | --enable-posix |
reflection | --enable-reflection |
simplexml | --enable-simplexml |
spl | --enable-spl |
xml | --enable-xml |
zlib | --with-zlib |
Extensions that are bundled with PHP
Extension | Configure switch(es) | Remarks |
---|---|---|
bcmath | --enable-bcmath | |
bz2 | --with-bz2 | |
gd | --with-gd --with-freetype-dir=/usr --with-jpeg-dir=/usr --with-ttf --with-xpm-dir --with-png-dir --with-jpeg-dir --with-t1lib | The eZ Components want at least PNG and JPG support, other parts are optional. We suggest to compile GD also with FreeType2 support as well to enable all features of the Components. |
gmp | --with-gmp | |
ldap | --with-ldap | |
mcrypt | --with-mcrypt | |
mimetype | --with-mime-magic | Deprecated in favour of fileinfo. |
ming | --with-ming | |
exif | --enable-exif | |
filter | --enable-filter | In PHP 5.2.0 and higher you can simply use --enable-filter, in PHP 5.1.x you need to install the filter extension through PECL. |
pdo_mysql | --with-pdo-mysql | |
pdo_oci8 | --with-pdo-oci | |
pdo_pgsql | --with-pdo-pgsql | |
pdo_mssql | --with-pdo-mssql | On Windows (on Linux use pdo_dblib) |
pdo_dblib | --with-pdo-dblib | Mssql driver for Linux (on Windows use pdo_mssql). The FreeTDS software must be installed also. |
openssl | --with-openssl |
Extensions that are not bundled with PHP
Extension | Configure switch(es) |
---|---|
apc | You need to install the APC extension through PECL. |
fileinfo |
You need to install the fileinfo extension through PECL.
|
memcache | You need to install the Memcache extension through PECL. |