在為我的一個新項目添加用戶認證功能時，我決定支持 “Sign in with Apple”。我知道這將為用戶提供更便捷的注冊和登錄體驗，但同時也清楚，直接對接 Apple 的 OAuth 2.0 API 會比較復雜。
我需要處理各種配置，例如 client id、team id、key id，以及下載和管理私鑰文件。此外，oauth 2.0 的授權碼流程也需要仔細處理，以確保安全性和用戶體驗。
為了簡化開發流程，我開始尋找現有的 php 庫，最終找到了 patrickbussmann/oauth2-apple。
patrickbussmann/oauth2-apple 是一個基于 PHP League’s OAuth 2.0 Client 的 Provider，專門用于支持 Apple ID 的 OAuth 2.0 認證。它封裝了與 Apple 認證服務器交互的復雜性，提供了一組簡潔易用的 API，使開發者能夠輕松地將 “Sign in with Apple” 功能集成到 PHP 應用中。
使用 Composer 安裝非常簡單：
立即學習“PHP免費學習筆記（深入）”；
composer require patrickbussmann/oauth2-apple
以下是一個簡單的示例，展示如何使用 patrickbussmann/oauth2-apple 實現授權碼流程：
// 引入必要的類 use LeagueOAuth2ClientProviderApple; use FirebaseJWTJWT; // 解決時鐘偏移問題 JWT::$leeway = 60; // 配置 Provider $provider = new Apple([ 'clientId' => '{apple-client-id}', 'teamId' => '{apple-team-id}', 'keyFileId' => '{apple-key-file-id}', 'keyFilePath' => '{apple-key-file-path}', 'redirectUri' => 'https://example.com/callback-url', ]); // 如果沒有授權碼，則獲取授權碼 if (!isset($_GET['code'])) { $authorizationUrl = $provider->getAuthorizationUrl(); $_SESSION['oauth2state'] = $provider->getState(); header('Location: '.$authorizationUrl); exit; } // 驗證 state，防止 CSRF 攻擊 elseif (empty($_GET['state']) || ($_GET['state'] !== $_SESSION['oauth2state'])) { unset($_SESSION['oauth2state']); exit('Invalid state'); } // 獲取訪問令牌 else { $token = $provider->getAccessToken('authorization_code', [ 'code' => $_GET['code'] ]); // 獲取用戶信息 (注意：只有首次登錄才能獲取完整信息) try { $user = $provider->getResourceOwner($token); printf('Hello %s!', $user->getFirstName()); } catch (Exception $e) { exit('Failed to get user details'); } // 使用訪問令牌 echo $token->getToken(); }
通過使用 patrickbussmann/oauth2-apple 庫，我避免了手動處理 OAuth 2.0 協議的復雜性，節省了大量開發時間。同時，該庫還提供了其他有用的功能，例如刷新令牌、管理 scopes 等，使我能夠更靈活地控制 Apple 登錄流程。
總的來說，patrickbussmann/oauth2-apple 庫極大地簡化了 PHP 應用集成 Apple 登錄的流程，提高了開發效率，并確保了安全性和用戶體驗。如果你需要在你的 PHP 應用中添加 “Sign in with Apple” 功能，那么 patrickbussmann/oauth2-apple 絕對是一個值得考慮的選擇。它不僅簡化了配置和流程，還提供了良好的可擴展性和靈活性，能夠滿足各種不同的需求。
