Dropbox: Bina pelanggan Dropbox tersuai dengan PHP dan Laravel
Dropbox menonjol di antara pelbagai penyelesaian hosting fail dengan kesederhanaannya, keupayaan penyegerakan automatik, sokongan silang platform, dan ciri-ciri berkuasa lain.
Sebagai pemaju PHP, anda boleh memanfaatkan API Dropbox untuk membuat aplikasi untuk melaksanakan pelbagai operasi akaun Dropbox anda. Tutorial ini akan menggunakan Dropbox API v2. Jika anda mahu melakukannya, anda boleh mengklonkan projek dari GitHub.
mata teras
Gunakan Dropbox API V2 untuk membina klien Dropbox tersuai dalam kombinasi dengan PHP dan Laravel untuk mengawal operasi fail pengguna.
- Mendaftar pertama aplikasi baru di laman web pemaju Dropbox dan dapatkan kelayakan yang diperlukan seperti Kunci APP dan Rahsia, yang penting untuk pengesahan API.
- Konfigurasikan persekitaran Laravel untuk mengintegrasikan Dropbox dengan menetapkan penghalaan dan middleware yang diperlukan untuk mengendalikan pengesahan pengguna dan operasi fail.
- Pasang dan gunakan Guzzle, PURL dan Perpustakaan Karbon di Laravel untuk mengendalikan permintaan HTTP, operasi URL, dan penukaran tarikh/masa masing -masing.
- Dayakan pelbagai fungsi seperti muat naik fail, muat turun, carian dan pengurusan versi melalui titik akhir API tertentu, dan gunakan akses berasaskan token.
- melindungi aplikasi anda dengan menetapkan keizinan yang sesuai (akses folder atau akses dropbox penuh) dan menggunakan OAuth2 untuk pengesahan dan kebenaran pengguna.
- Terokai ciri-ciri canggih seperti webhooks untuk pemberitahuan kemas kini fail masa nyata, serta alat tertanam seperti pemilih dan penyelamat untuk interaksi pengguna yang dipertingkatkan.
-
Buat App Dropbox
Pertama, lawati laman web pemaju Dropbox dan buat aplikasi baru.
Dropbox menawarkan dua API: API Dropbox yang menghadap awam dan API perniagaan yang menghadap pasukan. Kedua -dua API hampir sama, satu -satunya perbezaan adalah bahawa API perniagaan khusus untuk akaun perusahaan, jadi ia termasuk ciri -ciri pasukan secara lalai seperti akses kepada maklumat pasukan, akses fail ahli pasukan, dan pengurusan ahli pasukan. Kami akan menggunakan bekas.
Setelah membuat aplikasi, anda akan melihat halaman Tetapan Aplikasi:
di sini, anda boleh menetapkan perkara berikut:
- Pengguna Pembangunan - Ini membolehkan anda menambah pengguna Dropbox untuk menguji aplikasi anda. Secara lalai, status aplikasi adalah "pembangunan". Ini bermakna hanya anda boleh menguji fungsinya. Jika anda membenarkan mana -mana pengguna lain untuk mengakses aplikasi anda, mereka tidak akan dapat menggunakannya.
- Jenis Kebenaran - Ini adalah tetapan yang anda pilih semasa membuat aplikasi. Terdapat hanya dua jenis kebenaran: folder dan dropbox penuh. Folder bermaksud bahawa aplikasi anda hanya boleh mengakses folder yang anda tentukan. Dropbox penuh bermakna aplikasi anda boleh mengakses semua fail pengguna.
- Kunci aplikasi dan rahsia - Ini adalah satu -satunya kunci yang digunakan oleh Dropbox untuk mengenal pasti aplikasi anda. Kami akan memerlukannya kemudian.
- OAuth2 Redirect URL - Di sini anda boleh menetapkan URL, dan aplikasi anda boleh mengalihkan ke URL ini selepas pengguna membenarkan kebenaran yang diperlukan. Sekarang tinggalkan kosong terlebih dahulu, anda akan menambah nilai kemudian. Sekarang ambil perhatian bahawa hanya URL yang anda tentukan di sini boleh digunakan untuk pengalihan.
- Benarkan kebenaran tersirat - sama ada secara automatik menjana token akses selepas pengguna memberikan kebenaran yang diperlukan untuk permohonan anda. Jika anda menggunakan Dropbox pada pelanggan, anda harus menetapkannya untuk "membenarkan" supaya anda boleh mendapatkan token akses melalui JavaScript. Untuk projek ini, anda harus menetapkannya untuk "tidak membenarkan".
- Token akses yang dihasilkan - Anda boleh menggunakan token ini untuk menghasilkan token akses untuk akaun anda. Token akses boleh digunakan untuk membuat permintaan ke API.
- Nama Domain Chooser/Saver - Jika anda menggunakan alat tertanam seperti pemilih dan penyelamat, anda perlu menentukan nama domain untuk membenamkan alat ini di sini.
- WebHooks - Jika anda mahu pelayan melakukan tindakan tertentu apabila fail dalam perubahan akaun Dropbox pengguna, anda boleh menggunakan webhooks. Dalam tutorial ini, kami tidak akan merangkumi webhooks, jadi jika anda memerlukan ciri ini dalam aplikasi anda, disarankan agar anda menyemak dokumentasi Webhooks.
Bina aplikasi
Sekarang anda boleh mula membina permohonan. Kami akan menggunakan Laravel.
Memasang Dependencies
composer create-project --prefer-dist laravel/laravel pinch
Salin selepas log masuk
Selepas pemasangan selesai, anda juga perlu memasang Guzzle, PURL, dan Karbon.
composer require nesbot/carbon jwage/purl guzzlehttp/guzzle
Salin selepas log masuk
Kami akan menggunakan Guzzle untuk mengeluarkan permintaan HTTP ke API Dropbox, membina URL Login Dropbox dengan PURL, dan menggunakan karbon untuk mewakili tarikh fail dalam zon waktu pengguna.
Konfigurasi
Selepas memasang Laravel, buka fail .env dalam direktori root projek dan tambahkan konfigurasi 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>
Salin selepas log masuk
Gunakan Kunci App dan Rahsia App yang anda perolehi dari laman web pemaju Dropbox sebagai nilai dropbox_app_key dan dropbox_app_secret. Untuk dropbox_redirect_uri, anda perlu menentukan URL HTTP, jadi jika anda menggunakan tuan rumah maya, anda perlu menggunakan alat seperti NGROK untuk menyediakan perkhidmatan tersebut. Kemudian, dalam konfigurasi hos maya anda, tambahkan URL yang disediakan oleh NGROK sebagai Serveralias.
<virtualhost *:80>
ServerName pinch.dev
ServerAlias xxxxxxx.ngrok.io
ServerAdmin wern@localhost
DocumentRoot /home/wern/www/pinch/public
</virtualhost>
Salin selepas log masuk
... (seluruh bahagiannya sama dengan teks asal, dan panjangnya terlalu panjang, ditinggalkan di sini) ....
Atas ialah kandungan terperinci Bina pelanggan Dropbox anda sendiri dengan API Dropbox. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!