解析WordPress中控制用户登陆和判断用户登陆的PHP函数

登陆函数：wp_signon()

函数介绍：
wp_signon()函数用于授权给用户登陆wordpress并可记住该用户名称。该函数取代了wp_login。WordPress 2.5版本起启用。

函数使用：

    <?php wp_signon( $credentials, $secure_cookie ) ?> 

参数说明：

• $credentials
• (array) (可选) 登陆用户信息.
• Default: None
• $secure_cookie
• (boolean) (可选) 决定是否使用安全cookie。
• Default: None

注意:如果你没有提供 $credentials, wp_signon 使用 $_POST 参数(键值为 "log", "pwd" 和 "rememberme").

函数返回值：
(object)
登陆失败返回对象WP_Error，登陆成功则返回WP_User

函数实例：

    $creds = array();
    $creds['user_login'] = 'example'; //wordperss后台用户名称
    $creds['user_password'] = '123456'; //wordperss后台用户密码
    $creds['remember'] = true;
    $user = wp_signon( $creds, false );
    if ( is_wp_error($user) )
      echo $user->get_error_message();

源文件：
wp_signon() 位于 wp-includes/user.php.

判断用户是否登陆函数：is_user_logged_in()

函数介绍：
is_user_logged_in()函数由于判断用户是否登陆，如果用户已经登陆返回True否则返回False。

函数使用：

    <?php if ( is_user_logged_in() ) { ... } ?> 

函数参数：
该函数不接受任何参数。

返回值：
(boolean)
已登陆返回True，否则返回False。

函数实例：
以下实例显示已登陆用户或者未登陆用户显示的内容：

    <?php
    if ( is_user_logged_in() ) {
      echo 'Welcome, registered user!';
    } else {
      echo 'Welcome, visitor!';
    }
    ?>

源文件：
is_user_logged_in() 位于文件 wp-includes/pluggable.php.