获取Gallery2

如何在我的WEB服务器上安装Gallery2？

将Gallery2的文件复制到WEB服务器上的一个目录之下。此步骤包含有若干种方法：

最好的情况就是，你可以使用subversion直接在服务器上安装和更新Gallery2。但此方法的前提是你必须具有对服务器命令行的访问权限（ssh/telnet）。
还有一种最好的方法就是使用FTP或其他客户端软件上传gallery2.tar.gz或gallery2.zip归档。上传完成后在命令行（ssh/telnet）中或使用小型PHP脚本解压归档文件，解压命令的对应关系是：.tar.gz归档文件对应tar -xzf gallery2.tar.gz，而.zip归档文件对应unzip gallery2.zip。某些网络托管公司提供一个带有web文件浏览器的控制面板，它就可以用来解压归档文件。如果可以的话，此方法值得一试。
如果上述两种办法都没有的话，你就必须使用FTP程序将整个Gallery2归档文件的内容上传到web服务器上了。此过程相当耗时而且有可能会产生错误。在这种情况下，请在安装程序的系统检查步骤时特别留心，以确保没有文件丢失或被篡改。

拿到G2后，我该如何开始？

最好的起步点就是/gallery2/README.html（自述页面）。如果你想跳过此步并开始安装的话，你可以将浏览器指向/gallery2/install/。如果这是你第一次进行安装的话，最好访问一下README.html页面阅读一下数据库安装的相关指导。

安装G2有什么特别的要求吗？

Gallery2很多方面的要求与G1是一样的。一个WEB服务器，php和一些图像处理程序，你可能知道会需要这些东西…但G2要求一样新玩意儿，那就是数据库。目前，数据库的支持有MySQL 3,4，PostgreSQL和Oracle 9/10。其他的要求当然就是WEB服务器（apache，iis，zeus?），php（4或5）和一些图像处理程序包（netpbm，imagemagick，ffmpeg以及gd）。还有就是，你得有用来存放图片的地儿: )

我使用Fedora Core 6时无法在gallery中上传或查看图片。

目前在x86和x86_64下，GaphicsMagick整合包在Fedore Core 6上有些许瑕疵，创建缩略图的过程会导致分段错误。此Fedora的BUG有相关的细节参考信息（BugID 237803）。此FAQ页面将会在Fedora开发团队对此BUG进行评估并修正后进行相应地更新。这也会在Fedora Core 7中进行测试，并会适当地进行相应更新。

如何获取最新版本的Gallery2?

你可以从sourceforge下载页面中下载Gallery2最新的官方版本。官方发布整合包的频次一年顶多两次，因此它们可能不包含最新提交的特点和改进。
有两种方法来始终保持更新度，使用nightly builds或Subversion。
Chetan Sarva，Jesse Mullan和Gallery2.EU都提供nightly builds。
可以在此处查看有关Subversion的使用指导。你也可以在此找到有关TortoiseSVN的使用指导。

如需获取Gallery的SVN版本请参见下一大项。

我应该使用nightly builds还是Subversion？

这完全取决于你的偏好了。不过如果你觉得对Subversion很适应且不介意深入学习的话，我建议使用它。一旦你理解了Subversion的源码结构，更新之类的操作就如同打开G2目录输如"svn update"一样轻而易举了。

Subversion太占磁盘空间了！

Subversion为每个文件都保留一个备份，因此类似"svn status"和"svn diff"的命令运行起来很快，而且不需要网络。此方式的确加倍了磁盘占有率…如果你偏好"svn update"的便捷，不怎么使用status/diff的话，那就为此特色投一票，将来subversion也许会支持的。就现在的情况来说，我们提供一个名为svnSlim的脚本。

如何升级Gallery2？

参见：Gallery 2的升级

如何在我的网站维护或升级时禁止用户进行访问？

Gallery 2.1+ 具有特有的"维护模式（Maintenance mode）"。使用文本编辑器编辑你的config.php文件并对照此部分。它含有相关打开此模式的指导。实例设定如下（选用其中一行即可）：

 $gallery->setConfig('mode.maintenance', true);
 $gallery->setConfig('mode.maintenance', '/maintenance.html');
 $gallery->setConfig('mode.maintenance', 'http://myothersite.com/');

而网站管理者仍可以在维护模式下使用各类应用程序。

典型的升级步骤：

启用维护模式；
将新代码置入相应位置；
以管理员身份浏览网站，确保万无一失；
激活或配置任何你需要使用的新的模块/外观主题等；
关闭维护模式。

有关开发的特别说明

我很希望此特点能为G2所具有，这在计划中吗？

此特点有可能在计划之中。参看被请求的特点一览表。还可以在sourceforge中参看有关的特点请求。如果你的请求没有见于其中，你可以在sourceforge上发表该特点请求，或者你可以在G2开发论坛上开一个关于该特点的讨论贴。但如果你的请求已在列表之中，那么它可能需要很久才能付诸实现。因此，如果你或你所认识的人可以帮助我们进行G2的开发改进的话，还有请你们的协助！

我想自己编写模块，可以从哪里获得一些帮助呢？

你可以从G2开发初学者工具包。在此你可以获知我们团队的工作方式及从何处能获取必要的资料。第一个链接是G2开发者指南，这是你开始之前必读的内容。尽管并非面面俱到甚至有些过时的信息在里面，不过你读过之后，应该能大致"了解"我们的架构了。所有类别的API是使用phpdoc在代码中进行自解释（self-documented）的，它被解压至G2 API资料中（初学者工具包里的最后一个链接）。如果你使用Windows并困扰于Makefiles的生成的话，可以看看virshu的如何在Windows上建立Gallery2。

如何将G2整合到我的网站中去？

就基本的整合而言，你可以编辑外观主题模板来在页面的页头/页脚/菜单中显示Gallery2。请参看可视化整合指导以及外观主题和模板的相关资料。

就应用程序级的整合（嵌入的G2）而言，请参看整合相关指导和嵌入及整合论坛版块来看看现有的整合，或是讨论你的看法和问题。

我有linux编译方面的经历，而且曾注意到一些makefiles和其他看起来需要进行编译的东西…G2中有这个必要吗？

Makefiles只是对gallery2模块开发者而言的。如果你只是单纯地使用G2，就没有必要"编译"任何东西。对开发者而言，Makefiles将繁琐的工作自动化了，比如：

1) 从源语言文件（.po）生成编译过的翻译文件（.mo），
2) 从实体定义生成数据库架构， 
3) 生成界面以访问实体成员。

如何"删除" G2的数据？如何能够简便地清除/g2data和数据库？

如果你是手动删除数据库的，或某些文件你不可删除（比如，它们为web服务器用户所有）的话，你可能需要看看Bharat的清除脚本。你也可以将浏览器指向/gallery2/lib/support/或/gallery2/lib/test/tools，前者除dev包之外的任何包，后者为dev包的一部分。

G2安装程序也可以"清除"g2data目录。即，它会移除所有内容并再次添加进基本的结构，其下仅有空的下属目录。如果是这样的话，你要确保g2data目录下有一个versions.dat文件，接着继续到数据库安装步骤（Database Setup Step）（第五步），点击保存后，你就应该能看到"清除"选项了。

Gallery2的一般常见问题

G2可以在PHP安全模式下运行吗？

Gallery无法再安全模式下运行。你可以参看G2开发论坛的置顶贴中有关的深入探讨。还可以参看这里及这里来看看让G2运行于安全模式的相关尝试。总之，他们打算让G2先运行，如果可以在安全模式下运行，或是能够经过简单的修改就能在安全模式下运行的话，那早就可以了。

那么何为PHP安全模式呢？就官方的[PHP http://php.net/features.safe-mode 安全模式相关资料]来看："PHP安全模式尝试解决共享服务器安全性方面的问题。就结构上来说，在PHP层面解决此问题是欠妥的。但是对web服务器和OS的取舍就不太现实了，因此很多人，尤其是ISP用户，目前使用的是安全模式。"

如果你不知道什么是PHP或如何关闭安全模式的话，那么你就不太适合负责web服务器上Gallery的托管了。如果是这样的话，请联系你的webhost/ 服务器管理员来解决问题。

为何我不能上传大文件（1MB或2MB的文件）？

上传文件大小的限制不是由Gallery2决定的，而是PHP/web服务器的配置。Craig Goranson发了一份很有信息量的（但可惜此文主要针对Gallery1）邮件，就是关于如何解决此问题的。Marcel Beemster则将此文升华到了Gallery2的范畴，可以参见他的blog。

简单地说就是：管理员可以改变php.ini文件（PHP配置文件）中的upload_max_filesize和post_max_size 指令。你还可以在一个.htaccess文件中尝试覆盖系统默认设定。举个例子，你可将下面的句行加入gallery2/文件夹下的.htaccess文件中，这样就可以设置上传限制最大为10MB：

 php_value post_max_size 10M
 php_value upload_max_filesize 10M

这会导致在所有Gallery页面中出现"内部服务器错误"（error status 500)）。如果是在作出上面的改变之后出现此错误的话，请移除上述作出的改变。因为这表明你的webhost不准许在.htaccess中做这样的改变。

