Joomla 快速判斷用戶登入狀態：Session 變數檢查與顯示邏輯

在 Joomla 模板或模組中判斷用戶是否登入，最直接方式是檢查 Session 變數。本文提供極簡程式碼片段，展示如何讀取 $_SESSION['auth']['username'] 顯示歡迎訊息與編輯連結，未登入則顯示登入連結，並說明 Joomla 核心 API 更優雅的替代寫法。

原生 Session 判斷法（相容舊版/自定義整合）

<?php
// Joomla 預設將用戶資訊存放於 $_SESSION['auth']
if (isset($_SESSION['auth']['username'])) {
    $username = htmlspecialchars($_SESSION['auth']['username']);
    echo "Welcome {$username}!";
} else {
    echo "Log in";
}
?>

Joomla 核心 API 法（推薦、版本無關、支援 ACL）

<?php
use Joomla\CMS\Factory;

$user = Factory::getUser();

if ($user->id) {
    // 已登入
    echo "Welcome " 
       . htmlspecialchars($user->name) . "!";
    // 進階：檢查權限
    if ($user->authorise('core.admin')) {
        echo " 管理員";
    }
} else {
    // 未登入
    $loginUrl = \Joomla\CMS\Uri\Uri::base() . 'index.php?option=com_users&view=login';
    echo "Log in";
}
?>

兩種方法比較

模組/模板中常用位置

• templates/your_template/index.php：頁首歡迎列
• modules/mod_custom/：自訂 HTML 模組
• modules/mod_login/：覆寫登入模組佈局

進階：AJAX 檢查登入狀態

// components/com_ajax/ajax.php
public function checkLogin()
{
    $user = Factory::getUser();
    echo json_encode([
        'logged_in' => (bool)$user->id,
        'username'  => $user->name,
        'user_id'   => $user->id,
    ]);
    exit;
}

總結

• 快速原型/舊系統整合：直接讀 $_SESSION['auth']['username'] 最快。
• 正式專案/模組開發：務必使用 Factory::getUser()，獲得完整用戶物件、權限檢查、向前相容。
• 輸出前記得 htmlspecialchars() 防 XSS。

掌握這兩種方式，無論在模板、模組、元件、AJAX 端點，都能靈活判斷並呈現用戶登入狀態。