编写 WordPress 插件和主题的时候,经常需要用到 cookie,比如存取用户状态等,我之前编写的插件 Ludou Simple Vote 就用 cookie 来记录用户投票时间,以实现简单的防止重复投票功能。

但是如果你在 WordPress 主题文件中直接使用 php 的 setcookie() 来发送 cookie,那是完全不行的。 setcookie() 文档中有一条内容:必须在任何其他输出发送前对 cookie 进行赋值,我怀疑 WordPress 初始化的时候已经发送了其他输出,才导致 setcookie 失效。于是深入搜索了 Google,从一篇老外的文章中获得了以下方法:

1 、在主题文件 functions.php 中添加以下代码,以设置 cookie:

/**
* 函数名称,setcookie 的相关参数等可以自行修改
*/
function set_newuser_cookie() {
if (!isset($_COOKIE['sitename_newvisitor'])) {
setcookie('sitename_newvisitor', 1, time()+1209600, COOKIEPATH, COOKIE_DOMAIN, false);
}
}

add_action( 'init', 'set_newuser_cookie');
// 上面一行代码也可以改成下面一行代码
// add_action('after_setup_theme', 'set_newuser_cookie');

2 、然后在需要调用 cookie 值的地方读取 cookie

if (isset($_COOKIE['sitename_newvisitor'])) {
echo 'Welcome back!';
}
else {
echo 'Hello new visitor!';
}

注意事项:

1 、在 WordPress 中,任何 PHP 时间函数,例如 time() 返回的时间不正确,这些时间函数返回的都是 UTC+0 时区的时间,如果你想获得你在 WordPress 后台 – 设置 – 常规中设置的时区时间,可以使用以下几个 WordPress 的时间函数:

date_i18n('Y-m-d h:i:s');                   // 返回当地时间
current_time('timestamp');                  // 返回当地时间的 Unix 时间戳
current_time('mysql');                      // 返回适用于 MySQL 的时间格式
time() + get_option('gmt_offset') * 3600;   // 手工获得当地时间的 Unix 时间戳

所以,发送 cookie 的时候,你可以将 time() 改成 date_i18n('U') 或 current_time('timestamp')

2 、 cookie 的失效时间也是需要注意的一个问题,服务器端的时间和客户端的时间可能会不一样,所以会导致 cookie 失效时间可能跟你设想的不太一样,所以如果你通过以上方法发送了 cookie,但是死活都获取不到值,那么你可以试试将 cookie 的失效时间设置长点。

好了,WordPress 中设置 Cookies 的方法就介绍到此,你可以通过以上代码举一反三,用于你的 WordPress 插件和主题开发。