对某些用户有效的另外的办法：在gallery2/文件夹下添加一个php.ini文件，含有如下内容（请注意这里的区别，在此我们用的是= 而没有php_value）：

 post_max_size = 12M
 upload_max_filesize = 12M

此方法有可能奏效，但也可能无效。你可以浏览add items -> from browser page来检查一下这些改动是否改变了上传限制。

将"memory_limit ="的值设定稍大一些也可能有效。注意memory_limit没必要超过上传文件的大小。当使用GD作为图片工具包模块时，memory_limit所起的作用就更大了。相关此话题的更多信息可以在其他的常见问题中找到。

如果你使用的是Apache 2，尤其是使用类似RedHat操作系统时，你有必要编辑一下指令LimitRequestBody，此帖中有相关描述。将此指令设定为0（即LimitRequestBody 0），这将允许你（在达到upload_max_filesize 和/或post_max_siz之前—从上面的email链接中可获取更多信息）上传任意大小的文件。

Dreamhost的用户（也可能是其他主机用户）应当查找相应的指导来完成此事。就Dreamhost来说，他们提供一个wiki页面，用来具体描述解决办法，可以参看这里。我个人进行了测试，实际可行。这个办法说到底就是创建一个cgi-bin目录，复制cgi php处理器并将其设定为你默认的php处理器。他们也指导如何创建一个脚本用以保持php.ini和php.cgi的更新，但需要使用的你设定而不是他们的。

还有一种办法，就是使用ftp添加一个本地服务器上的文件夹，使用"Add Item" -> "From Local Server"选项。你可能需要重建该项目的缩略图。

PHP memory_limit – 为何出现这的错误：被允许的XxxB的存储容量被耗尽？

