编辑“Gallery:已知问题”

Please also take a look at the [[Gallery:faq|G2常见问题]].

==已知问题==

* '''ImageMagick 6.2.4''' – 此版本无法对图片加上水印效果（虽无任何错误报告，但水印就是无法显示在图片中）。变通的解决办法：升级ImageMagick或使用其他的工具包模块（例如NetPBM）。

* '''PHP 5.2.0RC2''' - G2无法与此候选版本相兼容（可能跟RC1也不兼容，但没有做过相关测试）。PHP中的bug已经被报告了，并在PHP 5.2.0最终版中被修复。[http://gallery.menalto.com/node/53400#comment-195998 RC2的解决办法]

* '''工具包优先级（Toolkit Priority）'''丢失 – 如果在站点管理或工具包优先级中的某些或某个工具包没有显示，或者工具包优先级链接没有显示的话，就请先禁用所有的工具包然后再重新激活它们。此bug已经被修复因此不可能再出现，但上面的重新激活的方法在修复已有问题时是必要的。

* MySQL上的'''Illegal mix of collations''' – 升级到MySQL 4.1.16（或更高版本）或5.0.17（或更高版本）就可以解决此问题：http://bugs.mysql.com/bug.php?id=10446

* '''Apache模块''' [http://gallery.menalto.com/node/29365 mod_security]，[http://gallery.menalto.com/node/27814 mod_dosevasive]，[http://gallery.menalto.com/node/42916 mod_speling]和[[Gallery:FAQ#我使用apache的mod_layout并注意到了一些奇怪的错误消息，这是什么问题？|mod_layout]]都需要经过特别配置才能在G2中运行。

* '''[http://selinux.sourceforge.net/ SELinux]'''也已知无法在沙盒外与G2运行。参见[[Gallery:SELinux服务器上的安装]]来获取更详尽的信息。G2用户'Komacke'似乎已经解决了此问题而且在同一台计算机上成功运行SELinux和G2了。参见[http://gallery.menalto.com/index.php?name=PNphpBB2&file=viewtopic&t=34561#162337 此帖]来看看可能的解决方案。对于数据库（如postgres）相关的SELinux问题请参见[http://gallery.menalto.com/node/51781#comment-192254 此帖]。碰上此问题的不止你一个，可以看看[http://gallery.menalto.com/index.php?name=PNphpBB2&file=viewtopic&t=31880 这个]，[http://gallery.menalto.com/index.php?name=PNphpBB2&file=viewtopic&t=31782 这个]，[http://gallery.menalto.com/index.php?name=PNphpBB2&file=viewtopic&t=33729 这个]和[http://gallery.menalto.com/index.php?name=PNphpBB2&file=viewtopic&t=31321 这个]。

* '''Microsoft [http://www.microsoft.com/WindowsServer2003/iis/default.mspx IIS]'''由于某个PHP/IIS的bug无法在Gallery2.2之后的版本中与'''PHP-CGI'''兼容。Microsoft推荐的是 FastCGI并不支持PHP-CGI。请使用mod_php或fastcgi。当然对于Apache来说你仍然可以使用PHP-CGI（以及mod_php或fastcgi）。

* '''PHP open_basedir + symlinks''' 目前无法运行。GalleryPlatform需要做少许改动，参见[[Gallery:How_to_configure_open_basedir_for_G2|如何为G2配置open_basedir]]。

* '''Too many open files''' – 在添加大量新项目时，你得到一个PHP警告提示：''Warning: fopen(/some/path): failed to open stream: Too many open files in...'' 以及一个G2错误：''ERROR_PLATFORM_FAILURE''。例如，[http://gallery.menalto.com/index.php?name=PNphpBB2&file=viewtopic&t=34333 此用户]就碰上了此类问题。

* '''McAfee安全中心'''，如果其Anti Abuse索引是打开的话就会拦截某些图片，尤其是G2的多站点安装。此功能关闭后，McAfee的自动更新可能会重新激活此设定。

* '''土耳其语设置下的PHP 5.x''' - PHP 5.x的此bug[http://bugs.php.net/bug.php?id=35050#c105582 无法被修复]，此bug会导致土耳其语设置下的G2无法运行。变通办法：使用PHP 4.x。

* '''Mac OS X上的安装会得到"Cannot redeclare class galleryutilities"的错误''' – 某些Mac OS X上的PHP版本的问题会导致G2安装程序中出现此错误。至少将Mac OS X升级到OS 10.4.x可能会解决问题。

* '''Fatal error: Trying to clone an uncloneable object of class mysqli''' – 如果出现了此错误，你必须关闭[http://php.net/ini PHP 配置]中的<tt>zend.ze1_compatibility_mode</tt>设定。

* '''Windows上的Mysql 4.0.15''' - Windows上的低于4.0.16版本的Mysql可能存在的某bug会影响G2，尤其是imageblock模块，[http://gallery.menalto.com/node/30045#comment-128211 此用户]就有类似的问题。

* '''改为AODdb的DB2驱动中的序列支持（SEQUENCE support）''' ADOdb的DB2驱动文件中的序列支持已被改进。取代了以往的单栏表格的使用，现在则使用的是一个实际的序列对象。由2.1.x转为目前（或今后）版本的SVN/nightly快照版中更新后的ADOdb文件会破坏现有的Gallery2数据库。
<toggle title="修复DB2数据库：">
** 阻止所有对象的新建（如，可以将Gallery转为维护模式（Maintenance Mode））
** 连接到GALLERY2
** 选择* FROM G2_SEQUENCEID（记下返回的数值）
** 创建SEQUENCE G2_SEQUENCEID，以value-from-table开头
** 清除TABLE G2_SEQUENCEID
** 选择* FROM G2_SEQUENCELOCK（记下返回的数值）
** 创建SEQUENCE G2_SEQUENCELOCK，以value-from-table开头
** 清除TABLE G2_SEQUENCELOCK
** 连接重置
** 取消Gallery的维护模式
有关DB2 V8中DB2 SEQUENCES的帮助信息。*请参见http://publib.boulder.ibm.com/infocenter/db2luw/v8/index.jsp
</toggle>

* '''Win98''' – win98上的Mysql可能会生成这样的警告提示：''Warning: (null)(): 1 result set(s) not freed. Use mysql_free_result to free result sets which were requested using mysql_query() in Unknown on line 0''，[http://gallery.menalto.com/node/33073 此用户]就看到过这样的提示。

* '''文件权限问题''' – 许多用户的某个g2data dir含有的subdirs/文件无法被web服务器写入。我们已在RC-1之后的系统检查中添加了一个文件权限检查。但问题仍未被解决，如果这一直是一个用户导错误（被移动的帐户，丢失的权限）的话或者文件/dirs被G2创建的话，那么它们本身就不具备写入权限。

* '''性能''' – 我们仍可以做些调整以使得其运行得更快。

* '''图片下载慢''' – 在下载看似完成后，某些配置（Debian/Apache?）可能在显示图片时有5到10的延迟。可以看看有关[http://sourceforge.net/tracker/index.php?func=detail&aid=1374610&group_id=7130&atid=107130 此bug]的详细信息以及对应的解决方案。如果你遇到了此问题的话，请在对应的tracker中添加一个有关你所使用系统的详细信息的记录。

* '''SMTP email错误''' - 如果在''站点管理（Site Admin）'' -> ''一般（General）''的email测试中发生了错误的话，其原因是很多样的。如果你在debug输出中看到''Server response: 550 Invalid greeting''的错误，那么这里有一个[http://gallery.menalto.com/node/43285#comment-164277 简便的解决办法]。如果是其他的某个错误而你又需要使用SMTP设定的话，请让某些SMTP设定留空。比如，可以不设定密码来尝试一下。请参阅[http://nemesis.lonestar.org/site/mail_trouble.html 发送邮件时碰上麻烦了？]。

* '''Error (ERROR_UNKNOWN) : Could not send mail to ...''' 在Linux上，在管理 > 一般下进行邮件发送功能测试时发生了此错误的话，请检查是否安装了sendmail（参见有关[http://www.php.net/manual/en/mail.configuration.php Php邮件配置]的详细信息）。请注意如果你无法发送邮件的话，那么某些模块就无法正常运行了（即：Registration模块由于email通知被禁用将无法运行）。

* '''使用[http://www.oracle.com Oracle]时，每页都出现错误''' – 如果你使用G2.1或以后的版本，那么所有G2页面上都会出现错误。因为g2_SessionMap数据库表格的g_data栏在Oracle配置中过短。解决办法：
** 截断g2_SessionMap表格；
** 修改g2_SessionMap表格，清除column g_data；
** 修改g2_SessionMap表格，添加(g_data CLOB)；
** G2现在就可以正常运行并且不发生错误了。如果你使用了此方案确实有效的话，请告知我们。目前我们尚无Oracle的相关测试者。

* '''添加ZIP格式图片或Picasa导入的错误''' – 许多用户报告当上传[http://www.winzip.com WinZIP]所创建含有子目录的ZIP格式归档文件时出问题。此问题时G2中的一个已知bug，因为WinZIP以一种不寻常的次序在ZIPfile中创建目录入口。G2.1中新的Picasa2模块也有同样的问题。在目前的CVS中，此bug已被修复，同样在2.1.1版本中也会被修复。目前的解决方案：
** 使用WinZIP以外的其他工具来创建归档文件，或
** 不要使用右键快捷菜单中的"Add to Zip..."选项-请使用WinZIP创建一个空的归档文件并手动添加进文件和子目录。

* '''使用IIS的DB2''' – 为了使'ibm_db2' PHP（PECL）扩展能够在Microsoft IIS服务器上运行，请参看PECL bug 8769（http://pecl.php.net/bugs/bug.php?id=8769）最下方的这一简单的解决办法。

* '''Opera8的用户/密码登录框中鼠标指针于图标之下''' – 在Gallery 2.1 + Opera中这些图标在右侧，我们通过Opera8中的textbox padding就能够修复某bug；在Gallery 2.2中，这些图标被重新回置到了作出，如在Opera 9中一样可行。

==安装错误==
参见我们有关[[Gallery:InstallationErrors|安装错误]]的页面。

==旧版本升级==
* '''MySQL的文本截断''' – 如果你的Gallery含有一些国际文字（元音变音字符，亚洲语系的字符或希尔里字符等）的话，那么Gallery升级将会阶段你的项目描述，评论以及其他文本—倘若你的数据库服务器在首次Gallery安装完成之后就进行过升级。有关此问题的更多信息见于：[http://sourceforge.net/tracker/index.php?func=detail&aid=1593272&group_id=7130&atid=107130 Bug 1593272].

* '''MySQL校验''' – 由较旧版本升级到G2.1或更新版本的第三步（核心模块升级）可能会由于某些用户发生的类似"Illegal mix of collations (latin1_swedish_ci,IMPLICIT)和(utf8_general_ci,COERCIBLE)"的错误而失败。要了解相关解决办法，请参看：[[Gallery:Known_Issues:MySQL_UTF8_Upgrade|MySQL的升级问题 - UTF-8]].

* '''登录问题''' – 在G2.0的beta-4版本之前，已知有登录/对话的相关问题了。对此问题的修复的必然结果，如果Gallery忽略了登录请求的话，你以及你Gallery的所有用户就必须删除浏览器中以往的GALLERYSID cookies。

* '''URL Rewrite的升级''' – 升级较旧版本的Rewrite（重写）模块会遗留下一个.htaccess文件，会导致与当前的代码不兼容。如果在升级之后无法看到缩略图或浏览子相册的话，请访问URL Rewrite站点管理并点击Rules标签上的Save（保存）来重新保存一下来更新.htaccess。

* '''Multisite（多站点） config.php''' – 多站点系统改变了，因此旧式多站点的config.php文件就不再被支持。请按照以下步骤将你的站点移至新的系统上：
** 将所有多站点支持的符号链接（symlink）替换为真实的目录并/或移除所有用于将多站点目录的请求重新定向到Gallery2代码库的.htaccess文件。
** 检查你的config.php文件并了解其构造基础。你会发现以 <tt>&lt;?php</tt>开头并以<tt>?&gt;</tt>结尾的多个完整的单独配置，在其上，其下及中间都有额外的内容。
** 将组合文件中的每个配置都复制到单独独立的文件中去。所有新文件中头一行的都应为<tt>&lt;?php</tt>而最末行则应是<tt>?&gt;</tt>，其中不能包含有空格或在首尾有空行，而且这些标记都应唯一。在对应站点的多站点目录中置入新建的单独独立的config.php文件。组合文件中每个配置前的<tt>case 'domain/path':</tt>这一行会让你确定哪个config.php应该放置到哪个对应的多站点，目录之下。注意，请勿将"case"这一行写入新建的config.php文件中。组合文件中的最后一个配置其上是<tt>default:</tt>而不是前面提到的"case"。将组合文件重新命名，并将该最后的配置归位到此目录下config.php的所在位置。
** 现在访问主站并运行升级程序。请保证此站能够正常运行。
** 对于额外的站点，请遵照以下的步骤：浏览主站的install/index.php。在第三步中输入多站点目录的路径来进行升级。此步骤完成后，你应能在多站点目录下看到一些新文件了，包括有<tt>upgrade/index.php</tt>。此时<i>停止</i>使用安装程序并浏览该站（非主站）的<tt>upgrade/index.php</tt>。接着继续到升级程序的核心模块升级步骤。在核心升级完成之后，为该站手动编辑config.php。在该文件的底部你会看到一个<tt>galleryBaseUrl</tt> 设定。在此输入主站的URL，并以一个/作为结尾。例如，<tt>http://mydomain.com/gallery2/</tt>或<tt>http://photos.mydomain.com/</tt>。注意这是主站的URL，而不是你正在进行升级的站点的URL。将此修改保存并继续生下来的升级程序步骤。请确保此时该站能够正常运行了。

* '''外观主题升级''' – 在G2.0的beta-4版本中所有的布局都被新的外观主题系统所取代。在升级过程中，所有相册的布局设定都被清除而站点范围的默认外观主题则被设定为了matrix。你需要冲洗选择默认的外观主题及相册特定的设定以恢复升级前的布局配置。

* '''View名称''' - 在G2.0的beta-4版本中，视图的命名习惯由使用冒号变成了使用句号（例如，core:ShowItem现在应为core.ShowItem）。所有的Gallery代码都被更新了，但有些地方还需要你进行检查以保证网站的更新：
** 本地tpl文件：请确保在你的自定义模板中将所有视图的名称都进行了更新。有必要的话请与当前版本的默认tpl文件进行一下比对。
** 外部imageblock：在此特色的使用范围内将imageblock:External升级为imageblock.External。
** PublishXP：选择'添加项目（add items）'或Windows XP 并按照指示来更新注册表，这样就能反应出新的视图名称了。

[[Category:Gallery 2:Troubleshooting|Known Issues]]