Troubleshooting eZ publish
From TroubleshootingWiki
| Official Page |
| Project Documentation |
| Download |
|
Once you have installed eZ publish, you should have a fully functional eZ publish site to start working with. If you've hit a snag, there are a few common issues you can look at to get things working.
Contents |
[edit] PHP Memory Limits
A common problem in hosting environments is that the memory limit of PHP is set too low. The default value of the limit is 8MB, but this is too low for eZ publish to run (although the eZ team has been working hard at reducing memory consumption). If you get output similar to the following, then you have this problem:
Fatal error: Allowed memory size of 8388608 bytes exhausted (tried to allocate 184320 bytes) in /www/ezsite/kernel/classes /ezpackage.phpon line 2140 Fatal error: eZ publish did not finish its request.The execution of eZ publish was abruptly ended, the debug output is present below.
There is an easy fix to this if you are allowed to override the PHP settings using a .htaccess file (if your host doesn't support this, you may need to look for a new host) placed in the root of the eZ publish installation. In this file, add the following line:
php_value memory_limit "16M"
This will raise the memory limit to 16MB. If this still does not work, continue raising the limit until it does. In general, you will not have to go over 32MB for the site to work. You may need to increase this setting later, if your pages are very complex.
[edit] PHP Running as a CGI
If your hosting provider is running PHP as a CGI instead of an Apache module, then eZ publish will have problems. The main symptom of this is that regardless of the link you click on, you will always get the front page of the site. The only way of fixing this problem (in versions of eZ publish prior to 3.4) is to modify ezsys.php, one of the eZ publish files. There are a number of posts in the forums at http://ez.no describing how to do this.
Fortunately, one of the outlined features for version 3.4 of eZ publish is a fix for this problem, so the best thing is to use this version when it becomes available. To tell if your host is running PHP as a CGI, create a PHP file on your server containing the following script:
<?php if (php_sapi_name() == 'cgi') echo "PHP is running as a cgi"; else echo "PHP is running as a module"; ?>
[edit] Additional References
- For instructions on Installing eZ publish, click here
- For instructions on advanced techniques for Creating Designs using eZ Publish, click here
- For instructions on Troubleshooting eZ publish, click here
- For instructions on advanced techniques for Debugging eZ Publish, click here
[edit] Source
The source of this content is Chapter 1: Installing eZ publish of Learning eZ publish 3 : Building content management solutions by Paul Forsyth, Ben Pirt, Paul Borgermans, Bjorn Dieding, Martin Bauer, Tony Wood (Packt Publishing, 2004).