You are exhausting the available memory that PHP has access to. In php.ini there is a config variable named memory_limit that by default is set to 8MB. Edit php.ini and increase it to a larger value (restart Apache afterwards). If you don't have access to php.ini, you can add this line to your .htaccess file in your gallery2 folder. Usually, unless you are the owner of the server, you don't have access to change php.ini. If there is no .htaccess file yet, you can create one (it's just a text file with the name '.htaccess').

php_value memory_limit [new memory limit]

To change it to 24 MB, write:

php_value memory_limit 24M

If the .htaccess method does not work or if you get an internal server error after adding this line, remove the line from the .htaccess again. You can also try to change the memory_limit by adding the following line right after '<?php ' in install/index.php and in main.php:

ini_set("memory_limit","32M");

If there's no "memory_limit" parameter in your phpinfo page, then all PHP/Webserver processes are limited by the per process max memory limit. You'll have to ask an administrator to change the limit in this case. On linux/unix, you can check the limit with the following command in the shell:

ulimit -a

Or with PHP with a script check.php

<?php print system('ulimit -a'); ?>

gallery remote可用于G2吗？

应该是可以的，将gallery remote指向Gallery的基础URL。比如，我会将其指向 "http://my.gallery.domain/gallery2/"

注意：Gallery Remote不能用于Gallery 2.2.1 – iPhotoToGallery目前也不行...

Can I update from G1 -> G2?

Yes. The basic strategy is that you install and configure a copy of Gallery 2 right next to your copy of Gallery 1, then you use the migration module to import all your Gallery 1 data (users, albums, photos, metadata) into your Gallery 2. This will make a complete copy of your data in Gallery 2 and then you're free to delete your Gallery 1 install. It will even give you mod_rewrite rules that can redirect all your old Gallery 1 urls to the correct places in Gallery 2. If you don't have enough free disk space to migrate it all at once, you can migrate a few albums at a time.

Please refer to the detailed migration guide if you have any problems.

Where can I find NetPBM, jhead or ImageMagick binaries to use with G2?

You can find links to NetPBM and jhead on the Gallery Download Page. You might also find Image Magick binaries here. The ImageMagick binaries are installed on /usr/bin which is the default when you configure Gallery after the one-click install.

何处有适用于zip cart 模块的unzip/zip二进制？

你可以在这里找到它们，但切记这是不受Gallery管辖的第三方网站。

I customized a *.tpl file, but then removed it... but the customization is still showing up. Did I do something wrong?

If you remove a local/*.tpl file it won't switch back to the *.tpl file due to smarty caching. You can get it to switch back to *.tpl by clearing the smarty cache manually on the filesystem, running the Flush Templates task in Site Admin/Maintenance, using Cache Maintenance found in the /lib/support/ page or by doing 'touch filename.tpl' which causes the last change time to update.

How can I move my storage folder to another path?

Here's a step by step guide:

Before moving the directory, consider the security aspects and ensure that the new home for your Gallery data folder is outside the web-root.
Move the storage folder e.g. by using the move/rename feature of your ftp application, or a file browser in your webhost's admin panel or within the shell.
Verify that permissions on the directory and files inside are owned by the web server or writable (chmod 777)
Edit config.php manually. Update the line:

$gallery->setConfig('data.gallery.base', 'some/path'); 
(Replace 'some/path' with the correct value.)

Save config.php, and you're done.

How can I move my gallery installation from one folder to another?

Here's a step by step guide:

Deactivate and uninstall the url rewrite module if it's active (not just disable the rewrite rules, disable and uninstall the whole module in site admin -> modules (plugins in later versions)).
Move the gallery folder (move/rename it with an ftp application, a file browser or with a shell). If you choose to move gallery from a subdirectory to the root of your website, just move all files and directories that are in the gallery folder to the web root directory.
Edit config.php manually. If the g2data was within the gallery directory and you moved it, update the line:

$gallery->setConfig('data.gallery.base', 'some/path');

If you use a multisite install, you also have to update:

$gallery->setConfig('galleryBaseUrl', );

Save config.php, and you're done.

If you are using XCache or another php accelerator, you may need to clear your accelerator cache before the new settings will take effect. Old installation paths may still be present until they are cleared.

How can I move my gallery installation from one server to another?

Here's a step by step guide:

Backup your installation!
Upgrade G2 on the old server to the same G2 version which you plan to install on the new server.
Deactivate AND uninstall the url rewrite module if it is active because it will generate incorrect urls after your move.
Backup G2 on your old host. Backup the database and the g2data folder.
Copy the g2data folder and import the mysql database to your new host. You can skip copying the g2data/locks directory if you want.
If you're using MySQL and moving from a windows based server to a *nix (unix, linux, ...) based server, you will have to change each database table name from lower case (e.g. g2_albumitem) to a case-sensitive name (in this example g2_AlbumItem). See script 文件:CaseSensitiveTables.zip to automate this process a bit.
Install the gallery2 code (extract gallery2.tar.gz/zip) on the new host. It should be the same G2 version as you last used on the old host (that's why you did the upgrade in step 2.).
Have your webhosting partner change the owner of the g2data dir recursively (all files and folders) to the webserver user, unless php cgi + suexec is used. If you don't understand this instruction, forward it directly to your webhosting partner. The webhost has to do this only once, I'm sure they will do it. If they don't then make sure that the webserver user can write and delete files in this directory (chmod 777).
Don't copy the config.php from the old host to the new host unless you're willing to hand edit it. It's easier to just run the installer; browse to newhost/gallery/install/. Make sure you choose "reuse existing database tables" in the database step. Point the installer in the appropriate step to the g2data folder (which is now not empty). And finish the installer. If you choose to copy the config.php instead of running the installer you have to manually change:
- the g2data path
- galleryId (at the bottom of config.php)
- db name/user if needed
Go to G2 Site Admin and change all paths if needed. imagemagick, zip, netpbm, ... all modules that depend on external programs have to be tested and reconfigured. Make also sure that the mail function of G2 works on the new host.

How can I export data from one G2 to another G2 installation?

Unfortunately, there's no tool to export/import data from one G2 installation (source) to another (target). But there are a few methods that may solve your problem.

If there's no G2 installation yet on the target server, just copy your existing G2 installation to the target server. See the FAQ entry about moving a G2 installation from one server to another.
If the target G2 installation is empty or doesn't have much data yet, we'd recommend removing the target G2 installation completely, then copying the source G2 installation to the target server and then add your previous albums again, manually or with the recursive "From Local Server" method.
If both G2 installations are already populated with a lot of data, you can import albums/photos files only. Descriptions, keywords, user data, ... are lost, but it imports all albums with all items in the correct structure. You can also decide to only import selected albums and you can specify the target parent album: Copy the g2data/albums/ directory of the source G2 installtion to a directory somewhere on the server of the target G2 (but not into the g2data/ directory). In your target G2, go to "Site Admin" -> "Web/Server" and add the directory /path/to/source/g2data/albums/ as a local server upload path. Of course your path is different from this example path. Then go to back to the top album of your target G2 and click "add item" -> "From Local Server" and select the path you just entered in site admin. Select the albums you'd like to import and start the process. It will add all albums / photos recursively, that is, it adds them including all sub-albums etc. Once the process is finished, you can remove the /path/to/source/g2data.albums/ folder from the target server.

为什么随机图片或随机封面不遵循权限设置？如果这样的话，我私人相册中的图片如何得以显示？

权限是在一个项目接一个项目的基础上处理的，而不是在一个相册接一个相册的基础上。"album01"是私密的，并不意味着"album01/album02/image3"也是私密的。初衷就是如此设计的。但问题是界面中没有提及或对其进行任何解释。不过在未来会对权限UI进行改进的。

我使用NFS但Gallery无法运作，如何解决？

默认情况下Gallery2使用flock进行locking，而据悉，这在NFS中无法运作。你可以打开Site Admin/General然后调整为数据库locking即可。

Is it my imagination, or is G2 slower than G1?

You're probably not imagining it. There are three main areas where Gallery 2 is going to be slower. Gallery 2 uses a database for its storage. This means that even the most trivial operations require communication with the database to get answers. In comparison, Gallery 1 stores everything in fairly small flat files and it loads all the data into memory and then operates on it. For small Gallery installations on hardware that is 3+ years old, you're going to find that Gallery 1 runs a fair bit faster. However, Gallery 1 will not scale as effectively so as you start to get up to having 5-10K photos, you'll find that Gallery 2 is much more efficient. Having a database also allows other applications to interact with Gallery data, which is a big advantage over Gallery 1's proprietary data format.

Gallery 2 provides complete image security. If you restrict a photo based on its permissions, no outsider can get to it. This is in contrast to Gallery 1 that merely creates urls to images that an outsider could browse to, if he or she knew the url. However, this security comes at a performance cost. We are considering different approaches, including the possibility of allowing you to lower or remove this security threshold to increase your performance.

G2 is a much larger framework than G1. It's designed to be incredibly flexible and maintainable. This leads to having a lot more code and because of the nature of PHP, this causes pages to load a little slower. However, this also means that PHP accelerators like eaccelerator, ionCube PHPA, Turcke MMCache, Pear::APC, XCache, and Zend Accelerator (commercial) can effect very substantial performance increases when properly used in conjunction with G2. We recommend this option, if it's available to you (i.e. if you have full control over the php installation on your server). eAccelerator Windows Downloads.

Performance is an important factor to us. We have introduced caches at strategic places and are working on ways to improve all of the issues above to increase performance. It is secondary to making a fully featured product for now, but as we get closer to the official release date it will gain higher priority for the development team.

For further tips, be sure to check out Gallery2 Performance Tips.

Note: There's a known bug in the 2.0 release where if you import a large number of albums from Gallery 1, it can fail to optimize the permissions table leading to really bad performance (2-3+ second response times for a page load). If that happens, you can fix it. Just change any permission anywhere in your G2. You may have to do this a couple of times because each time you change a permission it has a 50% chance of re-optimizing your permission table. If you want to check the before/after, you can run this query

  select count(*) from g2_AccessMap;

Before and after the permission change. If the number of rows drops dramatically (like from 2000 rows down to 30) then you've fixed the problem.

When I upload an image, G2 doesn't seem to create sized images or thumbnails... also, when I enter an album for the first time it takes a LONG time to load. What is the deal, yo?

G2 has some fundamental differences from G1. In G1, thumbs and sized images were created at image upload. In G2, these items are not created UNTIL they are accessed/needed. This means that the first time you view a sized image or album, it may take a while for the images to be generated. Of course, subsequent visits should be much faster because they already exist. I believe there are also plans for the ability to generate the needed images at upload or when ever the user wishes, independent of viewing them for the first time. Update: There is now a check box present during import and upload that allows for the generation of thumbs/sized images right then. Using this will increase the time it takes to upload/migrate, but will take care of it immediately instead of when a user first requests the image.

求助，我在配置图像工具包（ImageMagick，NetPBM或ffmpeg）时遇到了问题。

首先- 配置询问路径并非询问gallery2模块的路径（不是指的这个gallery2/modules/imagemagick）。这些目录是G2中这些程序的界面而不是程序本身。你需要找到二进制并安装到系统上，确保它们都是可执行的，并在配置中输入有效的路径。参见： http://codex.gallery2.org/Installing_an_Image_Processing_Library

Can I change the timezone for dates/times displayed in G2?

Add a line like this in config.php before the ?> at the end:

 putenv('TZ=PST8PDT');

Replace PST8PDT with the appropriate timezone string. For more information about appropriate timezone strings, see this Wikipedia entry on Zoneinfo. For actual acceptable values, see this list on Wikipedia.

Can I rename main.php?

To use a different main php file after G2 is installed follow these steps:

Disable and uninstall the URL-rewrite module.
Copy or symlink main.php to the new filename.
- If you want index.php just remove/delete index.php and rename main.php to index.php
Add a line like this in config.php before the ?> at the end:

define('GALLERY_MAIN_PHP', 'filename.php');

As of 2.0-rc-2 you can also do define('GALLERY_MAIN_PHP', ''); to set the default document to / hiding all reference to index.php or main.php. You'll also need to set baseUri, the now second-to-last line in config.php, to '/' (for example for a domain-level install of gallery).

Can I install if my server only allows .php4 extension for php files?

If your system does not accept ".php" as an extension for PHP files and requires ".php4" then follow these steps:

Rename index.php, main.php, install/index.php and upgrade/index.php to end in php4 extension.
Browse to install/index.php4 and proceed with the install. Note the "Go to Gallery" link at the end of the install will not work.
After installation follow the steps in the FAQ entry above to change main.php to main.php4.
Optionally rename config.php to config.php4 and update end of bootstrap.inc to reference config.php4 (to protect config.php contents from being viewable via browser).
Now you should have a functioning G2.
To support upgrades, find this line in upgrade/index.php4:

 function generateUrl($uri, $print=true) {

Just after that line add:

 $uri = str_replace('index.php', 'index.php4', $uri);

And change upgrade/index.php to upgrade/index.php4 in main.php4.

Why don't you support PHP 5.0.3?

PHP 5.x versions older than 5.0.4 have a very important bug (bug id 32290). This bug affects object oriented software like G2, and the libraries that G2 uses (Smarty, ADOdb). We know of at least two features that don't work because of this bug (advanced search, publishxp). There may be many other problems, including data integrity issues.

Bottom line: PHP 5.0.3 has a grave bug. Gallery cannot reasonably work around it. Upgrading to PHP 5.0.4+ should resolve it.

If you must stick with PHP 5.0.3 you can remove the PHP version check that prevents you from installing G2 by changing a few code lines in install/steps/SystemChecksStep.class and upgrade/steps/SystemChecksStep.class. You can also fix the advanced search and publishxp, it's described in this forum topic.

如何备份G2？

一份完整的备份包括有'g2data'目录，数据库，/gallery/config.php和/gallery/.htaccess。注意：如果你不使用URL重写模块的话，就没有这个.htaccess文件。

如何备份我的数据库

My Gallery URLs begin with /v/ and /d/, why?

Gallery needs these prefixes (/v/, /d/, ...) to detect different types of requests. /v/ for album and photo "view" pages, /d/ for download URLs, etc. You can change this prefix in Site Admin -> URL Rewrite. You can even remove the prefix for the view pages (/v/). However, you should be aware that if you remove the /v/ prefix, you may no longer have top level albums which have the same name as one of the directories in the Gallery directory. In other words, creating a top level album "lib", "themes", "modules", "install", .. is ok when you have a /v/ prefix, but it will result in problems when removing this prefix. There's a maintenance task to check that there's no conflict like this in your Gallery (Site Admin -> Maintenance).

How can I use Gallery 2 Images in other Websites?

You would like to show your Gallery 2 images in another website or forum (bulletin board) or you would like to add a link on another website to a specific image / album of your Gallery 2.

For image links, right-click with your mouse on the image in Gallery 2 and copy the image address (most browsers offer this feature)
For links to a specific album / item in your Gallery 2, browse to the album / item and copy the address that is in the address bar of your browser (remove the g2_GALLERYSID= stuff, if there is any)
If you are wondering why the links look like main.php?g2_view=core.ShowItem&g2_itemId=35 for item links and main.php?g2_view=core.DownloadItem&g2_itemId=35 for image links: These links may look a little weird, especially the DownloadItem link since you'd expect that a image URL looks rather like album/image.jpg, but it is actually a image link. If you want nicer links that look more normal, e.g. image links that end with .jpg, then activate the Gallery 2 URL rewrite module. You can do that by logging into Gallery2 with the administrator account, then click site admin, then Plugins. At the top of the list you should see URL Rewrite, and on the right of that line, click on activate. Follow the on-line instructions from there. When you're successful, a green tick appears next to the plugin name.
There is a module that prepares image and item links for you such that you don't have to right-click etc. See: Preformatted URLs Module

How do I get updated items to show first in an album (like new items do)

Gallery疑难解答

出了问题该怎么办？

首先，将代码更新至最新版本是个不错的办法。它有可能已经经过修正了。其次你应该看看论坛中有无该问题已被解决的帖子。在论坛中使用查找功能或许能帮上大忙。如果仍没有解决的话，你可以到支持论坛中寻求帮助。在寻求支持的请求中提供尽可能多的信息会更好。

What information is required when I ask for help in the forums?

When you create a new topic in the support forum, please include the following information:

G2/system information: Copy'n'paste your G2 system information from "Site Admin -> Maintenance -> System information" (you have to click "run now" to get the system information).
Please add a link to your website / G2 installation in the forum topic.
A phpinfo link is also very often needed. To create a phpinfo page on your server, do the following:

1. On your desktop, create a new text file
2. Open the text file and copy'n'paste the following:
 <?php phpinfo(); ?>
3. Save the text file and rename it to phpinfo.php (or any other file with the extension .php)
4. Upload the file to your gallery2 directory on the server

Make sure your file integrity is intact (see instructions)
A description of the problem (and the steps to reproduce if it may be a bug)
The relevant error message and debug output.
For problems in the installer the debug output should be displayed.. post the error message at the top and look for the error near the bottom of the debug output.
For errors while using G2 you'll need to turn on buffered debug output in config.php and then look near the bottom of the output for your error message. If you're unsure where the error message is you may post a link to the entire debug output, but please don't post the entire thing.

Getting the error message from debug output is particularly important for ERROR_STORAGE_FAILURE errors, as this is the only way to get the detailed error message from the database.

You can activate G2's debug mode in config.php (instructions are in config.php, you have to change the $gallery->setDebug(false); line).

The more information you provide, the more likely we can help you and the faster the issue can be resolved.

How can I make sure that my installation files are all intact?

Browse to http://www.example.com/gallery/upgrade/index.php or http://www.example.com/gallery/install/index.php and advance to the System checks step. Make sure there are no warnings, and especially that the file integrity check passes (no missing / modified files). If there are missing / modified files, read this FAQ entry to fix it.

Even if Gallery has already been installed, you can access the upgrade/ or install/ wizard at any time. Just advance to the "System Checks Step" and don't go any further. This step will show a warning for missing or modified files in the "integrity check". If there is a problem, you can click on the "+" sign to see a complete list of affected files.

Thumbnails / resized images don't get generated properly, how can it be fixed?

Either you don't get any thumbnails / resized images at all or you get a "broken image" placeholder.

If you don't have any thumbnails / resized images at all, it means that there's probably no image toolkit module active in your G2 installation. G2 needs either the imagemagick, netpbm or GD module to be active to generate thumbnails and resized images.
- Please read: Installing an Image Processing Library
- Note: Imagemagick and netpbm both need an external binary application in addition to the G2 module. If the corresponding G2 module does not autodetect the path to your imagemagick / netpbm binaries, then it's most probably not available on your server. See the above link on how to get the binaries.
- Note: GD is either available in your PHP installation or not. If it works, make sure you have a large PHP memory_limit (> 16 MB), since GD is the only image toolkit in G2 that uses the PHP memory and not system memory. You will get broken thumbnails / resized images with GD unless the PHP memory_limit is large enough.
If you get broken thumbnails and resized images (e.g. 92x92 pixel resizes), it means image toolkit(s) are active in G2 but they fail to generate thumbnails / resized images successfully.
- Sometimes the image toolkit modules of Gallery need to be reconfigured (e.g. if your webhost changes something or if you move servers). Uninstall the image toolkit modules (imagemagick, netpbm, gd, ffmeg, jpegtran, dcraw, ...) and then install them again and try to activate them again. Note: Deactivating is not enough. You need to uninstall these modules.
- If you're using GD, then you probably need to increase the PHP memory_limit . The best sign that the memory_limit is the problem is if you get normal thumbnails for small images but broken / no thumbnails for large images (large in dimensions / filesize).
- Most often if that happens, one or more image toolkits don't work correctly on your system. Try installing another image tookit module for G2, another toolkit might work.
- If you have multiple image toolkits installed, try disabling all but one of the image toolkit modules. Then add a new image to G2 to check if it works now. If not, deactive this image toolkit and activate another one. Check again, etc.
- You can also try to just change the image site admin -> toolkit priority, which is available if more than one image toolkits are active.
- If activated, try to disable the Square Thumbnails module.
- There may be a bug in PHP. Try adding $gallery->setConfig('apacheSetenvBroken', 1); to your config.php to disable using the apache_setenv() function
- If everything fails: For netpbm and imagemagick, you can find out why it fails by looking at the debug output. Enable buffered debug mode and add a new item to G2 and look for "executing"..."Regular output:"..."Error output:"... in the debug output.
Once it works again, you can generate and fix the broken thumbnails / resized images with site admin -> maintenance -> Build all thumbnails/resizes
URL, "www" problem: If Gallery2 works OK when you navigate to (YourDomain.Ext) but fails with all broken images when you navigate to (www.YourDomain.Ext) then Deactivate AND Uninstall "Url Rewrite" in Admin Panel(Plugins). This seems to be host-dependent.

I changed the language but nothing happens, what's wrong?

G2 depends on the system it runs on to switch to other languages than English. G2 needs php with gettext support and each language you want to switch to in G2 needs to be installed on your system. If you have command line access (ssh / telnet) to the (unix, linux) server, you can query for supported languages by `locale -a`. If only "C/POSIX" is returned, no other languages are supported and you need to reconfigure the locales and then restart apache.

Also try several variants of locales corresponding to your language. For example, fr_FR.iso885915@euro seems not to be supported by G2 while fr_FR.iso88591 works fine. Also, if you have a language variant installed (ex fr_CA), make sure you also have the "main" language (ie fr_FR) installed on your system.

Also, there is a bug if you use Gallery2 with Drupal 4.6.x using the gallery.module module Look here for this issue (fixed in 4.7.x integration).

Why can't I install with MySQL 4.1 or higher?

If the installer gives you an error like "Client does not support authentication protocol" then the MySQL support builtin to your PHP is using an older password scheme than your MySQL database. See here for more information and a workaround to get you up and running without having to recompile or upgrade your PHP.

I get an error about "max key length" installing with MySQL?

If you see this error while installing the Core module:

Specified key was too long; max key length is 1000 bytes

then you need to switch the database character set to something other than utf8. Currently some indexes we use exceed this default MySQL limit if the charset is utf8.

I seem to be running into some sort of MySQL query limit, is there anything that can be done?

Some hosts setup a query limit on your MySQL database. This is usually a per hour limit and would be restored in time. Floridave believes that a reasonable value for this would be 50-70k, but some hosts might set it as low as 10k. See if your host will bump it up a little bit perhaps. A workaround is to create several users of the database and randomly use those users to connect:

http://gallery.menalto.com/node/42359#comment-160706

I get only a blank screen when trying to view my Gallery, what's wrong?

This can have various reasons. The first thing you should check is your PHP memory limit and other PHP configuration parameters. In most cases, G2 requires a memory limit of at least 16 MB, if you are using GD, it may require even a higher limit.

Please see:

How to display PHP errors?
How to check / increase the memory limit?
How can I view the error log of the webserver?
Always enable the 'buffered' debug mode first if there is a problem

When I click on item thumbnails, nothing happens, what's wrong?

Probably your PHP memory limit is too low. Increase your PHP memory limit to at least 16 MB. If the problem persists, you should activate immedate debug mode in config.php and report the problem in the forums.

Why do I see stray NetPBM and cmd.exe processes that never go away on my windows server?

If NetPBM is given a file that it can't support, it may try to put up a dialog box telling you about the error before continuing. Since your server can't display those error boxes, the rest of the image processing operations wait for you to click an "OK" button that you can't see. This may also result in G2 hanging for 30 seconds since it is waiting for the image processing to complete also. ImageMagick does not appear to have this problem.

What about the warning for missing & modified files in the installer & upgrader?

If there is a warning for missing or modified files in the installer or upgrader, you should take it seriously. Neither the install or upgrade process nor G2 as an application can work correctly with missing or modified files. Upload the modified / missing files again to your server until the warnings disappear. Possible reasons for missing / modified files:

Error during the FTP upload of the Gallery 2 files
Use of Winzip or other problematic archive programs to unarchive the Gallery 2 .zip.
There are reported issues for several unarchive programs on OSX

If you are a svn user, a warning for a few missing or modified files in the installer / upgrader systemcheck step is the norm. But if you experience any problems, this is surely one of the first places you should look into.

I get lots of "Warning: exec(): Unable to fork [cmd /c ...]" at the module's step in the installer for G2 (on the ImageMagick module) under Windows/IIS. Now what?

You need to give permissions for IIS to be able to read and execute the command interpreter ("cmd.exe"). Without it, Gallery won't be able to call external executables (like ImageMagick). Required steps:

1. Open a cmd-prompt with "Start", "Execute", then type "cmd.exe". Hit ENTER. 
2. At the prompt, type: 
C:\> cacls %COMSPEC% /E /G %COMPUTERNAME%\IUSR_%COMPUTERNAME%:R

This adds the "read" permission to the IIS-user for the cmd.exe. Close the prompt and then try activating the imagemagick module again. More Info

I use apache's mod_layout and notice some odd error messages, what is the problem?

If you use mod_layout with Apache, make sure it is disabled for gallery files. Gallery sometimes sends binary data back from a php file, so adding a header or footer to these requests will corrupt the data! Adding the following lines to your apache config file or your .htaccess should fix it.

# Disable layout header and footer for Gallery2 
LayoutIgnoreHeaderURI /path/to/gallery2/*.* 
LayoutIgnoreFooterURI /path/to/gallery2/*.* 
 
# PHP Gallery2 overide Layout 
<Directory /path/to/gallery2/> 
LayoutHeaderOff 
LayoutFooterOff 
</Directory>

How to set/use Gallery in debug mode?

Edit your config.php and turn on buffered debug mode like this:

$gallery->setDebug('buffered');

Then try again. This time, you'll get quite a lot of debug output when you get the error. Look towards the bottom of the debug output and scan backwards for anything that looks like an error, then report that in the support forums. Usually that will give us enough information to work with. If you can't understand what you're seeing, err on the side of posting more info. If it's going to be more than 30-40 lines of output, you should save it into a text file and publish it on your own website and post a link to it here (so that the forum remains readable).

Where I should see dates I see "Wrong charset, cannot convert" or "Illegal character encoding" or "Illegal recode request".. what is wrong?

Some operating systems report invalid character sets to PHP leading to errors when trying to convert system-generated content (like day/month names in dates) to UTF-8. Work around this problem by placing the following in config.php:

$gallery->setConfig('systemCharset', 'ISO-8859-1');

Replace 'ISO-8859-1' with the appropriate character set for your system (other popular charsets include 'UTF-8').

An invalid locales config normally causes uploads to fail, with the Upload Applet error message Upload error: Upload failed: ". after each uploaded item and the From Web Browser just uploads one item with the status message Successfully added 1 file.

Note: For Gallery versions before Gallery 2.1, use the following instead of $gallery->setConfig():

require_once(dirname(__FILE__) . '/modules/core/classes/GalleryCapabilities.class'); 
GalleryCapabilities::set('systemCharset', 'ISO-8859-1');

I can't install G2, what should I do?

So you tried to install G2 but you get an error, probably in the install core module step. See the list of frequent installation errors.

I get a blank page / a network/webserver error, what's wrong?

If you are using PHP 5.0.3 or earlier PHP 5 versions, this is probably because of a bug. Therefore, these PHP 5 versions are not supported by G2. Either change to PHP 4.1+ or to PHP 5.0.4+.

This bug should occur in advanced search, in the publishxp module and in other places of G2.

I can't login anymore, what can I do now?

"Your login information is incorrect. Please try again."

If you see this error message, either the username or the password that you've entered is incorrect.

If you don't remember your password, please use follow the "forgot password" link on the login page.
If you forgot your username please contact the admin such that the admin can look up your username in the database.

"Logins to this account are temporarily disabled due to multiple failed login attempts."...

Does it say your user account is "disabled"? (since G2.2)

Use the "Forgot Password" link on the login page to reactivate your account.
If the server's email system isn't working, please contact an administrator. Admins can use "login.txt" instead and fix email or reset the user account. See http://www.example.com/gallery/lib/support/index.php -> "Reset User Password" (since Gallery 2.3) which points to http://www.example.com/gallery/main.php?g2_view=core.UserAdmin&g2_subView=core.UserRecoverPasswordAdmin

"You must enter the letters appearing in the picture."

If you see this error message, then you either ignored the CAPTCHA image or you CAPTCHA is enabled but no image is shown.

Please enter the letters and numbers from the CAPTCHA image into the input field below and try to login again.
If no CAPTCHA image (= image with letters) is shown, then CAPTCHA isn't working correctly and you need to deactivate it manually.

"Incorrect letters."

This error message is shown if you didn't interpret the CAPTCHA image correctly.

Please enter the letters and numbers from the CAPTCHA image into the input field below and try to login again.

Other Login Issues

If you've upgraded from a version older than beta 4, please read the README.html. By clearing the cookie cache of your browser, it should be fixed.
If you just have changed the cookie path / domain settings in the site admin options, first delete the GALLERYSID cookie in your browser. If that doesn't fix it, or if you can login again but it shows the GALLERYSID parameter in all URLs even if you browse around in G2, you most probably entered wrong values for the cookie path/domain. If you can't login anymore, deactivate cookies in your browser and login in G2. Go to site admin and fix the cookie path/domain values.
If you're using a version older than Gallery 2.0 RC-1 and G2 is running on a IIS webserver older than IIS-6, upgrade to G2 to Gallery 2.0 RC-1 or later. We had to fix an IIS-5 bug with a workaround in Gallery because MS was unable to fix it in the webserver.

Progress bars don't work, what's wrong?

If you have this problem it may be difficult to tell unless you are familiar enough with G2 to know where to expect progress bars to appear. Examples are upgrader and G1 migrate.. if you don't see a progress bar at all or it just flickers quickly on the screen when the request has completed then PHP's output_buffering mode may be enabled. Check php.ini and make sure output_buffering is set to off and no output_handler is configured.

If you are running Apache it can be configured with the deflate or gzip module and this will buffer all the output also. You can check by going to http://www.whatsmyip.org/mod_gzip_test/ and putting in your gallery url and it will tell you if the deflate or gzip module is being used.

I get invalid urls with Roxen webserver, what's wrong?

You can try this patch.

I can't access G2 from my vHost or subdomain, what's wrong?

Probably you use the G2's short URLs which are generated by G2's URL rewrite module. If you have a .htaccess file in your gallery2 directory, this is the case. You have two choices:

Either access G2 only with one of the vHosts / (sub-)domains or
Don't use the URL rewrite module

And if you decide to use the URL rewrite module, you have to activate the module while accessing it from the correct / chosen vHost / (sub-)domain. To change it, access G2 from the URL which you used to install it. Deactivate and uninstall the URL rewrite module. Then access it from the URL that you prefer and install and activate the rewrite module again.

Technical background: When using the URL rewrite module, G2 has to store the path to the G2 main.php file in the database and in the .htaccess file. E.g. if the 'normal' URL is http://www.example.com/gallery/gallery2 it stores '/gallery2' in the .htaccess file and in the database. If you then want to access it from a vHost that points directly to the gallery2 directory, e.g. http://mygallery.com/, then it would generate wrong redirects and URLs since G2 still assumes it is installed in a subdirectory '/gallery2' of this domain. You may notice that this doesn't apply to two different domains which have the same webroot.

I get "Notice: Only variable references should be returned by reference in ", what's wrong?

Most probably you are running PHP 4.4.0+ and use the PHP Zend Optimizer (see phpinfo). This is a Zend Optimizer bug. See http://gallery.menalto.com/node/36605#comment-133101 for some explanations.

Solution: Use a newer Zend Optimizer version, e.g. ZendOptimizer-2.6.2 or later versions.

If you run PHP 4.4.0 but don't use the Zend Optimizer, then most probably you're using a G2 version which is older than G2 Beta 4. You should upgrade to the latest stable release of G 2.0.

If you or your host is unwilling to disable or upgrade the Zend Optimizer to a fixed version or change the PHP version, there's a workaround (solution discovered by Mark Scott, 13/10/2005, "I've found that removing optimization pass 1 removes the notices caused by optimizing away the variable that should be referenced and returned.") In php.ini replace:

zend_optimizer.optimization_level=15

with:

zend_optimizer.optimization_level=14

You can also just suppress all PHP warnings but there's no guarantee that G2 actually works as expected:

/* in index.php, main.php and install/index.php */
error_reporting(E_ALL &~ (E_NOTICE | E_WARNING));

MySQL "Client does not support authentication protocol" error

The reason for this is explained and several solutions are presented on this page: MySQL Reference Manual: A.2.3. Client does not support authentication protocol. Specifically, look for the instructions after:

Reset the password to pre-4.1 style for each user that needs to use a pre-4.1 client program. 
This can be done using the SET PASSWORD statement and the OLD_PASSWORD() function:
mysql> SET PASSWORD FOR 'some_user'@'some_host' = OLD_PASSWORD('newpwd');

Gallery Remote can't find my G2, what's wrong?

Possible reasons (GR = Gallery Remote, G2 = Gallery 2):

You need to activate the "remote" module in G2. See "Site admin" -> "Modules". If it isn't listed, download the module separately from the G2 Download Page. The module must be installed and activated
You used Gallery 1 before you switched to G2 and you still have the "gallery_remote2.php" file in your gallery2/ folder. Delete it.
You're using a proxy to connect to the internet. GR has problems with proxies.
Your G2 is embedded in another application and you use mode.embed.only = true in config.php. In G2.0.x, it works only mode.embed.only = false.
You have a very old version of GR. Download and install the latest stable release from the Gallery Download Page.
When you connect with your web browser to http://www.example.com/gallery2/gallery_remote2.php you get a nice-looking page that says the page is not found. See the [GR FAQ].

Publish XP shows a "web services error", what's wrong?

If this error shows up when trying to login to your G2 in the Publish XP wizard, then you probably have a problem with cookies in Internet Explorer. Delete the cookie cache in Internet Explorer and then start Publish XP again.

G2 doesn't accept the upload path that I define!

Two common "mistakes" when you don't have a dedicated -nix server.

If you're running G2 on a Windows machine, start the path with the drive letter (e.g. c:\ )
If you are on a shared host of a -nix machine, make sure that you give the full path of the directory on the server, not just the path of your share of the host. Check out this post for an example: http://gallery.menalto.com/node/37060#comment-135509

-nix server: When using a screen highlighting copy/paste action it's quite easy to inadvertently grab a preceding space (ie in front of the /home/). It can almost drive you to drink chasing apparently 'unaccepted' permissions...

Images don't show up and the album / photo links don't work, what can I do?

Possible reasons:

G2's URL rewrite module is active but doesn't work correctly. Fîx:

Put G2 into maintenance mode
Browse to http://www.example.com/gallery/main.php?g2_view=core.PluginCallback&g2_pluginId=rewrite&g2_pluginType=module&g2_command=deactivate

(replace www.example.com/gallery2/ with the URL of your own Gallery2 installation)

For versions before G2.2, use this URL instead: http://www.example.com/gallery2/main.php?g2_controller=core.AdminModules&g2_moduleId=rewrite&g2_action=deactivate

If you get a Error (ERROR_PERMISSION_DENIED), then you're not logged in into your G2 and thus can't access the admin pages. In this case you have to login first and then use the above link. If the login view doesn't work, you can try to login manually with http://www.example.com/gallery/main.php?g2_controller=core.UserLogin&g2_form[formName]=UserLogin& g2_form[action][login]=Login&g2_form[username]=admin&g2_form[password]=secret (replace "secret" with your own password)

If you still get an error (ERROR_MISSING_OBJECT), go to http://www.example.com/gallery/lib/support/. Click the "Cache Maintainance" link, and clear all your db caches except for g2data/cache/derivative. Then, try the login link above, and finally, the deactivation link above that.

Your webserver is not properly configured and returns not the correct values for HTTP_HOST / HTTP_X_FORWARDED_SERVER

You can find out whether this is the case by looking at the http://www.example.com/gallery2/lib/support/phpinfo.php page, look for the values of HTTP_HOST and HTTP_X_FORWARDED_SERVER. If HTTP_X_FORWARDED_SERVER is missing, that's fine. If HTTP_X_FORWARDED_SERVER or HTTP_HOST have another value than the real host name (the part after http:// of your G2 URLs), then this is a problem.

If you or your admin can't change the webserver configuration (hostname in httpd.conf for HTTP_HOST for apache webservers) such that it returns a correct value, you can hack modules/core/classes/GalleryUrlGenerator.class function getCurrentDomain() to return the correct value or to ignore HTTP_X_FORWARDED_SERVER, what ever you need.

How can I change the default theme when I can't reach site admin?

If you have more than one theme active and your current default theme doesn't allow you to access site admin -> themes to change the default theme (for whatever reason), then you can try to change the theme back to matrix, the official G2 theme, with the following URL: http://www.example.com/gallery2/main.php?g2_controller=core.AdminThemes&g2_form[action][saveDefaults]=1&g2_form[default][theme]=matrix

(replace www.example.com/gallery2/ with the URL of your own Gallery2 installation)

This will only work if you are already logged in as administrator. See another FAQ entry on how to manually login if the normal login method doesn't work anymore.

install/index.php is blank or shows an error. What's wrong?

This can have several reasons.

If the page is blank and you're using PHP 5.0.5, then you need to change the PHP version. See PHP bug 34635
If you get something like "Warning: session_start():"... then your PHP is misconfigured. You probably need to set session.save_path correctly (on linux / unix "session.save_path /tmp" is a good choice). And / or you need to configure the session.save_handler correctly ("session.save_handler files" is a good choice). These settings are in php.ini of your PHP installation and you need to restart the webserver after the changes. You may be able to set the necessary PHP session variables without altering your main php.ini file by placing configuration directives in your Gallery directory's .htaccess file (Reference).
Else: Make sure you run PHP 4.1.0 or a newer version and make sure PHP is actually used for .php files on the webserver.

I receive a database setup error using MySQL 5.x on Windows, what can I do?

If you're using MySQL 5.x on Windows and you can't get past the Database Setup Step in the installer and get a message like

The database privileges test did not complete successfully.
Failed to create a DB test sequence.Check the returned error message and README.html for missing privileges and clean up the database.

Then you most probably have a MySQL InnoDB Engine issue. To resolve it, try: Delete BOTH your MySQL DATA and LOG files at the same time and restart the server.

Step 1. Stop MySQL service
Step 2. Delete files (your paths may be different):

C:\Program Files\MySQL\MySQL Server 5.0\data\ib_logfile*
C:\MySQL Datafiles\ibdata*

Step 3: Restart MySQL service

If that doesn't work for you, change your default MySQL engine from "innodb" to "myisam" in your mysql configuration. Thanks to G2 users bzink5 and tippex for the solutions. The issue is dicussed in a forum topic.

The installer does not accept my login.txt, what's wrong?

There can be several possible reasons why you may not pass the authentication step of the installer:

Make sure you created / uploaded the login.txt file in your Gallery 2 folder on the webserver (the parent folder of the install/ folder) and nowhere else
Make sure this login.txt contains just the authentication key (a 1 line string)
If you can pass the authentication step but loop / fall back to step 1 after advancing to step 3 or higher, then you should use a nightly snapshot / release newer than 2005/11/17 since cookieless installing was broken for a short period before this date (inproper PHP session configuration values can also lead to cookieless browsing)
Make sure your PHP session.save_handler is set to "files" and not to "user" (or "mm"). In development builds since 2005/11/27 or since Gallery 2.1, you shouldn't have to worry about this setting (unless PHP ini_set / ini_get are disabled in your PHP installation). You can check these PHP configuration values in a phpinfo page on your server.
Try clearing your browser cookes. In some cases there might be conflicting cookies when several applications are installed on the same host and clearing the cookies ensure that Gallery gets a clean slate to work with during installation (This issue should be fixed in 2.2.1).

Movies are not playing in my Gallery, why?

Problem	Solution
A movie is not playing in Firefox but it plays in Internet Explorer	Probably you're dealing with a .avi video. Microsoft has not supported Windows Media in FireFox until recently. You have several options to fix this: Either install the WMP plugin for FireFox WMP in FF Or install an alternative video player like VLC Or change the 'mime settings' of QuickTime Player to play .avi files as well.
When the apache2 mod_deflate module is enabled, movies most likely don't start playing in Internet Explorer (and possibly also in other browsers). The Apache2 RemoveOutputFilter directive removes any output filter associations for files with the given extensions. This allows .htaccess files in subdirectories to undo any associations inherited from parent directories or the server config files. The extension argument is case-insensitive, and can be specified with or without a leading dot. More info on this: Apache2 documentation	Put a '.htaccess' file in your g2 root directory with the following line in it: RemoveOutputFilter wmv avi mpg mpeg Note: if the .htaccess file already exists, add this line at the beginning Note: add additional extensions as needed
Without the ffmpeg module active, movies are not playing inline, you only see a Download link.	Go to "edit movie", and set movie dimensions manually. If dimensions aren't set, the embedded movie player feature will not work for this item.
Movie dimensions are set in Edit Movie etc but you only see the Download movie link.	Your browser isn't configured to play movies embedded in the browser. You need to configure Firefox/Internet Exploret/ to play movies embedded in the browser (browser plug-ins).

I have changed the default theme and nothing works anymore. How can I switch back?

Use phpmyadmin / your mysql shell to execute the following query to change the default theme back to the matrix theme:

UPDATE g2_PluginParameterMap SET g_parameterValue = 'matrix'
WHERE g_pluginType = 'module' AND g_pluginId = 'core' AND g_parameterName = 'default.theme';

Afterwards, delete the db cache by browsing to http://example.com/gallery2/lib/support/, enter your password, click there on cache management and delete the db and template cache. Of course you need to replace example.com/gallery2/ with the actual address of your Gallery.

I get a warning for missing themes / modules in the upgrader, what should I do?

Probably you chose the wrong package for your upgrade. Only the full package has all official themes and modules. Another reason could be that you were using non-official / 3rd party modules / themes and you forgot to keep them in your modules/ or themes/ folder.

If the themes / modules that are missing are official ones, you can download them from the Download Page.
For 3rd party / non-official themes, please check the User Contributions page for the latest version of your modules / themes

If you can't get the latest version of a specific module / theme and nothing helps, the following SQL query can help you to get at least through the upgrade wizard:

delete from g2_PluginMap WHERE g_pluginId = 'PGtheme';

If a theme that is now unavailable was used as default theme or for one of your albums specifically, you will also have to update the g2_PluginParameterMap database table to change the default theme, e.g.

 UPDATE g2_PluginParameterMap SET g_parameterValue = 'matrix' where g_pluginId = 'core' and g_parameterName = 'default.theme';

And do the same for specicic albums (set the g_theme = NULL in the table g2_AlbumItem for those rows that have a theme that is no longer working in your G2.

If after removing incompatible modules you see errors when editing items in your Gallery like this:

in modules/core/classes/helpers/GalleryFactoryHelper_simple.class at line 208 (gallerycoreapi::error)
in modules/core/classes/helpers/GalleryFactoryHelper_medium.class at line 59 (galleryfactoryhelper_simple::newinstance)
in modules/core/classes/GalleryCoreApi.class at line 124 (galleryfactoryhelper_medium::newinstancebyid)

, check the g2_FactoryMap table in the database for references to the removed modules.

If this still don't solve your problem, a last resort would be to delete the cache directory located inside your g2data directory (this is where all the photos are stored so don't go and delete the folder album!!! Just the one named cache)!

I get Out of memory error when trying to crop a thumbnail, what should I do?

To crop the thumbnail for a very large image you may need to increase the memory limit for java. Java needs a parameter like -Xmx512M (this sets the limit to 512MB). In windows you can add this parameter in Control Panel / Java / Java tab / View.. for Java Applet Runtime Settings / Java Runtime Parameters.

I get the error 'Illegal mix of collations', what should I do?

If you get the error

Illegal mix of collations (latin1_swedish_ci,IMPLICIT) and (utf8_general_ci,COERCIBLE)

then you are probably using a buggy MySQL version. MySQL 4.1.16 and later as well as 5.0.17 and later have this bug fixed. Please see: http://bugs.mysql.com/bug.php?id=10446 . If you get this error during upgrade from G2.0.x or older to G2.1 or newer, please see: MySQL Upgrade Issue - UTF-8.

I enabled mod_rewrite, but it's not working, and now I can't get back to disable it - how else can I do this?

You have to modify the database manually. (You can use some web based tool do it, e.g. phpmyadmin) Login to your g2database, choose (g2_)PluginMap table. Here you have to modify the line of the rewrite module to deactivate it. To do this you can either: - manually select the line where g_pluginId is "rewrite", and turn the value of the g_active column into 0. or - run the following sql query:

UPDATE g2_PluginMap SET g_active=0 WHERE g_pluginId='rewrite';

After this, you might be ready, but you might also need to flush the cache manually. This can be done by visiting http://yourgalleryurl.com/lib/support/ and choosing the "Cache Maintenance" option. If you couldn't access this directory either, go inside your g2data/cache folder on your server, and delete everything inside it, except derivatives dir.

I get ERROR_STORAGE_FAILURE when adding new photos or creating albums, what should I do?

In a mysql database this could be a problem with the g2_SequenceId table. To fix this in phpMyAdmin, find the g2_SequenceId table and click "Browse" to see the rows. If there are multiple rows click "Delete" for each row except the one with the largest value. If there is a single row then click the "SQL" button in the very upper left.. in the popup window type:

 select max(g_id) from g2_Entity

and click Go. Find the largest id in the query results. Now go back to "Browse" for g2_SequenceId and click "Edit" for the one row there. Change the value to be one larger than the maximum id reported in the query. Note that the errors received previously may have left directories and files inside your g2data/albums directory that are not displayed by Gallery. To complete the cleanup from this problem the items not shown when browsing the gallery as a site admin should be removed (backup first!).

The error can also occur if your mySQL is configured to only allow a certain amount of updates each given interval. The actual mySQL-error is 1226: User 'xxx' has exceeded the 'max_updates' resource (current value: xxxxx), but it's this ERROR_STORAGE_FAILURE that is shown in Gallery2. The only thing you can do is to clean up (like it's explained above) and wait untill you can send update to your mySQL-server again.

