Laravel怎么集成GitHub来存储文件

这篇文章主要讲解了“Laravel怎么集成GitHub来存储文件”，文中的讲解内容简单清晰，易于学习与理解，下面请大家跟着小编的思路慢慢深入，一起来研究和学习“Laravel怎么集成GitHub来存储文件”吧！

GitHub API 介绍

接口文档：docs.github.com/en/rest

需要用到的是功能十分强大的 GitHub API，这里只需要 创建或更新文件内容 接口。

创建或更新文件内容

• 请求地址：api.github.com/repos/{owner}/{repo}/contents/{path}

• 请求方式：PUT

参数

committer 对象的属性

author 对象的属性

鉴权

官方提供了三种方式：

• Basic authentication - 用户名和密码

• OAuth3 Token - token

• OAuth3 key/secret - client_id 和 client_secret （只支持查询）

推荐使用第 2 种方式。

设置 token

Settings > Developer settings > Personal access tokens > Generate new token

生成的 token 要保存好，只显示一次。

创建仓库

一定要把仓库设置为公开的，目的是能够使用 jsDelivr CDN 加速。

使用 GitHub 仓库作为图床，存在的问题是国内访问 GitHub 的速度很慢，可以利用 jsDelivr CDN 来加速访问。jsDelivr 是一个免费开源的 CDN 解决方案，该平台是首个打通中国大陆与海外的免费 CDN 服务，拥有中国政府颁发的 ICP 许可证，无须担心中国防火墙问题而影响使用。使用 jsDelivr 加速访问，需要将自定义域名设置为 https://cdn.jsdelivr.net/gh/用户名/图床仓库名。

Laravel 代码

需要设置几个配置参数，建议放到 .env 文件中。

GITHUB_FILE_REPOSITORY=YOUR_REPOSITORYGITHUB_FILE_BRANCH=masterGITHUB_FILE_TOKEN=YOUR_TOKENGITHUB_FILE_PATH=YOUR_PATHGITHUB_FILE_NAME=1GITHUB_FILE_COMMIT_MESSAGE="YOUR COMMIT MESSAGE"

然后在 config 下创建一个配置文件，我创建了一个 github-file.php 配置文件

<?phpreturn [  'repository' => env('GITHUB_FILE_REPOSITORY', ''),  'branch' => env('GITHUB_FILE_BRANCH', 'master'),  'token' => env('GITHUB_FILE_TOKEN', ''),  'path' => env('GITHUB_FILE_PATH', ''),  'domain' => env('GITHUB_FILE_DOMAIN', 'https://cdn.jsdelivr.net/gh/'),  'name' => env('GITHUB_FILE_NAME', 1),  'commit_message' => env('GITHUB_FILE_COMMIT_MESSAGE', ''),];

创建一个 Trait 以复用上传功能

<?phpnamespace App\Traits;use Exception;use Illuminate\Support\Str;use Illuminate\Support\Facades\Http;trait UploadToGithub{    public function uploadToGithub($file, $message = '')    {        $path = config('github-file.path') . '/' . $this->setFileName($file);        $repository = config('github-file.repository');        if ($file->isValid()) {            $url = "https://api.github.com/repos/$repository/contents/$path";            $response = Http::withToken(config('github-file.token'))->put($url, [                'message' => $message ?: config('github-file.commit_message'),                'content' => base64_encode(file_get_contents($file))            ]);            // 上传失败抛出一个错误，成功则返回 JSON            $body = $response->throw()->json();            // 上传成功后 GitHub API 返回的是 201，其实有了上一步这里的判断可以省略            if ($response->successful()) {                return config('github-file.domain')                    ? rtrim(config('github-file.domain'), '/') . '/' . trim($repository, '/') . '/' . ltrim($body['content']['path'], '/')                    : $body['content']['download_url'];            }        }        throw new Exception('未发现图片');    }        private function setFileName($file)    {        switch (config('github-file.name')) {            case 1:                return date('YmdHis', time()) . '.' . $file->getClientOriginalExtension();            case 2:                return Str::random(32) . '.' . $file->getClientOriginalExtension();            case 3:            default:                return $file->getClientOriginalName();        }    }}

在需要的地方使用 UploadToGithub

use UploadToGithub;public function updload(Request $request){    $url = $this->uploadToGithub($request->file('file-field-name'));        return response()->json([        'code' => 200,        'message' => '上传成功',        'data' => [            'url' => $url        ]    ]);}

感谢各位的阅读，以上就是“Laravel怎么集成GitHub来存储文件”的内容了，经过本文的学习后，相信大家对Laravel怎么集成GitHub来存储文件这一问题有了更深刻的体会，具体使用情况还需要大家实践验证。这里是编程网，小编将为大家推送更多相关知识点的文章，欢迎关注！