zoph  v0.9.16
About: Zoph is a web based digital image presentation and management system (photo album). It is built with PHP, MySQL and Perl.
  Fossies Dox: zoph-v0.9.16.tar.bz2  ("unofficial" and yet experimental doxygen-generated source code documentation)  

zoph Documentation

Some Fossies usage hints in advance:

  1. To see the Doxygen generated documentation please click on one of the items in the steelblue colored "quick index" bar above or use the side panel at the left which displays a hierarchical tree-like index structure and is adjustable in width.
  2. If you want to search for something by keyword rather than browse for it you can use the client side search facility (using Javascript and DHTML) that provides live searching, i.e. the search results are presented and adapted as you type in the Search input field at the top right.
  3. Doxygen doesn't incorporate all member files but just a definable subset (basically the main project source code files that are written in a supported language). So to search and browse all member files you may visit the Fossies zoph-v0.9.16.tar.bz2 contents page and use the Fossies standard member browsing features (also with source code highlighting and additionally with optional code folding).

Zoph 0.9.16 Readme



Zoph (Zoph Organizes Photos) is a web based digital image presentation and management system. In other words, a photo album. It is built with PHP and MySQL.

Many people store their photos in the digital equivalent of a shoe box: lots of directories with names like 'Holiday 2008', 'January 2005' or even 'Photos034'. Like shoe boxes, this is a great way to put your photos away, but not such a great way to find them back or even look at them. Zoph can help you to store your photos and keep them organized.

While most photo album projects are primarily targeted at showing your photos to others, Zoph is primarily targeted at keeping your photos organized for yourself, giving you granular control over what you'd like to show to others, on a per-album or even a per-photo basis.

If you just want to generate a gallery of thumbnails from a bunch of images, you may want to try one of the other numerous photo album projects. But if you want to also store additional information about your photos, search them, or control access to them, take a look at Zoph.


Read the the Requirements, Installation guide docs. In order to customize your Zoph installation, read the Configuration guide. If you are upgrading from a previous version, read the Upgrade Instructions document.

For full documentation, see the docs directory.


Zoph is free software. It is released under the GPL license. Please read the license file for more details


Please report issues via https://gitlab.com/jeroenrnl/zoph/issues


Zoph makes use of the following packages, for which I thank their authors for making available:

For a list of individuals who have contributed fixes, improvements or translations, click on the 'about' tab within Zoph.


GD library missing

I'm trying to use the importer from the web but I get this error:

Fatal error: Call to undefined function: imagecreatefromjpeg()

To use the importer you need the GD 2 library for image creation support in PHP. See the REQUIREMENTS doc for more info.

Moving photos on disk

I moved my photos around after I loaded them and now I see broken images. How can I fix them?

If you move images to a different directory you'll start seeing broken images in Zoph unless you also update the 'path' field in the database.

If you edit a photo, at the bottom of the page you'll see a 'show additional attributes' link. That will let you edit the path for a photo.

If you're moving a bunch of photos, you may want to just create a list of their names as you are relocating them and then change all the paths at once from within MySQL:

mysql> update photos set path = 'new_path' where name in ('photo1.jpg', 'photo2.jpg');

Why do I see some English phrases when I'm using a translation:

[vo] that have been categorized

Some language files are missing a few translations. Many, but not all, are shown in italics and preceded by [vo]. To fix this simply open the correct language file in the lang/ directory and add a transltions of the missing string (the English string should already be present in the file). Please share your changes, through an issue or fork + pull request.

Change width of Zoph display

Can I get Zoph to take up my whole browser window rather than that little rectangle?

Try setting Screen width in the configuration screen (admin -> configuration) to "100%".

Can I customize the name/title used in the interface?

Change Title in the configuration screen (admin -> configuration) This is what appears on the logon page, on the home page, and in the title of every page.

Changing text

I don't like your welcome screen, your instructions on the import page, or your use of English in general.

You could edit the templates so that Zoph says just what you want. A better alternative is perhaps to create your own custom translation. Create a file in the lang/ directory that maps English to English and tweak whatever phrases you want. For example:

Welcome %s. %s currently contains=Go away %s. %s isn't for you.


How do you pronounce Zoph?

I say Zoph with an O like in photos, some say Zoph like software ("Zophtware"), but you can pronounce it however you like.