编辑“︁PHP OAuth认证”︁（章节）

= PHP OAuth认证 =

== 介绍 ==
'''OAuth'''（开放授权）是一种开放标准协议，允许用户在不共享密码的情况下，授权第三方应用访问其存储在服务提供商上的资源。PHP OAuth认证是指使用PHP实现OAuth协议，以便在Web应用中集成第三方登录（如Google、Facebook、Twitter等）或访问受保护的API资源。

OAuth的核心思想是通过令牌（Token）而非用户凭证（如密码）进行授权。常见的OAuth版本包括OAuth 1.0a和OAuth 2.0，其中OAuth 2.0更简单且广泛使用。

== OAuth 2.0 流程 ==
OAuth 2.0的基本流程如下：

<mermaid>
sequenceDiagram
    participant User
    participant Client (Your PHP App)
    participant Authorization Server (e.g., Google)
    participant Resource Server (e.g., Google API)

    User->>Client: 请求访问资源
    Client->>Authorization Server: 重定向用户到授权页面
    User->>Authorization Server: 登录并授权
    Authorization Server->>Client: 返回授权码
    Client->>Authorization Server: 用授权码换取访问令牌
    Authorization Server->>Client: 返回访问令牌
    Client->>Resource Server: 使用令牌访问资源
    Resource Server->>Client: 返回受保护的数据
</mermaid>

== PHP实现OAuth 2.0 ==
以下是使用PHP实现OAuth 2.0的基本步骤和代码示例。

=== 1. 注册应用 ===
首先，在目标服务（如Google、Facebook）上注册应用，获取`client_id`和`client_secret`。

=== 2. 安装OAuth库 ===
推荐使用`league/oauth2-client`库：
<syntaxhighlight lang="bash">
composer require league/oauth2-client
</syntaxhighlight>

=== 3. 代码示例：Google OAuth登录 ===
以下是一个使用Google OAuth 2.0的PHP示例：

<syntaxhighlight lang="php">
<?php
require 'vendor/autoload.php';

use League\OAuth2\Client\Provider\Google;

// 配置Google OAuth
$provider = new Google([
    'clientId'     => 'YOUR_GOOGLE_CLIENT_ID',
    'clientSecret' => 'YOUR_GOOGLE_CLIENT_SECRET',
    'redirectUri'  => 'https://your-website.com/oauth-callback.php',
]);

// 授权流程
if (!isset($_GET['code'])) {
    // 第一步：生成授权URL并重定向用户
    $authUrl = $provider->getAuthorizationUrl();
    $_SESSION['oauth2state'] = $provider->getState();
    header('Location: ' . $authUrl);
    exit;

} elseif (empty($_GET['state']) || ($_GET['state'] !== $_SESSION['oauth2state'])) {
    // 验证state防止CSRF攻击
    unset($_SESSION['oauth2state']);
    exit('Invalid state');

} else {
    // 第二步：用授权码换取访问令牌
    try {
        $token = $provider->getAccessToken('authorization_code', [
            'code' => $_GET['code']
        ]);

        // 获取用户信息
        $user = $provider->getResourceOwner($token);
        $userData = $user->toArray();

        echo "Hello, " . $userData['name'] . "!";
        echo "<pre>" . print_r($userData, true) . "</pre>";

    } catch (Exception $e) {
        exit('Failed to get access token: ' . $e->getMessage());
    }
}
?>
</syntaxhighlight>

=== 输入与输出 ===
- 输入：用户点击登录按钮，被重定向到Google授权页面。
- 输出：用户授权后，返回包含用户信息的数组，例如：
<syntaxhighlight lang="php">
Array
(
    [id] => 123456789
    [name] => John Doe
    [email] => john@example.com
    [picture] => https://lh3.googleusercontent.com/.../photo.jpg
)
</syntaxhighlight>

== 实际应用场景 ==
1. '''第三方登录'''：允许用户使用Google、Facebook账号登录你的网站。
2. '''API访问'''：访问受保护的API（如Twitter API、GitHub API）。
3. '''数据同步'''：从第三方服务（如Google Drive）获取用户数据。

== 安全注意事项 ==
- 始终验证`state`参数以防止CSRF攻击。
- 使用HTTPS传输令牌。
- 不要将`client_secret`暴露给前端。
- 令牌应存储在安全的地方（如服务器会话或数据库）。

== 常见问题 ==
=== Q: OAuth 1.0和OAuth 2.0有什么区别？ ===
- OAuth 1.0使用签名和令牌，更复杂但更安全。
- OAuth 2.0使用HTTPS和短期令牌，更简单但不直接兼容1.0。

=== Q: 如何刷新过期的令牌？ ===
在OAuth 2.0中，可以使用`refresh_token`获取新的访问令牌：
<syntaxhighlight lang="php">
$newToken = $provider->getAccessToken('refresh_token', [
    'refresh_token' => $oldToken->getRefreshToken()
]);
</syntaxhighlight>

== 总结 ==
PHP OAuth认证是实现第三方登录和API访问的关键技术。通过OAuth 2.0，开发者可以安全地集成Google、Facebook等服务，而无需处理用户密码。本文介绍了基本流程、PHP实现代码以及安全注意事项，适合初学者和高级用户参考。

{{Stub|php}}

[[Category:编程语言]]
[[Category:PHP]]
[[Category:PHP网络编程]]