编辑“Gallery:如何安装Gallery2”

= 安装Gallery2 =
其他语言的安装指南：
* [http://www.softwarelibre.net/instalacion_de_gallery_2_2_1_paso_a_paso 手把手教你安装Gallery 2.2.1] （西班牙语）
有关特定安装或平台的指南：
* [[Gallery:Installation_on_MacOSX|Mac OS X操作系统下的安装指导]]
* [http://www.iis.net/articles/view.aspx/IIS7/Hosting-Web-Applications/PHP/PHP-Applications-on-IIS--- IIS和FastCGI下Gallery2的安装]
* [[Gallery:Installation on Debian|Debian上的安装]]

== 先决条件 ==

安装Gallery2之前，你需要一个具有PHP支持的web服务器以及一个数据库服务器。可以参看[[Gallery:Installation_Requirements|安装配置要求]]来获取完整的配置要求清单。

=== 虚拟主机用户 ===
如果你像大多数用户一样是在托管的WEB服务器上安装Gallery2的话，就没必要操心建立一个WEB服务器了，因为这些都是现成的。你应当有一个控制面板或其他的管理工具进行空数据库的创建。那么就可以跳过这一步直接[[Gallery:How_do_I_Install_Gallery2#准备安装|准备安装]]吧。

'''注意：''' 有些虚拟主机供应商提供Gallery2的一键安装。直接通过网站里的管理面板进行一键安装，将省去你不少的麻烦。目前已知以下的自动安装程序：
* [http://www.swsoft.com/plesk Plesk] Application Vault / Application Pack
* [http://netenberg.com/fantastico.php Fantastico Deluxe] ([[Gallery:Fantastico|Fantastico的Gallery2安装详解]])
* [http://www.installatron.com Installatron]
* [http://www.4psa.com/products/4psaintegrator.php 4PSA-Integrator]
* [http://www.cpskins.com/productinfo/psainstaller.htm PSA-Installer] （无法升级!）
* [http://www.cpanel.net/ cPanel Auto-Installer] (即将发布)
* 很多虚拟主机供应商都有自己的自动安装程序(在[http://gallery.menalto.com/wiki/Web_Hosting_Referral_Page 经认证的Gallery虚拟主机供应商]中的大多数都是这样)

以下的BLOG和网站链接含有网站空间中Gallery的安装指导：
* [http://www.howtotuts.com/2008/01/14/how-to-install-gallery-on-your-web-site/ HowToTuts.com Gallery安装教程]

=== 建立你自己的WEB服务器 ===
自己建立WEB服务器并非易事。但有一些可供免费下载的带有PHP和MySQL服务器的WEB服务器安装包。尽管点几下鼠标就能完成安装，但一旦出了问题而且不具备相关经验的话，事情就会很难办了。

你可以参考这个手把手[[Gallery:将Mac建立为WEB服务器|安装向导]]来看看如何将Apple Mac建成一个WEB服务器。

==== 网络连接 ====
如果你没有一个固定的IP地址或是动态DNS (dnydns)账户的话，那么只有你自己和你所在局域网内的计算机用户可以访问你的Gallery，而任何使用Internet的计算机用户则无法访问你的Gallery。我们假设你具有一个固定的IP地址/dyndns账户或者你只希望通过局域网访问Gallery2。

==== 安装简便的整合包 ====
如果你没有安装任何配置要求中的组件而且你不想过问技术细节的话，可以选择这些安装简便的整合包。只需点几下鼠标就能安装apache，MySQL和PHP。
* XAMPP - http://www.apachefriends.org/ （适用于Windows，Linux和其他操作系统）
* MAMP - http://www.mamp.info/ （适用于Mac OS X）
* WAMP - http://www.wampserver.com （适用于Windows）

==== 操作系统 ====
如果你希望在你的电脑或服务器中安装Gallery2的话，我们推荐linux / *BSD作为操作系统。因为这些就是我们所使用的开发平台，而大多数的专业虚拟主机供应商都使用它们作为平台。其他的操作系统当然也是支持的。Linux则有很多发布版本。极度推荐[http://www.debian.org/ Debian]和[http://www.gentoo.org/ Gentoo]，因为这二者很完善并且稳定，很适合服务器应用程序；不止如此，它们还包括有不俗的整合包管理器，可以帮助你解决依赖性方面的问题。在这样的linux发布版本中安装一个WEB服务器不会难过于输入"emerge apache2"或"apt-get install apache"这样的命令。

==== Web服务器 ====
[http://apache.org/ Apache2]是我们选择的WEB服务器。某些Gallery2的特点，如短URL，仅仅适用于apache（短URLs自Gallery2.1以后也适用于其他WEB服务器）。


==== 数据库 ====
Gallery 2主要是由[http://www.mysql.org/ MySQL]发展而来的，但在[http://www.postgresql.org/ PostgreSQL]和[http://www.ibm.com/software/data/db2/ DB2]中也能很好地运行。Gallery2没有在[http://www.oracle.com Oracle]下经过很好的测试。你可以在MySQL中看到很好的性能表现，这也是因为我们使用MySQL的内置函数，从而我们可以在其它的数据库中使用用户定义的函数进行模仿。

==== PHP ====
可从[http://www.php.net/ php.net]获取预编译的PHP二进制代码或完整的源代码。如果你自己进行编译，记得将数据库支持编译到PHP中（比如如果你使用MySQL就是--with-mysql= ... and --with-mysql-sock=... ）。 如果需要翻译/多语言支持的话，你就需要gettext。还有更多的PHP编译选项/扩展（如PCRE）为Gallery2所必须的，或者在其它方面也有用处。如果你依赖于GD（一个内置于PHP的图像工具包）而非外部工具的话（imagemagick，netpbm和graphicsmagick），那么请记住在PHP编译选项中添加所有的图片格式（--with-jpeg=... ， --with-png=...等）。编译PHP是其自身的话题。Gentoo，Debian...将会使用单个命令来为你进行配置和编译。你能找到有关此话题的很多教程和指导，以及有关webserver，mysql和PHP的话题。


== 准备安装==

1. 最新版本 – 有四种获取代码的方法。
:* Tarball – 你可以从[http://sourceforge.net/projects/gallery/ SourceForge]下载tarball或zip格式的文件包。
:* Pre-Installer（预安装程序） - 如果你只能通过FTP访问WEB服务器而且没有办法直接在服务器上解压zip或tar文件的话，你就需要试试[[Gallery:Preinstaller|Gallery 2 预安装
程序]]。它会直接将归档传输到WEB服务器上并为你解压。
:* Nightly Snapshot – 你可以下载最新的tarball或zip文件格式的快照版（snapshot）代码。可以参见[http://gallery.menalto.com/wiki/Download Gallery下载页面]查找这些代码。
:* Subversion – 获取最新代码的更好的办法，但仅限于高级用户。请遵照[http://codex.gallery2.org/index.php/Gallery:Using_Subversion Subversion指导]来获得最新的Gallery2代码。你可以随时获取最新的代码，因此这无疑是保证代码“入时”的好办法。
2. 存储 – 为Gallery创建一个目录用以相片的存储。WEB服务器必须享有写入的权限，但为了安全起见，我们建议不要将其置入web根目录下。如果你将其置入web根目录中，任何人都可以通过WEB浏览器绕过Gallery2的安全防线直接访问你的图片。


'''Unix的例子'''
<pre>
$ cd $HOME
$ mkdir g2data
$ chmod 777 g2data
</pre>
'''Windows 的例子'''
<pre>
C:\> mkdir g2data
</pre>

在Unix的例子中，你可能注意到了777模式在g2data目录中并非那么安全。然而，提升安全性取决于你的系统配置方式。你可以与系统管理者讨论一下如何修改权限以使得Gallery仍可写入文件而其他人则不可以。

3. 数据库- 目前我们支持[http://dev.mysql.com/downloads/ MySQL],，[http://www.postgresql.org/mirrors-ftp.html PostgreSQL]，
[http://www.ibm.com/software/data/db2/ DB2]， [http://www.oracle.com/technology/software/index.html Oracle]和[http://www.microsoft.com/sql/ MS SQL Server]。 MySQL的速度一般来讲比PostgreSQL要快。我们要求你自己创建数据库。在下面的例子中，我们会创建一个名为gallery2的数据库。你则可以选择其他任何名称来命名你的数据库。

为你的数据库用户开启所有必须的权限。在Gallery2数据库中，这包括但不局限于：'''创建表格，修改表格，放下表格'''；以及所有的（gallery2）表格的'''选择，插入，更新，删除'''；'''创建索引'''和其他的一些权限则取决于所使用的数据库管理系统。'''创建/放下数据库'''以及'''给予'''其他数据库用户权限则并非必须的。

'''MySQL指导'''
<pre>
$ mysqladmin -uroot create gallery2
$ mysql gallery2 -uroot -e"GRANT ALL ON gallery2.* TO username@localhost IDENTIFIED BY 'password'"
</pre>
* 设置用户名和密码
* 如果MySQL拒绝访问，请尝试在每个命令行中的"-uroot"之后添加"-p"
 
'''PostgreSQL 指导'''
<pre>
$ createdb gallery2 -E UNICODE
</pre>

如果它陈述UNICODE不是有效的编码名称，请尝试：
<pre>
$ createdb gallery2 -E SQL_ASCII
</pre>
如果仍然无效的话，请尝试：
<pre>
$ createdb gallery2
</pre>
Windows 2003 Server（或者是其他的版本）中你必须在命令结尾写进数据库的名称：
<pre>
C:\> createdb -E UNICODE gallery2
</pre>
'''Oracle 指导'''
<pre>
$ create database gallery2 {additional parameters};
</pre>

'''DB2 指导'''

参见 [http://codex.gallery2.org/index.php/Gallery2 DB2]

4. 图像工具包 - Gallery2可以兼容[http://netpbm.sourceforge.net/ NetPBM]， [http://www.imagemagick.org/ ImageMagick]，[http://php.net/gd GD]或[http://www.graphicsmagick.org/ GraphicsMagick]。它们的性能都很不错。但有人说NetPBM效能上略胜一筹。而ImageMagick较之NetPBM则更为快速。GD无法完成图片旋转操作。GraphicsMagick与ImageMagick则非常相似。GD可以达到很快的速度，与此同时就要消耗更多的内存。因此可能会招致预定义服务器局限。默认情况下，它也被编译进了PHP4.3.0或更新的版本中，但它不见得支持所有的图片格式（比如它可能不支持JPEG格式）。如果NetPBM和ImageMagick的二进制安装到默认的或标准的位置的话，那么在安装过程中Gallery2会自动检测到。启用所有的这些工具没有什么害处—但是你可能需要更为广泛的文件格式支持机制。

== 安装Gallery 2 ==

作为一个WEB应用程序，Gallery2必须安装在WEB服务器中才能使用。如果你是解压到桌面上了，你就必须在安装过程中将其上传到服务器中。然后你才能使用WEB浏览器对其进行配置。

1. 上传 – 将Gallery2的文件复制到WEB服务器上的目录中。有若干种办法进行此步骤：
* 最快的办法：使用FTP或其它方法将Gallery整合包上传到WEB服务器的归档中，接着使用交互式会话外壳将其解压（SSH或telnet）。解压命令例举（请选择合适的一个）：

'''对.tar.gz归档文件'''
<pre>
$ tar xzf gallery2.tar.gz
</pre>

'''对zip归档文件'''
<pre>
$ unzip gallery2.zip
</pre>

如果没有Shell权限，你可以要求供应商为你解决；或者你可以建立一个含有如下命令的PHP脚本：

'''打开.tar.gz归档文件的PHP代码'''
<pre>
<?
$output = shell_exec('tar xzf gallery-2.0.2-full.tar.gz');
?>
</pre>

有些网站托管公司提供的控制面板包含有WEB文件浏览器，可以用于归档文件的解压。值得尝试一下此方式。
* 最简单但也是最慢的办法：如果你不具有Shell权限，你可以使用FTP软件将整个Gallery2的内容归档文件上传到WEB服务器上。这是很花时间的而且有错误倾向。这就需要对安装程序中的“系统检查”步骤尤其关注了，而且要确保没有任何丢失的或被篡改的文件。可以考虑使用类似FileZilla的FTP程序以确保传送过程一切顺利。
* 高级方式： [[Gallery:Using Subversion|Subversion]]
   
注：上传之后，你应当关闭该版本的README并浏览刚刚上传的版本。
这样该文檔中的所有链接都将正确定位到Gallery2安装中。

2. 开始安装 – 打开WEB浏览器并浏览安装目录。Gallery2将引导你进行系统配置安装并为你打理好一切。

[[{{ns:image}}:12903.jpg]]

3. 验证 – 你会被要求创建并保存一小段文本来进行验证，否则无法继续。Gallery2以此种方式来确认你可以使用安装程序。

[[{{ns:image}}:12908.jpg]]

4. 系统检查 – 安装程序对你的系统进行检查以确保能够支持Gallery2。请保证所有的检查都被成功执行！

[[{{ns:image}}:12914.jpg]]

5. 安装方式 – Gallery可以通过单个的代码安装来支持多个独立站点。在此你可以选择一个标准的单个安装或一个新的多站点安装。在Gallery Codex中有更详细有关多站点（multisite）的信息。

[[{{ns:image}}:12917.jpg]]

6. 建立存储位置 – 参读安装程序的指导来为Gallery2建立一个存储位置。这样Gallery2就可以有地方存储你的图片了，当然还包括其它缓存信息。

[[{{ns:image}}:12920.jpg]]

7. 数据库安装 – 选择数据库类型并输入数据库验证信息。如果你不是第一次安装Gallery2的话，就意味着有旧的安装残留，那么它就会检查安装过的版本并提供一个简洁的安装方式。它会清楚存储目录和数据库中所有的数据。如果安装过的版本没有问题的话，它还会重新使用已有的数据库表格。如果你没有从暂存中启动安装程序的意思，就选择此项。

[[{{ns:image}}:12926.jpg]]

8. 建立管理员账户 – 你会被提示输入一个管理员用户名和密码。输入密码后需要再输入相同的密码以进行确认。姓名和Email地址是可选的。但强烈建议输入Email地址。一旦完成了此步骤，点击“创建”来为此次Gallery2安装创建管理员账户。

[[{{ns:image}}:12932.jpg]]

9. 创建配置文件 - Gallery2会在Gallery2目录下创建config.php文件。它包括安装程序中你所提供的所有应答并且这是Gallery2正常运行所必须的。现在还会有一个完整性测试以防止因启动升级向导而破坏Gallery安装。 

[[{{ns:image}}:12938.jpg]]

10. 安装核心模块 – 在此我们创建所有的数据库表格，初始化用户和相册作为开始。除非发生了错误，不然你真的可以“袖手旁观”了。

[[{{ns:image}}:12944.jpg]]

11. 安装其它模块 - Gallery2有各种各样的模块能够提供各种有用的功能。因此选择你所需要的来使用。你可以稍后访问网站管理页面来安装，激活，禁用或卸载模块。因此在此做些试验无妨。

[[{{ns:image}}:12947.jpg]]

12. 检查安全性 - Gallery2将会引导你对新的config.php进行监视。

[[{{ns:image}}:12959.jpg]]

13. 完成！ - 祝贺你！现在已经成功安装了Gallery 2！

[[{{ns:image}}:12965.jpg]]

== 关注版本更新动向 ==
推荐你订阅'''[[Gallery:邮件联系表|邮件联系表]]'''以获悉Gallery更新的动向。我们保证此联系表的内容保持一个较低的量，以保证你只获得重要的告知信息，比如安全性补丁。

== 使用外部依赖安装模块 ==
Gallery2中有的模块依赖于外部二进制。如果所依赖的二进制没有在WEB服务器中安装，这些模块就不会运作。此分类下的模块有''imagemagick''和''netpbm''模块，它们负责生成较小的预览图片（也称为“缩略图”）并重设图片的尺寸。

如果Gallery2安装激活类似''imagemagick''，''netpbm''或''zipcart''的模块失败了，那它对外部二进制的自动检测和定位也会失败。绝大多数情况下，这意味着你的服务器不支持这些所需的二进制，从而无使用这些Gallery2的模块。

参见[[Gallery:Installing_Modules_With_External_Dependencies|使用外部依赖安装模块]]获取更多相关信息。

[[Category:Gallery 2:Installation|How do I Install Gallery2]]