If the error occur while displaying the gallery, check if you don't have any dead mysql process by stoping mysql and looking with ps -ef. If yes, simply kill the processes with kill -9 and start mysql.

I get a ERROR_PLATFORM_FAILURE, what should I do?

Most probably the filesystem permissions for your G2 storage folder (usually 'g2data') are incorrect. See: How can I fix the filesystem permissions of the Gallery storage folder?. In some cases the host has moved some files around and the G2data folder is in a different place. Verify that the correct path to the G2data directory in config.php.

    $gallery->setConfig('data.gallery.base', '/Verify/this/path/to/g2data/');

How can I fix the filesystem permissions of the Gallery storage folder?

Usually you get either an ERROR_PLATFORM_FAILURE or the upgrade wizard reports that the filesystem permissions are wrong for your storage folder, i.e. it can't write to all files and subfolders in that folder anymore.

To fix the problem, you can try the Fix the storage folder (make it writeable) tool in http://example.com/gallery2/lib/support/ on the Filesystem Permissions page. (This tool was added in G2.1.1), older versions don't have it.

You can also try to change the permissions to 777 (read & writeable for everyone) with your FTP program. If all fails, please ask in the forum for help such that we can verify that it is indeed a filesystem permissions problem. If it actually is one, you'll have to ask your webhost to change the filesystem permissions recursively for you (e.g. chmod -R 777 g2data).

