Dropbox: créez un client Dropbox personnalisé avec PHP et Laravel
Dropbox se démarque parmi une large gamme de solutions d'hébergement de fichiers avec sa simplicité, ses capacités de synchronisation automatique, sa prise en charge multiplateforme et d'autres fonctionnalités puissantes.
En tant que développeur PHP, vous pouvez tirer le meilleur parti de l'API Dropbox pour créer des applications pour implémenter diverses opérations de votre compte Dropbox. Ce tutoriel utilisera API Dropbox V2. Si vous voulez le faire, vous pouvez cloner le projet de GitHub.
Points de base
- Utilisez Dropbox API V2 pour créer un client Dropbox personnalisé en combinaison avec PHP et Laravel pour contrôler les opérations de fichiers utilisateur.
- Enregistrez d'abord une nouvelle application sur le site Web Dropbox Developer et obtenez les informations d'identification nécessaires telles que App Key et Secret, qui sont cruciales pour l'authentification de l'API.
- Configurez l'environnement Laravel pour intégrer Dropbox en définissant le routage et le middleware nécessaires pour gérer l'authentification des utilisateurs et les opérations de fichiers.
- Installez et utilisez des bibliothèques Guzzle, Purl et Carbon dans Laravel pour gérer respectivement les demandes HTTP, les opérations d'URL et les conversions de date / heure.
- Activer diverses fonctions telles que le téléchargement de fichiers, le téléchargement, la recherche et la gestion des versions via des points de terminaison API spécifiques et utilisez un accès basé sur des jetons.
- Protégez votre application en définissant les autorisations appropriées (accès au dossier ou accès complet à Dropbox) et en utilisant OAuth2 pour l'authentification et l'autorisation des utilisateurs.
- Explorez des fonctionnalités avancées telles que les webhooks pour les notifications de mise à jour de fichiers en temps réel, ainsi que des outils embarqués tels que Chooser et Saver pour une interaction utilisateur améliorée.
Créer une application Dropbox
Tout d'abord, visitez le site Web Dropbox Developer et créez une nouvelle application.
Dropbox propose deux API: l'API Dropbox orientée publique et l'API commerciale orientée par équipe. Les deux API sont presque identiques, la seule différence est que l'API d'entreprise est spécifiquement pour les comptes d'entreprise, donc il inclut les fonctionnalités de l'équipe par défaut, telles que l'accès aux informations de l'équipe, l'accès aux fichiers des membres de l'équipe et la gestion des membres de l'équipe. Nous utiliserons le premier.
Après avoir créé l'application, vous verrez la page des paramètres de l'application:
Ici, vous pouvez définir ce qui suit:
- Utilisateurs de développement - Cela vous permet d'ajouter des utilisateurs de Dropbox pour tester votre application. Par défaut, l'état de l'application est un "développement". Cela signifie que vous seul pouvez tester ses fonctionnalités. Si vous permettez à un autre utilisateur d'accéder à votre application, il ne pourra pas l'utiliser.
- Type d'autorisation - Il s'agit du paramètre que vous avez sélectionné lors de la création de l'application. Il n'y a que deux types d'autorisation: dossier et dropbox complet. Les dossiers signifient que votre application ne peut accéder qu'aux dossiers que vous spécifiez. Dropbox complet signifie que votre application peut accéder aux fichiers de tous les utilisateurs.
- Clé d'application et secret - c'est la seule clé que Dropbox utilise pour identifier votre application. Nous en aurons besoin plus tard.
- OAUTH2 Redirection URL - Ici, vous pouvez définir les URL, et votre application peut rediriger vers ces URL après que l'utilisateur autorise les autorisations nécessaires. Laissez maintenant vide d'abord, vous ajouterez la valeur plus tard. Maintenant, notez que seule l'URL que vous avez spécifiée ici peut être utilisée pour les redirections.
- Autoriser l'autorisation implicite - s'il faut générer automatiquement un jeton d'accès après que l'utilisateur ait accordé les autorisations nécessaires à votre application. Si vous utilisez Dropbox sur le client, vous devez le définir sur "Autoriser" afin que vous puissiez obtenir des jetons d'accès via JavaScript. Pour ce projet, vous devez le définir sur "Ne permets pas".
- Jeton d'accès généré - Vous pouvez utiliser ce jeton pour générer un jeton d'accès pour votre compte. Les jetons d'accès peuvent être utilisés pour faire des demandes à l'API.
- Nom de domaine de Chooser / Saver - Si vous utilisez des outils intégrés tels que le sélecteur et l'épargnant, vous devez spécifier le nom de domaine pour intégrer ces outils ici.
- webhooks - Si vous souhaitez que le serveur effectue des actions spécifiques lorsqu'un fichier dans le compte Dropbox de l'utilisateur change, vous pouvez utiliser WebHooks. Dans ce didacticiel, nous ne couvrirons pas WebHooks, donc si vous avez besoin de cette fonctionnalité dans votre application, il est recommandé de consulter la documentation WebHooks.
Créez l'application
Maintenant, vous pouvez commencer à construire l'application. Nous utiliserons Laravel.
Installation des dépendances
composer create-project --prefer-dist laravel/laravel pinch
Copier après la connexion
Une fois l'installation terminée, vous devez également installer la butte, le purl et le carbone.
composer require nesbot/carbon jwage/purl guzzlehttp/guzzle
Copier après la connexion
Nous utiliserons Guzzle pour émettre des demandes HTTP à l'API Dropbox, construire l'URL de connexion Dropbox avec Purl et utiliser le carbone pour représenter la date de fichier dans le fuseau horaire de l'utilisateur.
Configuration
Après avoir installé Laravel, ouvrez le fichier .env dans le répertoire racine du projet et ajoutez la configuration 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>
Copier après la connexion
Utilisez la touche de l'application et l'application Secret que vous avez précédemment obtenue à partir du site Web Dropbox Developer comme valeurs de Dropbox_App_Key et Dropbox_App_Secret. Pour Dropbox_Redirect_uri, vous devez spécifier une URL HTTP, donc si vous utilisez un hôte virtuel, vous devez utiliser un outil comme Ngrok pour fournir le service. Ensuite, dans votre configuration d'hôte virtuelle, ajoutez l'URL fournie par NGROK en tant que serveur.
<virtualhost *:80>
ServerName pinch.dev
ServerAlias xxxxxxx.ngrok.io
ServerAdmin wern@localhost
DocumentRoot /home/wern/www/pinch/public
</virtualhost>
Copier après la connexion
... (le reste des pièces est le même que le texte d'origine, et la longueur est trop longue, omise ici) ....
Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!