許多現(xiàn)代網(wǎng)站都允許用戶通過(guò)其社交網(wǎng)絡(luò)帳戶登錄。例如，SitePoint 社區(qū)允許用戶使用其 Facebook、Twitter、Google、Yahoo 或 GitHub 帳戶登錄，無(wú)需注冊(cè)新帳戶。

本教程將介紹 HybridAuth —— 一個(gè)簡(jiǎn)化社交登錄功能構(gòu)建的 PHP 庫(kù)。

HybridAuth 充當(dāng)應(yīng)用程序與各種社交 API 和身份提供商之間的抽象 API。

關(guān)鍵要點(diǎn)

• HybridAuth 是一個(gè) PHP 庫(kù)，旨在簡(jiǎn)化社交登錄集成到您的網(wǎng)站中，充當(dāng)您的應(yīng)用程序與各種社交 API 之間的中間層。
• 建議通過(guò) Composer 安裝 HybridAuth，并且需要為每個(gè)社交網(wǎng)絡(luò)（如 Facebook、Google 和 Twitter）配置特定的憑據(jù)才能正常運(yùn)行。
• 該庫(kù)使用 OAuth 進(jìn)行安全訪問(wèn)，確保在身份驗(yàn)證過(guò)程中保護(hù)用戶憑據(jù)。
• HybridAuth 允許自定義用戶身份驗(yàn)證過(guò)程，不依賴于電子郵件或用戶名，而是使用社交網(wǎng)絡(luò)提供的唯一標(biāo)識(shí)符。
• 本教程提供了一個(gè)使用 Slim PHP 框架的實(shí)際演示，詳細(xì)介紹了從設(shè)置環(huán)境到編寫(xiě)功能齊全的演示應(yīng)用程序的步驟，該應(yīng)用程序通過(guò)社交網(wǎng)絡(luò)處理用戶注冊(cè)、登錄和注銷(xiāo)。

安裝

推薦使用 Composer 安裝 HybridAuth。我們還將使用 Slim 作為示例應(yīng)用程序的基礎(chǔ)。

<code>{
    "require": {
        "slim/slim": "2.*",
        "hybridauth/hybridauth": "2.3.0"
    }
}</code>

使用 HybridAuth 進(jìn)行社交登錄

要使用 HybridAuth，請(qǐng)將 /vendor/hybridauth/hybridauth/hybridauth 文件夾中的 config.php 和 index.php (HybridAuth 端點(diǎn)文件) 復(fù)制到您的項(xiàng)目根文件夾。

將 index.php 文件重命名為 hybrid.php，因?yàn)?index.php 將由 Slim 框架用于我們的演示應(yīng)用程序邏輯。

使用您的應(yīng)用程序（例如 Facebook、Twitter 應(yīng)用程序）憑據(jù)填充 config.php 文件。

例如，如果您希望用戶通過(guò) Facebook、Google 和 Twitter 登錄您的網(wǎng)站；您的配置文件看起來(lái)應(yīng)該像這樣。我的應(yīng)用程序 URL 是 http://slim.local。

<code>return 
    [
        "base_url"   => "http://slim.local/",
        "providers"  => [
            "Google"   => [
                "enabled" => true,
                "keys"    => [ "id" => "", "secret" => "" ],
            ],
            "Facebook" => [
                "enabled"        => true,
                "keys"           => [ "id" => "", "secret" => "" ],
                "trustForwarded" => false
            ],
            "Twitter"  => [
                "enabled" => true,
                "keys"    => [ "key" => "", "secret" => "" ]
            ],
        ],
        "debug_mode" => true,
        "debug_file" => "bug.txt",
    ];</code>

注意：base_url 參數(shù)必須指向 HybridAuth 端點(diǎn)文件，在本例中為 hybrid.php。

有關(guān)更多信息，請(qǐng)參閱 HybridAuth 配置文檔。

接下來(lái)，加載 vendor 自動(dòng)加載器并實(shí)例化類。

<code>require 'vendor/autoload.php';
$hybridauth = new Hybrid_Auth( 'config.php' );</code>

使用 authenticate 方法使用給定的提供程序?qū)τ脩暨M(jìn)行身份驗(yàn)證。

對(duì)于 Facebook：

