Panada Framework 1.0.0 Documentation

Konfigurasi Vendor

Konfigurasi vendor dilakukan di dalam file app/config/main.php.

'vendor' => array( 'path' => GEAR.'vendors/' ),

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:

<?php namespace Controllers; use Resources; class Home extends Resources\Controller { public function __construct(){ parent::__construct(); // Load file phpMailer/PHPMailer.php dengan nama class PHPMailer $this->phpMailer = Resources\Import::vendor('phpMailer/PHPMailer'); // Load file MyOwnLibs/Validation.php dengan nama class Validate dan argument constructor $this->phpMailer = Resources\Import::vendor('MyOwnLibs/Validation', 'Validate', array('isEmail', true) ); } }

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:

{ "config": { "vendor-dir": "panada/vendors" } }

Sebagi contoh jika kita ingin menggunakan library mustache di dalam aplikasi kita, maka file composer.json-nya akan seperti:

{ "config": { "vendor-dir": "panada/vendors" }, "require": { "mustache/mustache": "*" } }

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:

<?php namespace Controllers; use Resources; class MyController extends Resources\Controller { public function __construct(){ parent::__construct(); Resources\Import::composer(); } public function index(){ $m = new \Mustache_Engine; echo $m->render('Hello {{planet}}', array('planet' => 'World!')); } }

Diskusi