```markdown

# Retour for Craft CMS 2.x: 精准URL重定向插件





此项目【已被废弃】，但仍然能正常运行，并允许您按照需要继续使用或进行二次开发。Craft CMS 3.x版本的对应插件可在[nystudio107/craft-retour](https://github.com/nystudio107/craft-retour)找到，也可通过Craft Plugin Store直接安装。

## 插件简介

**Retour** 是针对Craft CMS 2.x的一个插件，它智能地处理过时的URL重定向，帮助你在网站重构和结构调整时不丢失SEO价值。现在虽然不再维护，但其功能依然强大且完全可用。

![Screenshot](resources/screenshots/retour01.png)

相关链接：[Craft 3.x版 Retour](https://github.com/nystudio107/craft-retour)

## 技术剖析

Retour插件采用了精确和正则表达式匹配两种方法来处理URL模式，并提供了一个特别的"Retour Redirect"字段类型，可以添加到你的条目中。这使得动态条目重定向成为可能，可以在匹配URL模式时访问条目的数据。

当条目的slug更改或者在结构中移动条目时，Retour也会自动创建重定向。此插件设计得性能高效，只有在发生404错误时才会产生影响，并且会缓存结果以提高后续重定向请求的速度。

## 应用场景

1. 对于大型网站重建，大量静态重定向可能导致服务器每次请求处理速度变慢，此时使用插件处理是更好的选择。
2. 当旧网站的URL模式与新网站不匹配，创建直接映射困难时。
3. 如果你无法访问服务器配置文件，或者希望客户能够轻松管理重定向。

## 特点

- 只有在404错误出现时才尝试重定向，不影响正常页面的加载速度。
- 提供动态条目重定向功能，利用条目数据作为关键来确定新的URL映射。
- 用户友好的后台管理界面，记录404错误统计信息。
- 支持手动设置静态重定向，方便对确定性映射的URL进行管理。

### 小贴士：关于.htaccess

尽管许多人习惯于使用`.htaccess`进行重定向，但是长期来说，最好将其禁用并通过服务器配置文件进行设置。这是因为`.htaccess`会影响每一条请求的性能，并且当URL映射复杂时，使用正则规则可能更麻烦。Retour解决了这些问题，只在必要时执行，且提供了更灵活的映射方式。

## 动态条目重定向

Retour的"Retour Redirect"字段类型允许您将字段添加到条目类型中，对于404（未找到）的URL，如果它们匹配了遗留的URL模式，将会重定向至该条目的URL。

此外，您可以访问条目上下文中的数据，例如导入一个名为`recipeid`的字段，然后在遗留的URL模式中匹配它，如：`/old-recipes/{recipeid}`。

## 配置与使用

创建"Retour Redirect"字段并设定默认值，新条目会继承这些值。通过这种方式，你可以一次性设置匹配模式，而无需为每个条目重复操作。

要创建重定向字段，请像其他字段一样操作，并设置以下默认值：

- **默认遗留URL模式**
- **默认匹配类型**
- **默认重定向类型**
- **可改变的重定向**

## 总结

Retour是一个高效且灵活的工具，适用于处理大型网站的URL重定向，尤其适合网站重构和迁移过程中保持SEO价值。它的动态条目重定向功能以及支持手动设置静态重定向使其在众多解决方案中脱颖而出。

现在就试试Retour，让您的网站重建更加平滑无痛！

---

注：Craft CMS 2.x版本的Retour不再更新，建议升级到最新版本以获得最佳体验。

这篇文章介绍了Retour插件的基本信息，技术原理，适用场景以及它的主要特点，旨在引导用户理解并考虑采用这个插件来解决他们的URL重定向问题。