luketowers/oc-gdrivefilesystemdriver-plugin

此软件包已被弃用且不再维护。作者建议使用 winter/wn-drivergoogledrive-plugin 软件包。

为 OctoberCMS 提供 Google Drive 文件系统驱动程序

v1.0.1 2018-04-11 00:22 UTC

This package is auto-updated.

Last update: 2023-08-12 08:18:02 UTC


README

请使用 https://github.com/wintercms/wn-drivergoogledrive-plugin 代替。

关于

OctoberCMS 的 Google Drive Flysystem Driver 实现。

重要提示

Google Drive 是基于 ID 的文件系统;它支持在给定目录内存在多个同名文件。此驱动程序在请求文件名时公开文件和目录 ID,这意味着如果您将其连接到媒体管理器以查看文件,您将看到如下所示的图片

Google Drive IDs instead of filenames

安装

要从 市场 安装,单击“添加到项目”按钮,然后选择要将该插件添加到的项目,更新项目以拉取插件。

要从后端安装,转到 设置 -> 更新与插件 -> 安装插件,然后搜索 LukeTowers.GDriveFileSystemDriver

要从 仓库 安装,将其克隆到 plugins/luketowers/gdrivefilesystemdriver,然后从您的项目根目录运行 composer update 以拉取依赖项。

要使用 Composer 安装,从您的项目根目录运行 composer require luketowers/oc-gdrivefilesystemdriver-plugin

配置

使用此插件提供的 googledrive 存储驱动程序的示例存储磁盘配置

'mygoogledrive' => [
    'driver' => 'googledrive',
    'clientId' => '',
    'clientSecret' => '',
    'refreshToken' => '',
    
    // Null for the route folder, otherwise a folder ID to base the driver off of
    'folderId' => null,
],

有关如何获取 clientIdclientSecretrefreshTokenfolderId 的值的说明,请参阅下面的配置指南。

用法

有关与此驱动程序交互的用法示例,请参阅此处:ivanvermeyen/laravel-google-drive-demo#available-routes

配置指南

获取您的客户端 ID 和密钥

登录到您的 Google 账户并访问此网站

https://console.developers.google.com/

创建项目

使用顶部的下拉菜单创建一个新项目。

Create a new project

输入名称后,服务器上成功创建项目可能需要几秒钟。

启用 Drive API

请确保您已选中顶部的项目。

然后转到“库”并点击“G Suite APIs”下的“Drive API”。

Add Drive API

然后启用它。

Enable Google Drive API

创建凭证

转到“凭证”并点击“OAuth 授权屏幕”标签页。填写“用户显示的产品名称”并保存。其他字段无需担心。

Consent Screen

然后返回“凭证”,点击“创建凭证”按钮并选择“OAuth 客户端 ID”。

Create Credentials

选择“Web 应用程序”并给它命名。

在“授权重定向 URI”中添加 https://developers.google.com/oauthplayground。您将在下一步中使用此 URI 获取刷新令牌。获取令牌后,您可以删除该 URI。

Credentials

点击创建,并记下您的 客户端 ID客户端密钥

获取您的刷新令牌

前往 https://developers.google.com/oauthplayground

请确保您已将此 URL 添加到上一步骤中的“授权重定向 URI”。

在右上角,点击设置图标,勾选“使用您自己的 OAuth 凭证”并粘贴您的客户端 ID 和客户端密钥。

Use your own OAuth credentials

在左侧步骤 1 中,滚动到“Drive API v3”,展开并勾选第一个 drive 权限。

Check Scopes

点击“授权 API”,并在提示时允许访问您的帐户。可能会有几个警告提示,只需继续即可。

当您到达步骤 2 时,勾选“在令牌过期前自动刷新令牌”并点击“用授权代码交换令牌”。

Exchange authorization code for tokens

当您到达步骤 3 时,再次点击步骤 2,您应该会看到您的 刷新令牌

Refresh Token

获取您的根文件夹 ID

如果您想在 Google Drive 的根目录中存储文件,则文件夹 ID 可以是 null。否则,进入您的 Drive 并创建一个文件夹。

因为 Google Drive 允许重名,所以它使用唯一的 ID 来标识每个文件和文件夹。如果您打开您的文件夹,您将看到 URL 中的 文件夹 ID

Folder ID