<code>$adapter = $hybridauth->authenticate( "Facebook" );</code>

對(duì)于 Twitter：

<code>$adapter = $hybridauth->authenticate( "Twitter" );</code>

對(duì)于 Google：

<code>$adapter = $hybridauth->authenticate( "Google" );</code>

傳遞給 authenticate() 的參數(shù)必須與 config.php 文件中的提供程序數(shù)組鍵匹配。

身份驗(yàn)證后，使用 getUserProfile() 方法檢索用戶的個(gè)人資料數(shù)據(jù)。

<code>{
    "require": {
        "slim/slim": "2.*",
        "hybridauth/hybridauth": "2.3.0"
    }
}</code>

$user_profile 變量將是一個(gè)對(duì)象，其中包含返回的用戶個(gè)人資料數(shù)據(jù)。

更多社交提供商

要向現(xiàn)有提供商添加更多提供商，例如 GitHub，請(qǐng)將 GitHub.php 文件從 vendor/hybridauth/hybridauth/additional-providers/hybridauth-github/Providers 復(fù)制到應(yīng)用程序中的某個(gè)位置（在本例中為提供程序目錄）。使用提供程序包裝器加載文件，其中 path 是 GitHub 文件的路徑，class 是其 PHP 類的名稱。

<code>return 
    [
        "base_url"   => "http://slim.local/",
        "providers"  => [
            "Google"   => [
                "enabled" => true,
                "keys"    => [ "id" => "", "secret" => "" ],
            ],
            "Facebook" => [
                "enabled"        => true,
                "keys"           => [ "id" => "", "secret" => "" ],
                "trustForwarded" => false
            ],
            "Twitter"  => [
                "enabled" => true,
                "keys"    => [ "key" => "", "secret" => "" ]
            ],
        ],
        "debug_mode" => true,
        "debug_file" => "bug.txt",
    ];</code>

使用 HybridAuth 的 authenticate() 方法使用 GitHub 對(duì)用戶進(jìn)行身份驗(yàn)證，如下所示：

<code>require 'vendor/autoload.php';
$hybridauth = new Hybrid_Auth( 'config.php' );</code>

社交登錄實(shí)現(xiàn)

通常，每個(gè)具有登錄和注冊(cè)系統(tǒng)的網(wǎng)站都使用用戶的電子郵件地址或用戶名來(lái)識(shí)別和登錄其帳戶。如果您打算實(shí)現(xiàn)社交登錄功能，建議不要使用用戶的用戶名或電子郵件進(jìn)行身份驗(yàn)證。

反對(duì)這種做法的一個(gè)原因是，例如，Twitter 不會(huì)返回通過(guò)其身份驗(yàn)證的用戶電子郵件地址。也就是說(shuō)，返回的個(gè)人資料數(shù)據(jù)不包含用戶的電子郵件。

大多數(shù)（如果不是全部）社交提供商，如 Facebook、Twitter、Google、LinkedIn 甚至 GitHub，在授權(quán)后都會(huì)返回唯一的用戶標(biāo)識(shí)號(hào)。

不要使用用戶的電子郵件將其登錄到其帳戶，而是使用社交提供商返回的標(biāo)識(shí)符，如下所示：如果用戶沒(méi)有帳戶，則創(chuàng)建用戶帳戶；如果用戶有帳戶，則將其登錄到網(wǎng)站。

編寫(xiě)演示應(yīng)用程序

我們將使用 Slim PHP 框架構(gòu)建一個(gè)簡(jiǎn)單的 Web 應(yīng)用程序，以演示如何實(shí)現(xiàn)使用 HybridAuth 進(jìn)行社交登錄的實(shí)際示例。

我假設(shè)您已安裝 HybridAuth 和 Slim 框架。否則，請(qǐng)參閱上面的安裝指南。

應(yīng)用程序結(jié)構(gòu)

<code>$adapter = $hybridauth->authenticate( "Facebook" );</code>

這是數(shù)據(jù)庫(kù)表的 SQL。

<code>$adapter = $hybridauth->authenticate( "Twitter" );</code>

編寫(xiě)應(yīng)用程序模型

應(yīng)用程序模型的所有代碼都應(yīng)放在 src 文件夾中的 App_Model.php 文件中。

