From Wikibooks, open books for an open world
Jump to: navigation, search

Zoph is being developped on Linux, but it should be able to run on any OS that can run Apache, MySQL and PHP. Users have reported succesful installations on MacOSX, several BSD flavours and even Windows. Debian and Ubuntu users can install Zoph from apt by typing apt-get zoph and Gentoo users could use the webapps overlay, although both are now quite outdated.

Zoph requires the following:

  • Apache 2.2
  • PHP 5.3, 5.4 or 5.5
  • MySQL 5.1
  • ImageMagick 6.6
  • Jhead 2.8x

Other versions may work as well, see below for more details. How to install these applications and get them to work together is depending on your OS and distribution. Check the documentation of the application and/or your distribution for details.


  • Current versions of Zoph are developped on Apache 2.2.x
    • 2.0.x probably works too, but is no longer tested.


Current versions of Zoph are developped on PHP 5.4

  • PHP 5.2 and older are no longer supported
  • PHP 5.3 should still work

Required features[edit]

  • The following features (extensions) to PHP are required for Zoph. Not all distributions automatically install all of them.
    • session
    • mysql
    • pcre
    • gd2
    • exif
    • xml
    • pear (if you want to use the e-mail features)
    • APC
    • FileInfo

php.ini settings[edit]

Settings you may need to change in php.ini:


This is the time Zoph is allowed by PHP to spend waiting for the file to be uploaded. Depending on the size of your files and the speed of your server's connection, 30 seconds (the default) is usually enough to process single images, if you are uploading zip or tar files, you may want to increase this to 60 or 120 seconds.


This is the time Zoph is allowed by PHP to run. Depending on the speed of your webserver, Zoph could spend quite a lot of time resizing an image. 30 seconds may not be enough, especially if you have a camera with a lot of megapixels.


This is the amount of memory PHP allows Zoph to use. Especially if you have large images, the default (8 or 16 Megabyte) may not be enough. If you have sufficient memory in your server, setting it to 128M is perfectly safe.

  • If you are using the web importer you may need to increase the max_execution_time, upload_max_filesize, post_max_size and max_input_time in php.ini defined in php.ini. See MAX_UPLOAD on the Configuration page.
  • If you are using the watermarking feature, you probably need to increase the memory_limit setting. See WATERMARKING on the Configuration page.
  • The e-mail photo feature may require increasing the memory_limit setting. See EMAIL_PHOTOS on the Configuration page.

APC settings[edit]

The file upload feature of Zoph v0.8.2 and later uses the PHP APC extension to track upload progress.

apc.enabled = "1"


  • Current versions are developped with MySQL 5.1
  • MySQL 5.0 should work too
  • MySQL 4.0 and 4.1 may still work but are no longer supported.


  • Current Zoph versions have been tested against ImageMagick 6.7.x


  • Jhead 2.8x
    • Other versions probably work as well

Jhead is a handy little program that extracts the information stored in the Exif headers that are added by most digital cameras. Exif stores date and time plus a bunch of other info about a photo. Zoph uses Jhead to parse the header so you'll need to install it. You can download it from http://www.sentex.net/~mwandel/jhead/.


In order to be able to use Zoph, you will need a browser.

  • Zoph is being developped and thoroughly tested with Firefox 24.x
  • Zoph should work with all recent browser versions.
    • Please report a bug if it doesn't.
  • Older versions usually work, but layout may not be 100% ok.
  • Some features require Javascript support
    • You can turn off Javascript support in Zoph with the JAVASCRIPT configuration setting. Obviously features that require it will be disabled as well.
    • Zoph should work when Javascript is turned off in the browser, except if the Autocomplete feature is enabled, however, Zoph will detect this and warn the user to turn Autocompletion off (or Javascript on).