What might help is removing all cached data from the storage folder. Please see: How can I clear cached data?

A common issue is:

Error (ERROR_PLATFORM_FAILURE) :
in modules/core/classes/GalleryTemplate.class at line 270 (gallerycoreapi::error)
in modules/core/classes/GalleryTemplate.class at line 200 (gallerytemplate::_initcompiledtemplatedir)

In that case, if the above suggestions do not help, please try to delete g2data/smarty/templates_c/ folder via FTP or whatever tool you use to upload / manage files of your website.

If the problem does not disappear or is reappearing after it has been fixed for a while, please ask your webhost whether there are any scripts that change the owner of the files to the account owner. This could be the culprit since files are not created / managed by your account, but by the webserver application. We also welcome you to consult the Gallery forums for further expert advice.

I get an error in the installation step 8 (installing core module). What's wrong?

This can have various reasons.

The most common one is the following:

 Error (ERROR_BAD_PARAMETER) : something/gallery2/modules/core/classes/helpers/../../../../themes/matrix/theme.inc

If you get this error, then something went wrong when uploading Gallery to your server.

Solution: Reupload the themes/ folder completely. At least themes/matrix/ with the files themes/matrix/MANIFEST, themes/matrix/theme.inc, ... is missing. You should then get to a clean state: Delete the storage folder (g2data/) and drop the Gallery database or just its database tables. By doing that you ensure that everything is exactly how it should be before Gallery is installed. Then finally you can install Gallery by running the installation wizard again.

