星期二, 2016-10-25 13:19 — adminshiping1

drupal中使用URL别名在SEO以及网站用户体验方面非常重要，通常我们使用如下几个模块，

path（核心模块）
pathauto
path_redirect
global_redirect

一般情况下，给一个URL设置一个别名，全站的所有URL都会更新用这个别名来代替原来的URL。

比如: /user/1 —> /robbin-zhao

这样设置的URL会被保存在url_alias表中。

这里有两个术语：
1. outbound URL 输出URL，或者显示/打印的URL。
2. inbound URL 请求URL，可以理解为进来的URL。

了解了术语之后，我们理解一下drupal处理URL别名的方式，

1). 输出别名
在输出URL的时候，核心函数是URL

function url($path = NULL, $options = array()) {
  // Merge in defaults.
  $options += array(
    'fragment' => '',
    'query' => '',
    'absolute' => FALSE,
    'alias' => FALSE,
    'prefix' => '',
  );
 
 ...
 
  elseif (!empty($path) && !$options['alias']) {
    $path = drupal_get_path_alias($path, isset($options['language']) ? $options['language']->language : '');
  }
 
  if (function_exists('custom_url_rewrite_outbound')) {
    // Modules may alter outbound links by reference.
    custom_url_rewrite_outbound($path, $options, $original_path);
  }

我们重点看下面的两个调用 drupal_get_path_alias 和 custom_url_rewrite_outbound。Drupal通过查询url_alias表，把要显示的URL更新为对应的alias就实现了别名的替换。

2). 处理别名的HTTP请求

Drupal在启动所有模块之前，先初始化URL，调用如下函数：

function drupal_init_path() {
  if (!empty($_GET['q'])) {
    $_GET['q'] = drupal_get_normal_path(trim($_GET['q'], '/'));
  }
  else {
    $_GET['q'] = drupal_get_normal_path(variable_get('site_frontpage', 'node'));
  }
}
 
function drupal_get_normal_path($path, $path_language = '') {
  $result = $path;
  if ($src = drupal_lookup_path('source', $path, $path_language)) {
    $result = $src;
  }
  if (function_exists('custom_url_rewrite_inbound')) {
    // Modules may alter the inbound request path by reference.
    custom_url_rewrite_inbound($result, $path, $path_language);
  }
  return $result;
}

函数 drupal_get_normal_path 主要是查询url_alias表，得到当前URL的实际地址，比如 user/1, 然后把这个URL赋给 $_GET['q']来实现具体的URL重写功能。

在有些情况下，我们需要批量修改一些URL的别名，如果我们用drupal默认的url_alias, 但又有一些问题，首先，更新所有的URL脚本比较繁琐，数据量大的情况需要batch，操作数据不方便。其次，如果用户量大，会产生严重的Drupal性能问题，因此，可以考虑到不用url_alias，举个例子，比如我们希望更新user下面的所有tab url, 如：user/1/info, user/1/blog, user/1/message，user/1/mail … 每个用户有多个URL需要更新，如果有1百万用户，那么就会有上百万、千万的alias数据，对于维护、性能都是很大问题。

自定义函数实现URL重写
通过查看Drupal的URL流程，可以发现，Drupal在处理输出URL的时候，会调用一个自定义函数：custom_url_rewrite_outbound，在处理HTTP请求的URL时，
也会调用一个自定义函数：custom_url_rewrite_inbound，所以我们可以实现这两个函数来实现URL重写。

注意，由于这是单个函数而不是hook，如果每个函数都实现，很容易相互冲突，比如fb模块（facebook），url_alter（用于自定义代码来实现URL重写，主要实现了上面的两个函数）。但是由于这两个函数容易冲突（不是hook），其次，url_alter对inbound URL处理有问题，因为Drupal在调用custom_url_rewrite_inbound这个自定义函数的时候，是在加载所有模块之前，所以把这个函数写在module文件里面，根本掉用不到，这里提供一个目前较为合理的解决方案：

写一个inc文件，放到（任意）自定义模块下面，比如 my-core/my-core.rewrite.inc
修改settings文件，include这个文件。比如 include “sites/all/modules/custom/my-core/my-core.rewrite.inc”;
在该文件中加入inbound和outbound这两个函数。

