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.2 or 5.3
- 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.3
- PHP 5.2 probably works too, but v0.9 will be the last Zoph version supporting it. (this includes bugfix releases, v0.9.0.x, but not feature releases, v0.9.x)
- Zoph has not yet been tested against PHP 5.4
- PHP 5.0 and 5.1 are no longer supported
- PHP4 has been end of life since 31 December 2007. As of Zoph 0.8, PHP4 will no longer be supported by Zoph.
- The following features (extensions) to PHP are required for Zoph. Not all distributions automatically install all of them.
- xml (Zoph >0.7)
- pear (if you want to use the e-mail features)
- APC (Zoph > 0.8.2)
- FileInfo (Zoph > 0.8.2)
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.
The file upload feature of Zoph v0.8.2 and later uses the PHP APC extension to track upload progress.
apc.enabled = "1" apc.rfc1867="1" apc.rfc1867_prefix="upload_" apc.rfc1867_name="APC_UPLOAD_PROGRESS"
- 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 7.x.
- Zoph should work with all recent browser versions, this does not include MSIE6.
- Please report a bug if it doesn't.
- Older versions usually work, but layout may not be 100% ok.