使用Dropbox API构建自己的Dropbox客户端

Dropbox：利用PHP和Laravel构建自定义Dropbox客户端

Dropbox凭借其简洁性、自动同步功能、跨平台支持以及其他强大的功能，在众多文件托管解决方案中脱颖而出。

作为PHP开发者，您可以充分利用Dropbox API创建应用程序，以实现Dropbox账户的各种操作。本教程将使用Dropbox API v2。如果您想动手实践，可以从Github克隆项目。

核心要点

• 使用Dropbox API v2，结合PHP和Laravel构建自定义Dropbox客户端，从而控制用户文件操作。
• 首先在Dropbox开发者网站注册一个新的应用程序，获取必要的凭据，例如App Key和Secret，这些对于API身份验证至关重要。
• 通过设置必要的路由和中间件来处理用户身份验证和文件操作，配置Laravel环境以集成Dropbox。
• 在Laravel中安装并使用Guzzle、Purl和Carbon库分别处理HTTP请求、URL操作和日期/时间转换。
• 通过特定的API端点实现文件上传、下载、搜索和版本管理等各种功能，并使用基于令牌的访问。
• 通过设置适当的权限（文件夹访问或完整Dropbox访问）并使用OAuth2进行用户身份验证和授权来保护您的应用程序。
• 探索高级功能，例如用于实时文件更新通知的Webhook，以及用于增强用户交互的Chooser和Saver等嵌入式工具。

创建Dropbox应用

首先，访问Dropbox开发者网站并创建一个新的应用程序。

Dropbox提供两种API：面向公众的Dropbox API和面向团队的Business API。这两种API几乎相同，唯一的区别在于Business API专门用于企业帐户，因此默认情况下包含团队功能，例如访问团队信息、团队成员文件访问和团队成员管理。我们将使用前者。

创建应用程序后，您将看到应用程序设置页面：

在这里，您可以设置以下内容：

• 开发用户 – 这允许您添加Dropbox用户来测试您的应用程序。默认情况下，应用程序的状态为“开发”。这意味着只有您可以测试其功能。如果您允许任何其他用户访问您的应用程序，他们将无法使用它。
• 权限类型 – 这是您在创建应用程序时选择的设置。只有两种权限类型：文件夹和完整Dropbox。文件夹意味着您的应用程序只能访问您指定的文件夹。完整Dropbox意味着您的应用程序可以访问所有用户的文件。
• App Key和Secret – 这是Dropbox用来识别您的应用程序的唯一密钥。稍后我们将需要它。
• OAuth2重定向URL – 在这里您可以设置URL，用户授权必要的权限后，您的应用程序可以重定向到这些URL。现在先留空，稍后您将添加值。现在请注意，只有您在此处指定的URL才能用于重定向。
• 允许隐式授权 – 是否在用户向您的应用程序授予必要的权限后自动生成访问令牌。如果您在客户端使用Dropbox，则应将其设置为“允许”，以便您可以通过JavaScript获取访问令牌。对于本项目，您应将其设置为“不允许”。
• 生成的访问令牌 – 您可以使用此令牌为您的帐户生成访问令牌。访问令牌可用于向API发出请求。
• Chooser/Saver域名 – 如果您使用Chooser和Saver等嵌入式工具，则需要在此处指定嵌入这些工具的域名。
• Webhooks – 如果您希望服务器在用户Dropbox帐户中的文件发生更改时执行特定操作，则可以使用Webhooks。在本教程中，我们将不会介绍Webhooks，因此如果您在应用程序中需要此功能，建议您查看Webhooks文档。

构建应用程序

现在您可以开始构建应用程序了。我们将使用Laravel。

安装依赖项

<code class="language-bash">composer create-project --prefer-dist laravel/laravel pinch</code>

安装完成后，您还需要安装Guzzle、Purl和Carbon。

<code class="language-bash">composer require nesbot/carbon jwage/purl guzzlehttp/guzzle</code>

我们将使用Guzzle向Dropbox API发出HTTP请求，使用Purl构建Dropbox登录URL，使用Carbon以用户时区表示文件日期。

配置

安装Laravel后，打开项目根目录中的.env文件并添加Dropbox配置：

<code>DROPBOX_APP_KEY="YOUR DROPBOX APP KEY"
DROPBOX_APP_SECRET="YOUR DROPBOX APP SECRET"
DROPBOX_REDIRECT_URI="YOUR DROPBOX LOGIN REDIRECT URL"</code>

使用您之前从Dropbox开发者网站获得的App Key和App Secret作为DROPBOX_APP_KEY和DROPBOX_APP_SECRET的值。对于DROPBOX_REDIRECT_URI，您必须指定一个http URL，因此如果您使用虚拟主机，则需要使用类似Ngrok的工具来提供服务。然后，在您的虚拟主机配置中，添加Ngrok提供的URL作为ServerAlias。

<code class="language-xml"><virtualhost>
    ServerName pinch.dev
    ServerAlias xxxxxxx.ngrok.io
    ServerAdmin wern@localhost
    DocumentRoot /home/wern/www/pinch/public
</virtualhost></code>

...(其余部分与原文相同，篇幅过长，此处省略)...

以上是使用Dropbox API构建自己的Dropbox客户端的详细内容。更多信息请关注PHP中文网其他相关文章！