該文件命名空間為 Model，后跟類定義和構(gòu)造函數(shù)。

<code>$adapter = $hybridauth->authenticate( "Google" );</code>

identifier_exists 方法如果標(biāo)識(shí)符（用戶標(biāo)識(shí)號(hào)）已存在于數(shù)據(jù)庫(kù)中則返回 true，否則返回 false。

<code>$user_profile = $adapter->getUserProfile();</code>

register_user 方法將用戶個(gè)人資料數(shù)據(jù)插入數(shù)據(jù)庫(kù)。

<code>"Github"   => [
    "enabled" => true,
    "keys"    => [
        "id"     => "",
        "secret" => ""
    ],
    "wrapper" => [ "path" => "providers/GitHub.php", "class" => "Hybrid_Providers_GitHub" ]
]</code>

login_user 方法在調(diào)用時(shí)，將創(chuàng)建的用戶會(huì)話添加到 HybridAuth 會(huì)話（在提供商成功授權(quán)用戶后創(chuàng)建）。

<code>$adapter = $hybridauth->authenticate( "Github" );</code>

logout_user 方法在單擊注銷(xiāo)鏈接時(shí)刪除或銷(xiāo)毀用戶的會(huì)話。

<code>|-scr/
|----App_Model.php
|-templates/
|----login.php
|----welcome.php
|-vendor/
|-composer.json
|-config.php
|-hybrid.php
|-index.php
|-.htaccess</code>

最后，getter 方法返回用戶的姓名、電子郵件和頭像 URL。

<code>{
    "require": {
        "slim/slim": "2.*",
        "hybridauth/hybridauth": "2.3.0"
    }
}</code>

通過(guò)將以下代碼添加到您的 composer.json 文件中，為 Model 類注冊(cè) PSR-4 自動(dòng)加載器。

<code>return 
    [
        "base_url"   => "http://slim.local/",
        "providers"  => [
            "Google"   => [
                "enabled" => true,
                "keys"    => [ "id" => "", "secret" => "" ],
            ],
            "Facebook" => [
                "enabled"        => true,
                "keys"           => [ "id" => "", "secret" => "" ],
                "trustForwarded" => false
            ],
            "Twitter"  => [
                "enabled" => true,
                "keys"    => [ "key" => "", "secret" => "" ]
            ],
        ],
        "debug_mode" => true,
        "debug_file" => "bug.txt",
    ];</code>

運(yùn)行 composer dump-autoload 以重新生成 vendor/autoload.php 文件。

應(yīng)用程序邏輯

在應(yīng)用程序 index.php 文件中加載 composer 自動(dòng)加載文件并實(shí)例化 Slim。

<code>require 'vendor/autoload.php';
$hybridauth = new Hybrid_Auth( 'config.php' );</code>

創(chuàng)建一個(gè)名為 templates 的目錄來(lái)存儲(chǔ)所有模板文件，然后在 Slim 中注冊(cè)或配置它，如下所示：

<code>$adapter = $hybridauth->authenticate( "Facebook" );</code>

創(chuàng)建一個(gè) Slim 數(shù)據(jù)庫(kù)單例資源，該資源在調(diào)用時(shí)將返回?cái)?shù)據(jù)庫(kù)連接實(shí)例。

<code>$adapter = $hybridauth->authenticate( "Twitter" );</code>

還創(chuàng)建了另一個(gè)返回 HybridAuth 實(shí)例的單例資源。

<code>$adapter = $hybridauth->authenticate( "Google" );</code>

通過(guò)傳遞數(shù)據(jù)庫(kù)連接作為參數(shù)來(lái)實(shí)例化應(yīng)用程序模型類。

<code>$user_profile = $adapter->getUserProfile();</code>

下面的 authenticate 函數(shù)在作為參數(shù)添加到路由時(shí)，如果用戶未登錄，則將其重定向到登錄頁(yè)面。

<code>"Github"   => [
    "enabled" => true,
    "keys"    => [
        "id"     => "",
        "secret" => ""
    ],
    "wrapper" => [ "path" => "providers/GitHub.php", "class" => "Hybrid_Providers_GitHub" ]
]</code>