Why do I get a MySQL "Can't connect to local MySQL server through socket" error?

This indicates that PHP cannot communicate with your MySQL server. Check to make sure that MySQL is running, and verify that it's actually on the server where you think it is. If MySQL is running on your local system try using the IP address for your host (which should be 127.0.0.1) instead of "localhost" for your database and see if that fixes the problem. For other diagnostics you can try, take a look at http://dev.mysql.com/doc/refman/5.0/en/can-not-connect-to-server.html

"Sucessfully" uploaded images show a thumbnail, but display a black page when clicked on

I suddenly got an "ERROR_LOCK_TIMEOUT" message, what do I do?

Are you doing multiple things with your Gallery at the same time? E.g. uploading a lot of images in multiple browser Windows at the same time? Then this could explain why one of the Windows gets this message, it's blocked by the other task.
If there is no concurrent operation, then maybe an old 'lock' is still lying around in the Gallery system blocking everything else.
- If you are using database locking (there is a setting at the bottom of 'Site admin' -> 'General' to switch between database and file based locking), then you can try to get rid of this old 'lock' by using phpMyAdmin to delete all rows of the 'g2_Lock' table.
- If you are using file based locking, you can try to clear the caches to get rid of that 'lock'. See: How can I clear cached data?

PHP FILE directive is not working correctly, what can I do?

