A programmer's tale

eZ publish requirements according to the setup wizard

July 7th, 2006

This is a listing of the tests done by the setup wizard of eZ publish 3.8. You can use this list to predict if eZ publish will run on a specific web host or not.

Critical tests

eZ publish will probably not work correctly if a critical test fails.

Needed PHP extensions:

• session
• mysql OR pgsql
• gd2 OR the ImageMagick program

Required PHP settings:

• open_basedir “”
• safe_mode Off
• memory_limit at least 12M (this is too less for larger sites and for running some CLI scripts, according to the installation requirements it is highly recommended to have at least 64M)
• max_execution_time at least 30 (this could be too less for running some CLI scripts or for admin sites with a large content tree structure menu)
• magic_quotes_runtime Off
• allow_url_fopen On
• file_uploads On

Directory permissions:

• the directory specified by the upload_tmp_dir PHP setting (or the system’s default temporary directory if upload_tmp_dir is not specified) should be writeable by whatever user PHP/Apache is running as
• the following directories (if they exist) and all files inside should be writeable by whatever user PHP/Apache is running as:
  • design
  • settings
  • settings/override
  • settings/siteaccess
  • settings/siteaccess/admin
  • settings/siteaccess/demo
  • settings/siteaccess/user
  • var
  • var/cache
  • var/cache/codepages
  • var/cache/content
  • var/cache/ini
  • var/cache/override
  • var/cache/template
  • var/cache/template/process
  • var/cache/template/tree
  • var/cache/texttoimage
  • var/cache/translation
  • var/log
  • var/storage
  • var/storage/original
  • var/storage/reference
  • var/storage/variations

Required Apache HTTP server settings:

• AcceptPathInfo On (only for Apache 2)

Optional tests

If an optional test fails then your website’s performance will not be optimal or you won’t be able to use some advanced eZ publish functionality.

PHP extensions:

• gd2 with FreeType support (the functions imagettftext and imagettfbbox have to exist)
• zlib
• mbstring

PHP settings:

• register_globals Off
  
• magic_quotes_gpc Off

Entry Filed under: eZ Publish