Dropbox：利用PHP和Laravel構(gòu)建自定義Dropbox客戶端

Dropbox憑借其簡(jiǎn)潔性、自動(dòng)同步功能、跨平臺(tái)支持以及其他強(qiáng)大的功能，在眾多文件托管解決方案中脫穎而出。

作為PHP開(kāi)發(fā)者，您可以充分利用Dropbox API創(chuàng)建應(yīng)用程序，以實(shí)現(xiàn)Dropbox賬戶的各種操作。本教程將使用Dropbox API v2。如果您想動(dòng)手實(shí)踐，可以從Github克隆項(xiàng)目。

核心要點(diǎn)

• 使用Dropbox API v2，結(jié)合PHP和Laravel構(gòu)建自定義Dropbox客戶端，從而控制用戶文件操作。
• 首先在Dropbox開(kāi)發(fā)者網(wǎng)站注冊(cè)一個(gè)新的應(yīng)用程序，獲取必要的憑據(jù)，例如App Key和Secret，這些對(duì)于API身份驗(yàn)證至關(guān)重要。
• 通過(guò)設(shè)置必要的路由和中間件來(lái)處理用戶身份驗(yàn)證和文件操作，配置Laravel環(huán)境以集成Dropbox。
• 在Laravel中安裝并使用Guzzle、Purl和Carbon庫(kù)分別處理HTTP請(qǐng)求、URL操作和日期/時(shí)間轉(zhuǎn)換。
• 通過(guò)特定的API端點(diǎn)實(shí)現(xiàn)文件上傳、下載、搜索和版本管理等各種功能，并使用基于令牌的訪問(wèn)。
• 通過(guò)設(shè)置適當(dāng)?shù)臋?quán)限（文件夾訪問(wèn)或完整Dropbox訪問(wèn)）并使用OAuth2進(jìn)行用戶身份驗(yàn)證和授權(quán)來(lái)保護(hù)您的應(yīng)用程序。
• 探索高級(jí)功能，例如用于實(shí)時(shí)文件更新通知的Webhook，以及用于增強(qiáng)用戶交互的Chooser和Saver等嵌入式工具。

創(chuàng)建Dropbox應(yīng)用

首先，訪問(wèn)Dropbox開(kāi)發(fā)者網(wǎng)站并創(chuàng)建一個(gè)新的應(yīng)用程序。

Dropbox提供兩種API：面向公眾的Dropbox API和面向團(tuán)隊(duì)的Business API。這兩種API幾乎相同，唯一的區(qū)別在于Business API專門用于企業(yè)帳戶，因此默認(rèn)情況下包含團(tuán)隊(duì)功能，例如訪問(wèn)團(tuán)隊(duì)信息、團(tuán)隊(duì)成員文件訪問(wèn)和團(tuán)隊(duì)成員管理。我們將使用前者。

創(chuàng)建應(yīng)用程序后，您將看到應(yīng)用程序設(shè)置頁(yè)面：

在這里，您可以設(shè)置以下內(nèi)容：

• 開(kāi)發(fā)用戶 – 這允許您添加Dropbox用戶來(lái)測(cè)試您的應(yīng)用程序。默認(rèn)情況下，應(yīng)用程序的狀態(tài)為“開(kāi)發(fā)”。這意味著只有您可以測(cè)試其功能。如果您允許任何其他用戶訪問(wèn)您的應(yīng)用程序，他們將無(wú)法使用它。
• 權(quán)限類型 – 這是您在創(chuàng)建應(yīng)用程序時(shí)選擇的設(shè)置。只有兩種權(quán)限類型：文件夾和完整Dropbox。文件夾意味著您的應(yīng)用程序只能訪問(wèn)您指定的文件夾。完整Dropbox意味著您的應(yīng)用程序可以訪問(wèn)所有用戶的文件。
• App Key和Secret – 這是Dropbox用來(lái)識(shí)別您的應(yīng)用程序的唯一密鑰。稍后我們將需要它。
• OAuth2重定向URL – 在這里您可以設(shè)置URL，用戶授權(quán)必要的權(quán)限后，您的應(yīng)用程序可以重定向到這些URL?，F(xiàn)在先留空，稍后您將添加值?，F(xiàn)在請(qǐng)注意，只有您在此處指定的URL才能用于重定向。
• 允許隱式授權(quán) – 是否在用戶向您的應(yīng)用程序授予必要的權(quán)限后自動(dòng)生成訪問(wèn)令牌。如果您在客戶端使用Dropbox，則應(yīng)將其設(shè)置為“允許”，以便您可以通過(guò)JavaScript獲取訪問(wèn)令牌。對(duì)于本項(xiàng)目，您應(yīng)將其設(shè)置為“不允許”。
• 生成的訪問(wèn)令牌 – 您可以使用此令牌為您的帳戶生成訪問(wèn)令牌。訪問(wèn)令牌可用于向API發(fā)出請(qǐng)求。
• Chooser/Saver域名 – 如果您使用Chooser和Saver等嵌入式工具，則需要在此處指定嵌入這些工具的域名。
• Webhooks – 如果您希望服務(wù)器在用戶Dropbox帳戶中的文件發(fā)生更改時(shí)執(zhí)行特定操作，則可以使用Webhooks。在本教程中，我們將不會(huì)介紹Webhooks，因此如果您在應(yīng)用程序中需要此功能，建議您查看Webhooks文檔。

構(gòu)建應(yīng)用程序

現(xiàn)在您可以開(kāi)始構(gòu)建應(yīng)用程序了。我們將使用Laravel。

安裝依賴項(xiàng)

composer create-project --prefer-dist laravel/laravel pinch

安裝完成后，您還需要安裝Guzzle、Purl和Carbon。

composer require nesbot/carbon jwage/purl guzzlehttp/guzzle

我們將使用Guzzle向Dropbox API發(fā)出HTTP請(qǐng)求，使用Purl構(gòu)建Dropbox登錄URL，使用Carbon以用戶時(shí)區(qū)表示文件日期。

配置

安裝Laravel后，打開(kāi)項(xiàng)目根目錄中的.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開(kāi)發(fā)者網(wǎng)站獲得的App Key和App Secret作為DROPBOX_APP_KEY和DROPBOX_APP_SECRET的值。對(duì)于DROPBOX_REDIRECT_URI，您必須指定一個(gè)http URL，因此如果您使用虛擬主機(jī)，則需要使用類似Ngrok的工具來(lái)提供服務(wù)。然后，在您的虛擬主機(jī)配置中，添加Ngrok提供的URL作為ServerAlias。

<virtualhost *:80>
    ServerName pinch.dev
    ServerAlias xxxxxxx.ngrok.io
    ServerAdmin wern@localhost
    DocumentRoot /home/wern/www/pinch/public
</virtualhost>

...(其余部分與原文相同，篇幅過(guò)長(zhǎng)，此處省略)...

以上是使用Dropbox API構(gòu)建自己的Dropbox客戶端的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！