解析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.