Gallery depends on PHP's __FILE__ directive to return the absolute filesystem path of the current file. Due to a bug in PHP, __FILE__ returns a relative path in older PHP versions.

In most cases, you can fix the problem by convincing your webhost to upgrade the PHP version.
For some rare platforms, the bug still exists in the latest PHP version. In this case you need to file a bug report for PHP such that the bug gets fixed for that platform too. E.g. PHP 4.4.4 on SunOS 5.8 returns the filename without any path if any of the parent folders of your Gallery folder is not readable by the webserver user.

How can I clear cached data?

Gallery caches some data that doesn't change very often in its storage folder. This includes templates, data from the database and other things. To clear the cache in case something bad happened, browse to http://www.example.com/gallery/lib/support/index.php, enter your Gallery setup password, select "Cache Maintenance" and delete the caches. Usually, selecting all but the Thumbnails and resizes (derivative) cache is a good idea (repeat: do not select the Thumbnails and resizes cache for deletion, rebuilding it takes quite a while for large Galleries).

What is the webserver error log?

Your Gallery runs as a PHP application on a webserver and when there is a fatal error, e.g. due to insufficient resources (memory, diskspace, execution time, ..), there is no chance Gallery can recover since the web-server just terminates the request. Symptoms usually are:

Blank / empty pages in the web-browser or
Browser-specific error pages (not to confuse with the Gallery application level error pages which always show a nicely formatted error page) or
When clicking on a link, the page doesn't change at all or
The browser offers you to download the current page (main.php) or
You might see something like Fatal error: Maximum execution time of or other PHP errors or
HTTP 500 internal server error pages

Webservers usually save such error events in their error log. This is very helpful to diagnose problems since the error log usually contains more information than what the symptom might reveal.

