Zoph/Solving problems

Documentation
The first place to look in case things go wrong, is the documentation wikibook. The documentation is also included in the docs directory of the Zoph tarball

Some things to check:
 * Have you installed all requirements?
 * Have you followed the correct installation, configuration and/or upgrade instructions?

Debug &amp; Troubleshooting
To enable debugging information, see Debug

Web import
One of the parts of Zoph that is more likely to cause problems, is the webimport. This is caused by the fact that the webimport depends more on external factors than most other parts of Zoph. In most cases the problems are caused by wrong settings in php.ini, insufficient permissions on the filesystem or missing requirements. Things to check:
 * Check if PHP is displaying it's errors (see above for recommended display_errors and error_reporting configuration).
 * If PHP gives an error see Common PHP Errors below.

Autocomplete
Another feature that gives some more trouble than other features is the autocomplete feature. The autocomplete feature heavily relies on Javascript and although I try to test on many different browsers, it's always possible that your browser interpretes the Javascript code a little different than I intended. Things to try: null 1       Album Root 3             Objects Found While Cleaning 2             Sample Album If you see a PHP error, see Common PHP Errors below. If you find a browser-related problem (your site works correctly in Firefox, but not in another browser) please report a bug.
 * Test with a recent version of Firefox, if possible.
 * Try opening http://your.zoph.site/zoph/getxmldata.php?object=album in your browser. It should give an output like
 * Try disabling autocomplete (under preferences) and see if you can use Zoph now.

Common PHP Errors
Here are some frequently seen PHP errors. If you get a different error, Try Google or posting a message on the Zoph Forum.

GD Missing
Fatal error: Call to undefined function imagecreatefromjpeg in /var/www/html/zoph photo.inc.php on line 468 You are missing GD support in PHP, Zoph requires GD in order to create mid and thumbnail size images. Check your distribution documentation on how to enable GD. Usually it is a package named something like php-gd.

Allowed memory size exhausted
Fatal error: Allowed memory size of   bytes exhausted (tried to allocate   bytes) in   on line   PHP is refusing Zoph to use the amount of memory it wants to use. Check your php.ini for this line: memory_limit = 16M and increase this. Zoph could get quite memory hungry while resizing the images or adding watermarks. A rule of thumb is that you should set the memory limit to at least 6x the number of megapixels your (biggest) camera has. So, if you have a 10 Megapixel camera, you should probably set it to 64M.

Maximum execution time exceeded
Fatal error: Maximum execution time of   seconds exceeded in   on line   PHP has a limit on the time a PHP script is allowed to run. By default it is set on 30 seconds. Since importing of photos usually takes longer than that, you may get this error when trying to import. Increase the time in php.ini maximum_execution_time = 120 Since the amount of time Zoph needs to process images is dependent on your webservers CPU speed, load and the size of your photos, a rule of thumb cannot be given. Try increasing the time and/or upload smaller batches of images.

Reporting a bug
If you suspect that the problem you have run in to is a bug in Zoph, please create a bug report on http://www.zoph.org/bugs.

Zoph Forum
There is a Zoph Forum on http://www.zoph.org/forum. You can post a request for help there, of search to see if anyone has had a similar issue.

Asking for help
You can really speed up the resolution time of your problem by including relevant information in your forum post or bug report:
 * What were you trying to do?
 * Which Zoph version are you running on?
 * If the problem started after an upgrade, what was the previous version you were using?
 * What OS, PHP version are you running on?
 * If it is a browser issue, which browser are you using and have you tried another one?
 * Did you see any error messages?
 * What have you already tried?
 * (Relevant parts of) config.inc.php. remove your passwords!