具体代码如下：

/**
 * Define custom_url_rewrite_inbound()
 * @author robbin
 */
if (!function_exists('custom_url_rewrite_inbound')) {
  function custom_url_rewrite_inbound(&$result, $path, $path_language) {
    {fun_1}_url_inbound_alter($result, $path, $path_language);
  }
}
 
/**
 * Define custom_url_rewrite_outbound()
 * @author robbin
 */
if (!function_exists('custom_url_rewrite_outbound')) {
  function custom_url_rewrite_outbound(&$path, &$options, $original_path) {
    {fun_1}_url_outbound_alter($path, $options, $original_path);
  }
}

其中 {fun_1}_url_inbound_alter、{fun_1}_url_outbound_alter 表示一组处理inbound/outbound的函数，命名规则最好按照如上方式，因为一些第三方模块以及hook都是这个规则，容易理解。
可以添加多个函数，比如{fun_2}_url_inbound_alter等等，每添加一个，在上面的位置调用函数，以做到每组不通功能的函数分开。如果第三方模块，也需要实现重写，一般情况下，这些模块会实现类似 {module}_url_inbound_alter这样的函数，直接把这个函数加到上面对应的位置来调用即可，比如（facebook模块的fb_url_inbound_alter等）。这里给出函数的简要说明：

//修改result的值为最终实际的URL $result是引用传值
hook_url_inbound_alter(&$result, $path, $path_language);
//修改$path的值为想要的别名的URL $path是引用传值
hook_url_outbound_alter(&$path, $options, $original_path);

最后，还有一点要注意，自定义inbound函数，有时可能会和global_redirect冲突，（没用这个模块，写了类似的函数，也会冲突），因为redirect模块会检查当前的真是url（从outbound中获取）和当前请求的URL不一样，比如真实url是user/1，而当前的请求是 robbin-zhao，它会自动跳转，导致一个无限循环跳转的bug。
解决办法就是在inbound函数里面设置一个全局变量，阻止继续调转。设置 $_REQUEST['q'] = $result; 的值为最终实际URL的值，而不是别名。

示例代码

function my_redirect_url_inbound_alter (&$result, $path, $path_language) {
 
  $arg0 = arg(0); //should be user-name
  $arg1 = arg(1); //should be connections/media/...
 
  if ($arg1) {
    $user_url = drupal_lookup_path('source', $arg0);
    if ($user_url != $arg0 && preg_match('{user/(\d+)}i', $user_url, $matches)) {
      $user_id = $matches[1];
      $result = "user/$user_id/$arg1";
 
      //add this to tell global_redirect not to redirect this url again
      $_REQUEST['q'] = $result;
    }
  }
}
 
function my_redirect_url_outbound_alter (&$path, $options, $original_path) {
  //rewrite user's sub tab url to seo-friendly url
  //such as, user/1/media --> robbin-zhao/media
  if (preg_match('{user/(\d+)/(\w+)}i', $path, $matches)) {
    $uid = $matches[1];
    $tab = $matches[2];
 
    $alias = drupal_lookup_path('alias', "user/$uid");
 
    if ($alias != $path) {
      $path = "$alias/$tab";
    }
    //$path = ''
  }
}

优化过的代码已经提交到Drupal官方网站，并且已经是一个第三方模块，大家可以下载使用。
模块地址：http://drupal.org/project/rewrite_sub_link

声明： 本站所有文章欢迎转载，所有文章未说明，均属于原创，转载均请注明出处。
本文有效链接： http://www.drupal001.com/2011/12/drupal-custom-url-alias/
版权所有： Drupal与高性能网站架构 http://www.drupal001.com

本文作者: 赵高欣 . Robbin（发表日志71篇）

资深架构师，Drupal大学站长。专注于WEB站点架构、性能优化、SEO等。LAMP、.NET平台经验较多，目前在PHP/Drupal的应用方面和高性能网站架构等领域码砖。

seo , URL , URL重写 , 性能

