luketowers / oc-gdrivefilesystemdriver-plugin
Requires
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,这意味着如果您将其连接到媒体管理器以查看文件,您将看到如下所示的图片
安装
要从 市场 安装,单击“添加到项目”按钮,然后选择要将该插件添加到的项目,更新项目以拉取插件。
要从后端安装,转到 设置 -> 更新与插件 -> 安装插件,然后搜索 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,
],
有关如何获取 clientId
、clientSecret
、refreshToken
和 folderId
的值的说明,请参阅下面的配置指南。
用法
有关与此驱动程序交互的用法示例,请参阅此处:ivanvermeyen/laravel-google-drive-demo#available-routes
配置指南
获取您的客户端 ID 和密钥
登录到您的 Google 账户并访问此网站
https://console.developers.google.com/
创建项目
使用顶部的下拉菜单创建一个新项目。
输入名称后,服务器上成功创建项目可能需要几秒钟。
启用 Drive API
请确保您已选中顶部的项目。
然后转到“库”并点击“G Suite APIs”下的“Drive API”。
然后启用它。
创建凭证
转到“凭证”并点击“OAuth 授权屏幕”标签页。填写“用户显示的产品名称”并保存。其他字段无需担心。
然后返回“凭证”,点击“创建凭证”按钮并选择“OAuth 客户端 ID”。
选择“Web 应用程序”并给它命名。
在“授权重定向 URI”中添加 https://developers.google.com/oauthplayground。您将在下一步中使用此 URI 获取刷新令牌。获取令牌后,您可以删除该 URI。
点击创建,并记下您的 客户端 ID 和 客户端密钥。
获取您的刷新令牌
前往 https://developers.google.com/oauthplayground。
请确保您已将此 URL 添加到上一步骤中的“授权重定向 URI”。
在右上角,点击设置图标,勾选“使用您自己的 OAuth 凭证”并粘贴您的客户端 ID 和客户端密钥。
在左侧步骤 1 中,滚动到“Drive API v3”,展开并勾选第一个 drive 权限。
点击“授权 API”,并在提示时允许访问您的帐户。可能会有几个警告提示,只需继续即可。
当您到达步骤 2 时,勾选“在令牌过期前自动刷新令牌”并点击“用授权代码交换令牌”。
当您到达步骤 3 时,再次点击步骤 2,您应该会看到您的 刷新令牌。
获取您的根文件夹 ID
如果您想在 Google Drive 的根目录中存储文件,则文件夹 ID 可以是 null
。否则,进入您的 Drive 并创建一个文件夹。
因为 Google Drive 允许重名,所以它使用唯一的 ID 来标识每个文件和文件夹。如果您打开您的文件夹,您将看到 URL 中的 文件夹 ID。