當(dāng)注銷(xiāo)的用戶訪問(wèn)應(yīng)用程序主頁(yè)或索引頁(yè)面時(shí)，將其重定向到登錄頁(yè)面。

<code>$adapter = $hybridauth->authenticate( "Github" );</code>

以下是社交登錄鏈接的路由定義。即，當(dāng)單擊鏈接 http://slim.local/login/facebook 時(shí)，HybridAuth 將用戶重定向到 Facebook 以進(jìn)行授權(quán)。Twitter http://slim.local/login/twitter、Google http://slim.local/login/google 和所有其他受支持的提供商也是如此。

<code>|-scr/
|----App_Model.php
|-templates/
|----login.php
|----welcome.php
|-vendor/
|-composer.json
|-config.php
|-hybrid.php
|-index.php
|-.htaccess</code>

調(diào)用 HybridAuth 的 authenticate() 方法將用戶重定向到給定的社交提供商。

成功授權(quán)后，$user_profile 變量將填充用戶個(gè)人資料數(shù)據(jù)。

調(diào)用 identifier_exists() 方法檢查用戶標(biāo)識(shí)符是否在數(shù)據(jù)庫(kù)中存在。如果為真，則用戶登錄到網(wǎng)站。否則，將為用戶創(chuàng)建一個(gè)帳戶，然后用戶登錄。

這是注銷(xiāo)路由的代碼。

CREATE TABLE IF NOT EXISTS `users` (
`id` int(10) NOT NULL AUTO_INCREMENT,
PRIMARY KEY  (id),
  `identifier` varchar(50) NOT NULL,
UNIQUE KEY `identifier` (`identifier`),
  `email` varchar(50) DEFAULT NULL,
  `first_name` varchar(20) DEFAULT NULL,
  `last_name` varchar(20) DEFAULT NULL,
  `avatar_url` varchar(255)
) ENGINE=InnoDB;

我們已經(jīng)在模型類中討論過(guò)的 logout_user 方法被調(diào)用以銷(xiāo)毀用戶會(huì)話，并且還調(diào)用 Hybrid_Auth::logoutAllProviders() 以將用戶注銷(xiāo)出連接的提供商。

用戶登錄后重定向到的歡迎頁(yè)面的路由：

<?php namespace Model;

class App_Model
{

    /** @var object Database connection */
    private $conn;

    /**
     * Instantiate the model class.
     *
     * @param object $db_connection DB connection
     */
    public function __construct(\PDO $db_connection)
    {
        $this->conn = $db_connection;
    }

    // ... rest of the methods ...
}

最后，運(yùn)行 Slim 應(yīng)用程序。

/**
     * Check if a HybridAuth identifier already exists in DB
     *
     * @param int $identifier
     *
     * @return bool
     */
    public function identifier_exists($identifier)
    {
        try {
            $sql    = 'SELECT identifier FROM users';
            $query  = $this->conn->query($sql);
            $result = $query->fetchAll(\PDO::FETCH_COLUMN, 0);

            return in_array($identifier, $result);
        } catch ( \PDOException $e ) {
            die( $e->getMessage() );
        }

    }

請(qǐng)參閱應(yīng)用程序的 GitHub 存儲(chǔ)庫(kù)以獲取完整的源代碼。

結(jié)論

在本文中，我們學(xué)習(xí)了如何使用功能強(qiáng)大且健壯的 HybridAuth PHP 庫(kù)將社交登錄功能與網(wǎng)站集成。

如果您有任何疑問(wèn)或貢獻(xiàn)，請(qǐng)?jiān)谠u(píng)論中告訴我們。

使用 PHP 和 HybridAuth 進(jìn)行社交登錄的常見(jiàn)問(wèn)題解答 (FAQ)

什么是 HybridAuth，它如何與 PHP 一起用于社交登錄？

HybridAuth 是一個(gè)流行的開(kāi)源社交登錄 PHP 庫(kù)。它允許 Web 開(kāi)發(fā)人員輕松構(gòu)建社交應(yīng)用程序，方法是提供一種簡(jiǎn)單的方法來(lái)通過(guò)用戶的社交媒體帳戶對(duì)其進(jìn)行身份驗(yàn)證。HybridAuth 充當(dāng)應(yīng)用程序與各種社交 API 和身份提供商（如 Facebook、Twitter 和 Google）之間的抽象 API。它的工作原理是與 PHP 應(yīng)用程序中現(xiàn)有的登錄系統(tǒng)集成，并添加社交登錄功能。