Drupal调试之Devel模块使用技巧

高负载网站之Varnish与Drupal – 基本篇

评论:3

发表评论

回复方域
13/03/19

全篇都在说别名的实现过程，没有讲到使用您这个模块的优缺点呀。
- 回复robbin
  13/03/23
  
  确实漏了说。
  优点：不使用数据库（如url_alias表），性能好。尤其是在url alias表比较大的时候。
  缺点：管理没有url alias那么灵活。
回复vino
13/09/21

不得不赞一下你写教程类文章的风格，详细，以前只在国外网站见过，国内博主都是一位某个知识点别人知道，就一笔带过，带过也没关系，至少给个链接让别人去补这一块。
博主的风格就很好，刚看了ABTEST，至少博主不厌其烦，考虑到每个浏览者的入门程度，能让初学的人一看就懂，真的非常感谢。希望这种详尽的风格一致保持啊。初入DRUPAL不容易，谢谢你的知识分享

来自 http://www.drupal001.com/2011/12/drupal-custom-url-alias/

Rewrite Sub Link

Primary tabs

Posted by robbin.zhao on December 16, 2011 at 8:56am

In brief, this project could help you rewrite the URLs.

1. sub urls of node and user will be rewritten when the parent url has an alias.
2. you can use regex to rewrite any url if you want

NOTICE: no need to enable this module, just include the core in your settings.php

In Drupal, we have node and user. In many cases, node|user has many sub-tab menu, such as node/%/info node/%/devel and any other MENU_LOCAL_TASK.
If you use url_alias, you need to add alias for each of them. This module, Rewrite Sub Link, will help you rewrite them automatically, and which doesn't user url_alias, so when you have millions of node, it won't case a performance issue.

Additionally, this module support regular express, so you can write your regular express to change your URL.

Light-weight Usage
add this line in the settings.php file,
include_once "sites/all/modules/contrib/rewrite_sub_link/rewrite_sub_link.core.inc";
add your custom settings in your settings.php
include_once "path_to_your_custom_rewrite_settings.php"
or change the code in rewrite_sub_link/rewrite_settings.php directly.

then all the sub links of user and node will be rewritten automatically.
Please check rewrite_settings.php file and change for your custom settings.

NOTICE
This module is using code as settings, and didn't save many settings in Drupal db as Drupal way. Since url_rewrite function is called by everywhere in drupal core, so the performance is very important.

Similar projects
URL alter Inbound URL has problem, since it didn't include the file before module loading.
Galaxy Url Rewrite Not automatically support sub tab menu, you need to set url manually which save into db. Neither does 'Galaxy Url Rewrite' support Regular Express.

[Chinese]
模块主要作用
不用alias来重写Drupal的URL

1. 重写node或user的子URL
比如 node/%/info user/%/info
2. 支持正则表达式重写URL
正则表达式支持自定义函数

模块使用方法
在settings.php最后面加上下面的代码（注意修改路径）
include_once "sites/all/modules/contrib/rewrite_sub_link/rewrite_sub_link.core.inc";

（可选）然后可以修改模块下面的rewrite_settings.php，如果不想修改模块代码，可以在settings.php里面再include进来自定义的settings文件。

Project Information

Maintenance status: Actively maintained
Development status: Under active development
Module categories: Path Management, Performance and Scalability, Site Navigation
Downloads: 1,135
Last modified: September 20, 2016
Stable releases are covered by the security advisory policy.
Look for the shield icon below.

Downloads

View all releases

来自 https://www.drupal.org/project/rewrite_sub_link

普通分类:

drupal

You are here

Drupal自定义代码实现URL重写

本文作者: 赵高欣 . Robbin（发表日志71篇）

评论:3

Rewrite Sub Link

Primary tabs

In brief, this project could help you rewrite the URLs.

Project Information

Downloads

友情链接

搜索表单

用户登录

You are here

Drupal自定义代码实现URL重写

本文作者: 赵高欣 . Robbin（发表日志71篇）

评论:3

Rewrite Sub Link

Primary tabs

In brief, this project could help you rewrite the URLs.

Project Information

Downloads

友情链接