Apache stores this log as a file. As a webhosting customer, you can usually view the error log in the administrative section of your website (cPanel, Plesk, ..). If you can't find it, please ask your webhost / administrator for help.

How can I upload a theme or module via FTP when I used the preinstaller?

If you installed Gallery with the Pre-Installer, you need to first open the modules/ and themes/ directory for access before you can upload a theme or module manually yourself.

Go to http://www.example.com/gallery/lib/support/index.php, sign in with your Gallery setup password and follow the "Filesystem Permissions" link.
Click on "Add a new module or theme (make modules/ & themes/ writeable)" to open up your themes/ and modules/ folders.
Now you can upload your theme or module via FTP.
Finally don't forget to "close" the themes/ and modules/ folders again on the "Filesystem Permissions" page.

Note though that since Gallery 2.2, you can fetch new modules and themes directly via the Site Admin -> Plugins page. No FTP is needed anymore (unless for modules and themes that are not in the available repositories).
For multisites, lib/support/ is only available since Gallery 2.2
lib/support/ -> "Filesystem permissions" is only available since Gallery 2.1.1a (not yet in Gallery 2.1.0)

How to display PHP errors?

When diagnosing a problem, you want to be sure that you notice all hints that there might be. That's why you need to ensure that PHP is configured to display and log errors in such cases.

Starting with Gallery 2.2, it suffices to put Gallery into its debug mode.
In Gallery 2.0 and Gallery 2.1 (including 2.1.2), the debug mode doesn't enable displaying PHP errors yet. You'll need to enable it yourself.
In rare cases, you also have to ensure that PHP errors are not just displayed, but also logged.

Also see: * How can I view the error log of the webserver?

By browsing to your Gallery's phpinfo page at http://www.example.com/gallery/lib/support/index.php -> PHPinfo, you can find all the configuration details of PHP we're interested in. And these are:

display_errors (we want it to be On or 1)
display_startup_errors (we want it to be On or 1)
log_errors (we want it to be On or 1)
error_log (it should be anything but undefined)
error_reporting (it should be 2047 or larger)
output_buffering (it should be 0 / Off)

You can ask your webhost to help you to put PHP into a configuration that is useful for debugging. Or you can open Gallery's main.php file in a text editor and replace:

 <?php

with

 <?php
 ini_set('display_errors', 1);
 ini_set('log_errors', 1);
 ini_set('error_log', dirname(__FILE__) . '/error_log.txt');
 error_reporting(E_ALL);

And then you need to put an empty textfile into your gallery folder and chmod it to 666 (give read+write permissions for everyone).

PHP errors, if any occur are then logged to that file.

Once you're finished with diagnosing and debugging your problem, you should remove those lines from main.php again and delete the error_log file as well.

How can I fix the problem with the Storage Directory Permissions reported by the Upgrade Wizard?

We check the filesystem permissions of your storage folder before we start the actual upgrade process. There are three common reasons that make this system check fail:

There is no versions.dat file in your storage folder. Fix: Create a versions.dat file in the storage folder.
How can I fix the filesystem permissions of the Gallery storage folder?
When installing Gallery, you maybe specified a relative instead of an absolute filesystem path for the storage directory. e.g. 'data', './data' or '../data/' when you should actually have entered '/some/path/to/data/' (Linux) or 'c:\some\data' (Windows). Since G2.1 we ensure that the path is stored as an absolute path, but if you are upgrading from an older versions you might have this issue. Fix: open config.php and change the data.gallery.base path to be an absolute path. Then run the system checks step again.

Upgrading a Gallery that has been installed with the Pre-Installer

See Upgrading a G2 that has been installed with the Pre-Installer

How can I deactivate a module when I am unable to login?

First, please verify that you can't login anymore. If you can still login, you can deactivate modules at site admin -> Plugins.

If that fails, you have to modify the database manually. (You can use some web based tool do it, like phpmyadmin).

Login to your g2database, choose (g2_)PluginMap table.
Here you have to modify the line of the module you wish to deactive, e.g. "captcha" for the CAPTCHA module.
Run the following SQL (NOTE: this is an example to deactivate the CAPTCHA module). You can do this even if you're using a web interface like phpMyAdmin, just click the "sql" tab.

UPDATE g2_PluginMap SET g_active=0 WHERE g_pluginId='captcha';
DELETE FROM g2_FactoryMap WHERE g_implModuleId='captcha';

Finally, clear the database cache.

What do I do if I get a "Database Error" screen?

If you move servers or hosts, it is possible that you may encounter a "Database Error" screen, with the text "An error has occurred while interacting with the database.". If you're using Gallery2 with MySQL, this may be caused by having a different MySQL client library on your new machine/server. To attempt a fix, editing your config.php changing the line

 $storeConfig['type'] = 'mysqli';

 $storeConfig['type'] = 'mysqlt';

WIKI使用导航

站长百科导航

站长专题

Gallery:常见问题

获取Gallery2

如何在我的WEB服务器上安装Gallery2？

拿到G2后，我该如何开始？

安装G2有什么特别的要求吗？

我使用Fedora Core 6时无法在gallery中上传或查看图片。

如何获取最新版本的Gallery2?

我应该使用nightly builds还是Subversion？

Subversion太占磁盘空间了！

如何升级Gallery2？

如何在我的网站维护或升级时禁止用户进行访问？

有关开发的特别说明

我很希望此特点能为G2所具有，这在计划中吗？

我想自己编写模块，可以从哪里获得一些帮助呢？

如何将G2整合到我的网站中去？

我有linux编译方面的经历，而且曾注意到一些makefiles和其他看起来需要进行编译的东西…G2中有这个必要吗？

如何"删除" G2的数据？如何能够简便地清除/g2data和数据库？

Gallery2的一般常见问题

G2可以在PHP安全模式下运行吗？

为何我不能上传大文件（1MB或2MB的文件）？

PHP memory_limit – 为何出现这的错误：被允许的XxxB的存储容量被耗尽？

gallery remote可用于G2吗？

Can I update from G1 -> G2?

Where can I find NetPBM, jhead or ImageMagick binaries to use with G2?

何处有适用于zip cart 模块的unzip/zip二进制？

I customized a *.tpl file, but then removed it... but the customization is still showing up. Did I do something wrong?

How can I move my storage folder to another path?

How can I move my gallery installation from one folder to another?

How can I move my gallery installation from one server to another?

How can I export data from one G2 to another G2 installation?

为什么随机图片或随机封面不遵循权限设置？如果这样的话，我私人相册中的图片如何得以显示？

我使用NFS但Gallery无法运作，如何解决？

Is it my imagination, or is G2 slower than G1?

When I upload an image, G2 doesn't seem to create sized images or thumbnails... also, when I enter an album for the first time it takes a LONG time to load. What is the deal, yo?

求助，我在配置图像工具包（ImageMagick，NetPBM或ffmpeg）时遇到了问题。

Can I change the timezone for dates/times displayed in G2?

Can I rename main.php?

Can I install if my server only allows .php4 extension for php files?

Why don't you support PHP 5.0.3?

如何备份G2？

My Gallery URLs begin with /v/ and /d/, why?

How can I use Gallery 2 Images in other Websites?

How do I get updated items to show first in an album (like new items do)

Gallery疑难解答

出了问题该怎么办？

What information is required when I ask for help in the forums?

How can I make sure that my installation files are all intact?

Thumbnails / resized images don't get generated properly, how can it be fixed?

I changed the language but nothing happens, what's wrong?

Why can't I install with MySQL 4.1 or higher?

I get an error about "max key length" installing with MySQL?

I seem to be running into some sort of MySQL query limit, is there anything that can be done?

I get only a blank screen when trying to view my Gallery, what's wrong?

When I click on item thumbnails, nothing happens, what's wrong?

Why do I see stray NetPBM and cmd.exe processes that never go away on my windows server?

What about the warning for missing & modified files in the installer & upgrader?

I get lots of "Warning: exec(): Unable to fork [cmd /c ...]" at the module's step in the installer for G2 (on the ImageMagick module) under Windows/IIS. Now what?

I use apache's mod_layout and notice some odd error messages, what is the problem?

How to set/use Gallery in debug mode?

Where I should see dates I see "Wrong charset, cannot convert" or "Illegal character encoding" or "Illegal recode request".. what is wrong?

I can't install G2, what should I do?

I get a blank page / a network/webserver error, what's wrong?

I can't login anymore, what can I do now?

"Your login information is incorrect. Please try again."

"Logins to this account are temporarily disabled due to multiple failed login attempts."...

"You must enter the letters appearing in the picture."

"Incorrect letters."

Other Login Issues

Progress bars don't work, what's wrong?

I get invalid urls with Roxen webserver, what's wrong?

I can't access G2 from my vHost or subdomain, what's wrong?

I get "Notice: Only variable references should be returned by reference in ", what's wrong?

MySQL "Client does not support authentication protocol" error

Gallery Remote can't find my G2, what's wrong?

Publish XP shows a "web services error", what's wrong?

G2 doesn't accept the upload path that I define!

Images don't show up and the album / photo links don't work, what can I do?

PHP FILE directive is not working correctly, what can I do?