编辑“Gallery:模块:重写（rewrite）”（章节）

= URL Rewrite (1.1.x) =
[[Gallery:URL_Rewrite|开发者参考]]

==描述==
使用mod_rewrite，ISAPI_Rewrite或PathInfo来提供可配置的短URL。

==特点==
* 将URL缩短到人工可读长度的路径。
* Apache mod_rewrite支持。
* IIS ISAPI_Rewrite支持。
* PHP PathInfo支持。
* 可配置的URL样式。
* 拦截热链（hotlinked）项目（仅ISAPI_Rewrite 和mod_rewrite）。
* 其他模块提供有额外的功能。
** [[Gallery:Modules:watermark|Watermark]]模块：水印热链（hotlinked）项目（仅ISAPI_Rewrite和mod_rewrite）。
** [[Gallery:Modules:permalinks|Permalinks]]模块：移动项目时不会改变的永久URL。

==用法==
* 参读[[Gallery:Installing_Additional_Components#Installing_Modules_and_Themes|插件安装的相关指导]]，并启用URL重写模块（URL rewrite module）。
* 你需要在''站点管理（Site Admin） -> 插件（Plugins）''中对此模块进行配置。

配置页面将显示服务器类型（Aapche或IIS）可用的解析方法。如果你不知道该选择哪种方法，你应该都选择一下看看：mod_rewrite（Apache）或 ISAPI_Rewrite（IIS）。模块将会测试你的服务器是否支持所选的解析方法。如果测试成功的话，就会跳转到模块管理页面，在此就可以激活模块了。

==特点请求==
* [http://sourceforge.net/tracker/?func=detail&aid=1224224&group_id=7130&atid=357130| 1224224] 请勿将.html作为项目URL的后置
* 当模块处于活动状态时对解析方法进行修改。

==Bug==
目前无有关此模块的已知问题。

==疑难解答==
===如何确定mod_rewrite被装载了？===
打开Gallery的phpinfo页面查看已装置模块的有关信息。如果mod_rewrite被装载了，就可以在列表中看到它。注意，如果PHP在cgi模式下运行的话，此列表将是空的。
 gallery2/lib/support/index.php?phpinfo

===我确定mod_rewrite被装载了，但为何Gallery告知我此模块无法运行？===
如果你是服务器管理者的话，请确保Gallery的目录具有合适的AllowOverride权限。Gallery需要能够覆盖FileInfo和Options（选项）。在你的Apache配置的末尾加上：
 <Directory /full/path/to/gallery2>
     AllowOverride FileInfo Options
 </Directory>

===我的.htaccess文件丢失，而且站点管理（Site Admin）的链接都无效了。===
参见有关此话题的[[Gallery:FAQ#图片无法显示，相册/相片的链接无效，我该怎么办？|Gallery2常见问题]]。
将以下语句加入你的.htaccess，接着打开站点管理（Site Admin） -> URL重写（URL Rewrite）并保存规则以恢复你原来的.htaccess文件。
 # 开始Url Rewrite部分
 # （自动生成的。请勿编辑此部分）
 <IfModule mod_rewrite.c>
     RewriteEngine On
 
     # Gallery的路径（此例example.com/gallery2/）
     RewriteBase /gallery2/
 
     RewriteRule ^admin /gallery2/main.php?g2_view=core.SiteAdmin   [QSA,L]
 </IfModule>
 # 结束Url Rewrite部分
说明	输入内容	输出结果
斜体	''斜体文字''	斜体文字
粗体	'''粗体文字'''	粗体文字
粗斜体	'''''粗斜体文字'''''	*粗斜体文字*