如何使用PHP/cURL连接私有GitHub仓库并拉取文件

我正在尝试用PHP和cURL连接自己创建的私有GitHub仓库，拉取里面的文件。目前我已经掌握了PHP发起cURL请求、设置请求头的方法，也了解GitHub API获取文件的基础结构，清楚仓库内容接口的请求格式。但在认证环节遇到了麻烦——我不知道怎么获取OAuth 2令牌，官方文档里这部分的说明不够明确。

我推测需要一个特殊的密钥（应该就是这个OAuth令牌）来证明我有私有仓库的访问权限，但具体怎么生成、怎么使用这个令牌完全摸不着头绪。如果能搞清楚令牌的生成流程和正确的使用方式，我就能完成后续的请求了，希望有人能指导一下。

之前在Adolfo Eloy的指导下，我终于搞定了这个困扰很久的问题，把完整的操作流程和PHP实现代码分享给你：

一、生成个人访问令牌（Personal Access Token） #

这是访问私有仓库API的核心凭证，步骤如下：

• 登录GitHub账号，点击右上角头像，选择「Settings」（设置）
• 左侧菜单拉到最底部，点击「Developer settings」（开发者设置）
• 选择「Personal access tokens」（个人访问令牌），再点击「Generate new token」（生成新令牌）
• 给令牌起个辨识度高的名称（比如「Private Repo API Access」），然后勾选权限列表最顶部的「repo」复选框——这个权限会赋予你对私有仓库的完整访问权限
• 拉到页面底部点击「Generate token」，务必立刻复制生成的令牌字符串（页面刷新后就无法再查看）

二、用Postman快速验证令牌有效性 #

拿到令牌后，可以先通过Postman确认是否能正常访问：

• 新建GET请求，地址填你的仓库API地址，格式为 https://api.github.com/repos/你的用户名/你的私有仓库名
• 在请求头中添加键为 Authorization、值为 token 你复制的令牌字符串 的项
• 发送请求，若返回仓库的详细信息，说明令牌生效，接下来就可以用PHP/cURL实现了

三、PHP/cURL实现私有仓库文件拉取示例 #

下面是一个完整的PHP代码示例，用于拉取私有仓库中指定文件的内容：

<?php
// 配置参数
$githubUser = '你的GitHub用户名';
$repoName = '你的私有仓库名称';
$targetFile = '要拉取的文件路径，比如docs/README.md';
$accessToken = '你生成的个人访问令牌';

// 构建API请求URL
$apiEndpoint = "https://api.github.com/repos/{$githubUser}/{$repoName}/contents/{$targetFile}";

// 初始化cURL会话
$curl = curl_init($apiEndpoint);

// 设置cURL选项
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    "Authorization: token {$accessToken}",
    "User-Agent: PHP-cURL-Client" // GitHub API强制要求携带User-Agent头
]);

// 执行请求并获取响应
$response = curl_exec($curl);
$httpStatus = curl_getinfo($curl, CURLINFO_HTTP_CODE);

// 关闭cURL会话
curl_close($curl);

// 处理响应结果
if ($httpStatus === 200) {
    $result = json_decode($response, true);
    // GitHub返回的文件内容是Base64编码，需要解码
    $fileContent = base64_decode($result['content']);
    echo "文件内容：<br>" . nl2br($fileContent);
} else {
    echo "请求失败，状态码：{$httpStatus}<br>响应信息：{$response}";
}
?>

重要注意事项 #

• 个人访问令牌等同于你的账号密码，一定要妥善保管，不要泄露给他人，也不要硬编码到公开代码仓库中
• 如果只需要拉取文件的权限，也可以勾选「repo」权限下的子项，但直接勾选顶部的「repo」会更便捷
• GitHub API要求所有请求必须携带User-Agent头，否则会返回403错误，所以代码中一定要包含这个请求头

内容的提问来源于stack exchange，提问作者HartleySan