在为我的一个新项目添加用户认证功能时，我决定支持 “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 绝对是一个值得考虑的选择。它不仅简化了配置和流程，还提供了良好的可扩展性和灵活性，能够满足各种不同的需求。
