Vendor
Vendor adalah suatu paket aplikasi yang dikembangkan oleh pihak ketiga yang biasanya terdiri dari satu atau lebih class. Panada menyediakan direktori vendors untuk mempermudah Anda dalam memanfaatkan aplikasi atau library yang sudah ada.
Setiap vendor diorganisir ke dalam suatu folder dengan nama yang unik. Setiap nama mewakili sebuah vendor. Berikut contoh direktorinya:
Konfigurasi Vendor
Konfigurasi vendor dilakukan di dalam file app/config/main.php.
Penjelasan:
| Parameter | Keterangan |
|---|---|
| path |
Konfigurasi ini menentukan di mana lokasi folder vendor diletakan. Secara default, lokasi folder vendor ada di dalam folder panada. |
Menambahkan Vendor
Anda cukup menambahkan suatu foler baru yang namanya mewakili nama vendor. Kemudian letakan semua file-file yang dibutuhkan ke dalam folder tersebut.
panada/vendors/namaVendor
Penggunaan Vendor
Untuk memanfaatkan resource dari sebuah vendor, Anda membutuhkan method Import::vendor().
object Resources/Import::vendor( string $filePath, string | false $className = false, array $args = array() );
Penjelasan:
| Parameter | Keterangan |
|---|---|
| $filePath |
Nama file yang akan diload tanpa exstensi file (.php). |
| $className |
Secara default nama class mengikuti nama file. Namun jika diperlukan, argument ini bisa diisi dengan nama class yang dikehendaki. |
| $args |
Jika constructor class membutuhkan argument, silahkan isi pada bagian ini. Argument diisikan dalam format array. |
Berikut contoh cara me-load salah satu class dari sebuah vendor:
Jika ingin melakukan pemanggilan static method, isikan string di argument ke dua dengan format ClassName::staticMethod seperti contoh berikut:
$this->myStatic = Resources\Import::vendor('MyOwnLibs/MyClass', 'MyClass::myStaticMethod', array('arg1', 'arg2') );
Composer
Kini Panada secara natif telah mendukung penggunaan composer. Untuk menjalankan composer pastikan file composer.json telah tersedia.
Kita perlu menambahkan informasi folder panada/vendors ini di dalam composer.json seperti contoh berikut:
Sebagi contoh jika kita ingin menggunakan library mustache di dalam aplikasi kita, maka file composer.json-nya akan seperti:
Jalankan composer install untuk men-download library yang dibutuhkan.
Pada saat proses install, composer akan membuatkan file autoload.php di dalam folder vendor. Panada akan menggunakan file ini untuk me-load semua resource dari composer. Untuk itu pastikan file ini telah tersedia. Untuk menggunakan package yang ada di dalam vendor bisa dengan cara: