编写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插件和主题开发。