Last modified on 30 January 2010, at 17:14

Zoph/Solving problems

DocumentationEdit

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:

Debug & TroubleshootingEdit

For debugging in Zoph 0.8.1 and later, see Zoph/Solving Problems/Logging in Zoph 0.8.1 and later.

You could try turning on Zoph's debug mode by setting the DEBUG setting in config.inc.php to a number higher than 0, the higher the number the more info you get. Also, check your php.ini for the configurations display_errors and error_reporting. PHP may not be showing error messages to you, setting them to.

error_reporting = E_ALL & ~E_NOTICE 
display_errors = On

will ensure that you will see PHP's error messages. zophImport.pl will tell you more about what it's doing if you add the --verbose commandline option. In some cases it may help to simplify the issue, for example if zophImport.pl fails, with 4 lines of commandline options, you could try if it still fails if you leave some options out.

Web importEdit

One of the parts of Zoph that is 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. Also, at this moment the webimport does not sufficiently check for these things and will fail with a PHP error (or sometimes no error at all) instead of a clear error message. This will be fixed in Zoph 0.9, where the whole import section will be rewritten. 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.

AutocompleteEdit

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:

<albums>
   <album>
      <key>null</key>
      <title> </title>
   </album>
   <album>
      <key>1</key>
      <title>Album Root</title>
      <albums>
         <album>
            <key>3</key>
            <title>Objects Found While Cleaning</title>
         </album>
         <album>
            <key>2</key>
            <title>Sample Album</title>
         </album>
      </albums>
   </album>
</albums>

If you see a PHP error, see Common PHP Errors below.

  • Try disabling autocomplete (under preferences) and see if you can use Zoph now.

If you find a browser-related problem (your site works correctly in Firefox, but not in another browser) please report a bug.

Common PHP ErrorsEdit

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

GD MissingEdit

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 exhaustedEdit

Fatal error: Allowed memory size of <number> bytes exhausted (tried to allocate <number> bytes) in <filename> on line <number>

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 exceededEdit

Fatal error: Maximum execution time of <number> seconds exceeded in <filename> on line <number>

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 dependant 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.

Webimport fails with with 'not found' errorEdit

sh: 1 not found

You can see this error when you are using the webimport to upload .ZIP or .TAR files and have set UNZIP_CMD or TAR_CMD to '1' instead of the tar or unzip command, usually 'unzip' and 'tar xvf', respectively. Change it in config.inc.php and try again.

Reporting a bugEdit

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 ForumEdit

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 helpEdit

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!