再谈多个 WordPress 网站共享一份用户数据的实现[兼容3.9版本]

在若干年以前,我刚开始折腾Wordpress没多久的时候,就自己摸索过多个Wordpress网站共享一份数据表的实现方法。这种看起来好像很高大上的类SSO功能,能够给用户在多个网站之间提供快速、无缝、透明的登录体验。

举个很简单的例子,原本有一个Wordpress网站 http://www.example.com(后称网站A),你突然想增加一个博客子站点http://blog.example.com(后称网站B),那么原本在网站A注册的用户当然不想重新去网站B再次注册。这个时候就体现出本文要探讨的问题的价值了。

再谈多个 WordPress 网站共享一份用户数据的实现[兼容3.9版本]

废话不多说,直接开始!

以下例子中所有的域名example.com请自行替换成你的域名

阅读本文的前提是你已经有基本的网站部署知识,会部署单个Wordpress网站,知道如何给Wordpress配置数据库信息,了解Wordpress目录结构。

##部署网站A

  1. 如果还没有部署Wordpress,先按照常规方式下载源文件、配置环境(这里不赘述)。记录好填入的数据库名、数据库用户名、数据库密码等信息,后续步骤要使用。(备用数据A)
  2. 编辑wp-config.php,在任意位置添加如下内容:
1
2
define('COOKIE_DOMAIN', 'example.com');
define('COOKIEPATH', '/');

同时找到有一排形如define('XXX_KEY', 'xxxasdas')的内容(共8行),这里是设置一些salt,用来给cookie加密。如果没有也没有关系,有的话复制这些内容,下面的步骤要使用(备用数据B)。

##部署网站B

  1. 在网站B的wp-config.php文件中,填写与网站A一致的数据库信息(备用数据A)
  2. 与网站A一样,在任意位置添加如下内容:
1
2
define('COOKIE_DOMAIN', 'example.com');
define('COOKIEPATH', '/');
  1. 若存在备用数据B(各种define的’XX_KEY’),将这些段落完整的粘贴到网站B的wp-config.php中。
  2. $table_prefix = 'wp_';改为$table_prefix = 'xxx_';xxx是任意不同于wp的字符串)
  3. 添加如下内容;
    1
    2
    define('CUSTOM_USER_TABLE', 'wp_users');
    define('CUSTOM_USER_META_TABLE', 'wp_postmeta');

##关键步骤,修改Wordpress核心文件
我知道,这很恶心,但是我debug了一晚上后,已经实在没有精力去想一个优雅的解决方案了。请各位Wordpress达人提供一个hook吧……

按理说根据上述配置就可以实现用户在www.example.com登录后打开blog.example.com也自动处于登录状态了,但是现实是无情的。即使你发现两个站点下均存在wordpress_logged_in_xxxx的cookie,但是Wordpress就是不能实现这个cookie,调用is_user_logged_in()也是返回false。

经过我各种跟踪调试,最终定位到内核文件wp-includes/default-constants.php中的一个常量COOKIEHASH是罪魁祸首。

源代码如下:

1
define( 'COOKIEHASH', md5( $siteurl ) );

先提供解决方案,再讲原理

将 $siteurl 改成你的顶级域名字符串,即

1
define( 'COOKIEHASH', md5( 'example.com' ) );

这下整个世界都清爽了,cookie们终于愉快的在同一个域下同步了!

##原理解释

为什么一个简单的常量会导致cookie同步失败呢?我们来逐层的恢复这个递归。

下面的这些函数并不是定义在同一个文件中,这里为了逻辑清晰将它们列在一起。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
define( 'COOKIEHASH', md5( $siteurl ) );
...
define('LOGGED_IN_COOKIE', 'wordpress_logged_in_' . COOKIEHASH);
...
wp_parse_auth_cookie($cookie='', $scheme='');
//该函数返回根据 $scheme 读取 $_COOKIE 中的内容并返回结果,
//这里的 $scheme 是常量 "logged_in",函数内部使用 switch
//将 "logged_in" map 到了 LOGGED_IN_COOKIE 这个常量
...
wp_validate_auth_cookie($cookie, $scheme)
//根据上面的函数返回的结果,进一步判断cookie是否有效,并返回 user_id
...
add_filter( 'determine_current_user', 'wp_validate_auth_cookie',1);
//定义了一个filter,当apply的时候执行上述函数
...
get_currentuserinfo()
//这是很常用的一个内部函数,在这个函数里apply了上述filter
...
wp_get_current_user、is_user_logged_in等
//这些函数都调用了上述函数

分析到这里整个Wordpress的cookie解析流程也清晰了,问题很好定位,就是因为网站A网站B$siteurl不同,导致常量定义不同,导致读不到cookie,最终导致了cookie不能跨子域共用。

以上。

发表评论

电子邮件地址不会被公开。 必填项已用*标注