如何在我的 PHP 應(yīng)用程序中安裝和配置 HybridAuth？

HybridAuth 可以通過(guò) Composer（PHP 中的依賴項(xiàng)管理工具）安裝。安裝后，您需要通過(guò)設(shè)置要使用的提供商（社交網(wǎng)絡(luò)）來(lái)對(duì)其進(jìn)行配置。每個(gè)提供商都需要一組唯一的參數(shù)，例如密鑰和密鑰，您可以通過(guò)在各個(gè)社交網(wǎng)絡(luò)的開(kāi)發(fā)者平臺(tái)上創(chuàng)建應(yīng)用程序來(lái)獲得這些參數(shù)。

HybridAuth 用于社交登錄的安全級(jí)別如何？

HybridAuth 非常安全，因?yàn)樗褂?OAuth（一種開(kāi)放的訪問(wèn)委托標(biāo)準(zhǔn)）。OAuth 提供安全的指定訪問(wèn)，這意味著用戶可以授予網(wǎng)站訪問(wèn)其在其他網(wǎng)站上的信息的權(quán)限，而無(wú)需向其提供密碼。這使得 HybridAuth 成為實(shí)現(xiàn)社交登錄的安全選擇。

我可以在多個(gè)網(wǎng)站上使用 HybridAuth 進(jìn)行社交登錄嗎？

是的，HybridAuth 可用于多個(gè)網(wǎng)站。您只需要使用每個(gè)網(wǎng)站的正確回調(diào) URL 配置庫(kù)即可。這使得它成為管理多個(gè)網(wǎng)站的開(kāi)發(fā)人員的靈活解決方案。

如何處理 HybridAuth 中的錯(cuò)誤？

HybridAuth 具有內(nèi)置的錯(cuò)誤處理系統(tǒng)。發(fā)生錯(cuò)誤時(shí)，它會(huì)拋出異常，您可以根據(jù)應(yīng)用程序的錯(cuò)誤處理策略捕獲和處理該異常。這使得調(diào)試和修復(fù)問(wèn)題變得更容易。

我可以自定義 HybridAuth 的社交登錄按鈕的外觀和風(fēng)格嗎？

是的，您可以自定義社交登錄按鈕的外觀和風(fēng)格。HybridAuth 提供社交登錄的功能，但按鈕的設(shè)計(jì)和布局完全取決于您。

如何在我的 PHP 應(yīng)用程序中更新 HybridAuth 庫(kù)？

更新 HybridAuth 就像在 Composer 中運(yùn)行命令一樣簡(jiǎn)單。這確保您始終擁有包含所有安全補(bǔ)丁和更新的最新版本。

我可以將 HybridAuth 與其他 PHP 框架一起使用嗎？

是的，HybridAuth 與框架無(wú)關(guān)，可以與任何 PHP 框架一起使用。這使得它成為使用不同 PHP 框架的開(kāi)發(fā)人員的多功能選擇。

如何在我的本地開(kāi)發(fā)環(huán)境中測(cè)試 HybridAuth 的社交登錄？

在本地測(cè)試社交登錄可能很棘手，因?yàn)樯缃痪W(wǎng)絡(luò)需要有效的回調(diào) URL。但是，您可以使用 ngrok 等工具將本地服務(wù)器公開(kāi)到互聯(lián)網(wǎng)，并將該 URL 用作回調(diào) URL。

我可以使用 HybridAuth 通過(guò)非社交帳戶（如電子郵件和密碼）對(duì)用戶進(jìn)行身份驗(yàn)證嗎？

不可以，HybridAuth 專為社交登錄而設(shè)計(jì)。對(duì)于傳統(tǒng)的電子郵件和密碼身份驗(yàn)證，您需要使用其他 PHP 庫(kù)或構(gòu)建您自己的身份驗(yàn)證系統(tǒng)。

The output maintains the original image formatting and placement. The text has been paraphrased and reorganized to improve flow and readability while preserving the original meaning. The code examples remain unchanged.

以上是與Hybridauth的PHP中的社交登錄的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！