Untuk membuat lebih mudah dimengerti, intinya adalah kita membuat beberapa aplikasi fusebox pada satu aplikasi php. Jadi dalam satu virtual directory terdapat beberapa aplikasi fusebox.

Setiap membuat aplikasi fusebox, saya selalu menentukan struktur direktori terlebih dahulu. Misal dalam aplikasi rumah sakit kita menentukan struktur direktori sebagai berikut:

hospital/
-------/index.php
-------/registrasi.php
-------/rm.php
-------/apotik.php
-------/kasir.php
-------/modules/
---------------/index/
---------------------/circuits/
---------------------/parsed/
---------------------/fusebox.xml.php
---------------/registrasi/
------------------------/circuits/
------------------------/parsed/
------------------------/fusebox.xml.php
---------------/rm/
------------------/circuits/
------------------/parsed/
------------------/fusebox.xml.php
---------------/apotik/
---------------------/circuits/
---------------------/parsed/
---------------------/fusebox.xml.php
---------------/kasir/
--------------------/circuits/
--------------------/parsed/
--------------------/fusebox.xml.php
-------/apps/
------------/fusebox.core/
-------------------------/*.* (berisi file-file core fusebox)
------------/common/
--------------------/circuits/
----------------------------/* (berisi circuit-circuit umum, atau circuit bersama yang dapat diakses setiap kanal)

Dari contoh struktur direktori diatas, anggaplah root dari aplikasi diakses melalui http://localhost/hospital. Kemudian bisa kita lihat beberapa kanal dari aplikasi rumah sakit tersebut, dan detail aplikasinya ada pada direktori modules/.

Perhatikan bahwa dalam satu aplikasi php diatas, terdapat beberapa file fusebox.xml, inilah yang disebut dengan multiple application. Apa keuntungannya? tentu saja aplikasi menjadi lebih mudah dikelola, selain itu hasil file parsed pun bisa lebih kecil karena dibagi-bagi per sub aplikasi.

Dengan demikian kita perlu melakukan pemetaan agar aplikasi yang diakses menunjuk ke modul yang bersesuaian. Anggap index adalah kanal untuk aplikasi master data (dokter, poli, ruangan, dan lain-lain), jadi file index.php bisa berisi:

$FUSEBOX_APPLICATION_NAME = "Hospital";
$FUSEBOX_APPLICATION_PATH = "modules/index/";
$FUSEBOX_APPLICATION_KEY = "index";
@include($FUSEBOX_APPLICATION_PATH."parsed/app_".$FUSEBOX_APPLICATION_NAME.".php");
include("apps/fusebox.core/fusebox5.php");

Sehingga path aplikasi mengarah ke modules/index/ sedangkan key ($FUSEBOX_APPLICATION_KEY) kita beri nama “index”. Karena key bebeda-beda, maka untuk mengakses $self/$myself harus dapat dinamis. Untuk membuat $self/$myself dinamis kita perlu membuat kode sebagai berikut:

$self = $_fba->appKey.".php";
$myself = $self."?".$_fba->fuseactionVariable."=";

$_fba adalah objek bawaan fusebox, appKey adalah properti key yang sedang aktif, dalam hal ini $_fba->appKey akan berisi “index”. Sehingga variabel $self berisi “index.php”, dan $myself berisi “index.php?fuseaction=”.

Untuk membuat kanal yang lain pun sama, kita hanya perlu mengubah application path dan application key saja, dan untuk mengaksesnya sesuaikan dengan nama filenya, misal http://localhost/hospital/registrasi.php untuk kanal registrasi.

Kode untuk variabel $self dan $myself sebaiknya berada pada circuit bersama, misal kita membuat circuit global dan setting $self dan $myself berada pada fuseaction settings, sehingga setiap fusebox.xml dalam suatu kanal dapat mengakses fuseaction global.settings pada <preprocess> nya.

Happy fuseboxing

<set name="nama" value="Yerie Piscesa"/>

atau jika value nya berupa variabel:

<set name="nama" value="{$attributes['name']}"/>

Dengan menggunakan tag set, variabel dengan nama “nama” dapat kita akses melalui fuse dengan aturan php, yaitu $nama (menggunakan tanda dollar).

Tag set mempunyai 3 buah atribut, yaitu name, value dan evalute. Atribut name dan value adalah pasangan nama variabel (name) dan isi/nilainya (value). Atribut evaluate memiliki nilai true/false, menandakan apakah isi atribut value perlu di evaluasi sebagai statement php. Perhatikan contoh dibawah ini:

<set name="a" value="{$attributes['a']}"/>
<set value="echo \$a;" evaluate="true"/>
<set value="\$arr = array(1,2,3);" evaluate="true"/>
<set value="var_dump(\$arr);" evaluate="true"/>

Perhatikan contoh diatas, atribut evaluate jika diisi true maka akan mengevaluasi/mengeksekusi nilai dalam atribut value sebagai kode php. Jika atribut name tidak didefinisikan maka fusebox akan menciptakan variabel acak sebagai penampung value. Contoh hasil parsing dari kode <set value=”var_dump(\$arr);” evaluate=”true”/> adalah:

$fb_['4a73cc6e3aac3'] = eval("var_dump(\$arr);");

class Karyawan {
  private $DB;
  public function __construct(){
    global $db;
    $this->DB = $db;
  }
  public function getByNIP($nip) {
    $db = $this->DB;
    $sql = "select * from karyawan where nip=?";
    return $db->GetRow($sql,array($nip));
  }
}

Bagaimana menerapkannya pada fusebox? Pada file fusebox.xml buatlah tag <classes> jika belum ada dibawah root <fusebox>. Kemudian tambahkan tag class di dalam tag classes tersebut:

<class alias="Karyawan" classpath="classes/Karyawan.php" />

Dengan menambahkan tag class, maka class Karyawan dapat digunakan pada semua circuit dalam aplikasi fusebox tersebut. Berikut adalah contoh penggunaannya dalam circuit.xml:

<instantiate class="Karyawan" object="karyawan"/>
<invoke object="karyawan" methodcall="getByNIP($attributes['nip'])" returnvariable="data" />
<include template="dsp_data" />

Tag instantiate jika diterjemahkan kedalam kode php menjadi:
$karyawan = new Karyawan;
Sedangkan tag invoke jika diterjemahkan kedalam php menjadi:
$data = $karyawan->getByNIP($attributes['nip']);
Karena tag invoke mengembalikan variabel $data, maka dapat kita gunakan dalam fuse dsp_data, sebagai berikut:

<?php
echo "Detail Karyawan<br/>";
echo "NIP: " .$data['nip']."<br/>";
echo "Nama : " . $data['nama']."<br/>";
echo "Alamat: " .$data['alamat']."<br/>";
?>

Dengan demikian kita juga menerapkan pola MVC(Model-View-Controller) walaupun secara implisit. Dapat kita lihat bahwa class adalah model dari aplikasi kita, kemudian file fuse (.php) adalah viewnya dan semuanya dikontrol melalui circuit.

Ok, buka kembali aplikasi fbxdb Anda. Masuk ke circuit jabatan, kemudian tambahkan file ‘act_validate.php’ pada direktori tersebut (app/modules/jabatan/). Buatlah validasi yang dibutuhkan pada halaman tersebut, misal kode dan nama tidak boleh kosong, serta kode tidak boleh ganda. Berikut contohnya:

<?php
$isValid = true;
if(trim($_POST['kode']) == "") {
  $isValid = false;
  $err['kode'] = "Kode tidak boleh kosong!";
}
if($_POST['kode'] != "") {
  if ($myFusebox->originalFuseaction == "insert") {
    $sql = sprintf("select kode from jabatan where kode=%s ",quote(trim($_POST['kode']),'string',true));
  } else {
    $sql = sprintf("select kode from jabatan where kode=%s and not id=%s",
    quote(trim($_POST['kode']),'string',true),
    quote($_POST['id'],'number'));
  }
  $qry = mysql_query($sql) or die(mysql_error());
  $rowFound = mysql_num_rows($qry);
  if ($rowFound != 0) {
    $isValid = false;
    $err['kode'] = "Kode sudah digunakan!";
  }
}
if(trim($_POST['nama']) == "") {
  $isValid = false;
  $err['nama'] = "Nama jabatan tidak boleh kosong!";
}
if (!$isValid) $errormessage = "Data tidak dapat disimpan, periksa kembali isian Anda !";
?>

Dalam script diatas, variabel $isValid adalah indikator dari validasi tersebut, apabila bernilai false variabel $err dan $errormessage akan memiliki nilai.

Kemudian langkah selanjutnya adalah melakukan perubahan di fuse dsp_form, berikut script dari dsp_form.php:

<?php
if(!$isPostBack) {
$err = null;
} else {
if (!$isValid) $row = $_POST;
}
?>
<h2><?php echo $formTitle; ?></h2>

<?php if ($isPostBack &amp;amp;amp;&amp;amp;amp; $message != "") { ?>
<div class="success"><?php echo $message; ?></div>
<?php } ?>

<?php if ($isPostBack &amp;amp;amp;&amp;amp;amp; $errormessage != "") { ?>
<div class="error"><?php echo $errormessage; ?></div>
<?php } ?>

<form action="<?php echo $myself.$XFA["submitPost"]; ?>" method="post">
<input type="hidden" name="id" value="<?php echo $id; ?>"/>
<table>
<tr>
<td><strong>Kode</strong></td>
<td>
<input type="text" name="kode" id="kode" value="<?php echo $row["kode"]; ?>" size="10" maxlength="10"/>
<?php echo $err['kode']; ?>
</td>
</tr>
<tr>
<td><strong>Jabatan</strong></td>
<td>
<input type="text" name="nama" id="nama" value="<?php echo $row["nama"]; ?>" size="50" maxlength="100"/>
<?php echo $err['nama']; ?>
</td>
</tr>
<tr>
<td>&amp;amp;amp;nbsp;</td>
<td>
<input type="submit"/>
<input type="reset"/>
<a href="<?php echo $myself.$XFA["list"]; ?>">List Jabatan</a>
</td>
</tr>
</table>
</form>

Langkah terakhir adalah me-registrasi fuse act_validate pada circuit.xml. Cari fuseaction insert dan update, beri tambahan sebagai berikut:

<fuseaction name="insert">
  <do action="global.setPostBack"/>
  <include template="act_validate"/>
  <if condition="$isValid">
    <true><include template="act_insert"/></true>
  </if>
  <do action="add"/>
</fuseaction>

<fuseaction name="update">
  <do action="global.setPostBack"/>
  <include template="act_validate"/>
  <if condition="$isValid">
    <true><include template="act_update"/></true>
  </if>
  <do action="edit"/>
</fuseaction>

Ok, dengan demikian validasi dapat digunakan dan kita dapat memisahkan validasi dari proses insert/update sehingga lebih mudah dikelola. Untuk aplikasi lengkap dapat di download disini

Sampai jumpa pada tulisan-tulisan selanjutnya.

Happy fuseboxing

Kita review dahulu file-file yang harus ada dari setiap circuit, berikut file-filenya:

Home

1. dsp_main.php

Global

1. act_setPostBack.php
2. myGlobals.php

Layout

1. lay_main.php
2. lay_blank.php

Db

1. config.php
2. db_function.php
3. act_connect.php

Jabatan

1. qry_list.php
2. dsp_list.php
3. qry_dataById.php
4. dsp_form.php
5. act_insert.php
6. act_update.php
7. act_delete.php

Karyawan

1. qry_list.php
2. dsp_list.php
3. qry_dataById.php
4. dsp_form.php
5. act_insert.php
6. act_update.php
7. act_delete.php

Disini saya tidak akan membuat keseluruhan dari fuse diatas, hanya bagian-bagian yang penting saja, untuk versi lengkapnya dapat di download pada bagian bawah post ini.

Hal menarik dari semua ini adalah, susunan file-file kita terlihat teratur dan pasti akan mudah merawat file-file tersebut. Hal menarik lain adalah walaupun file-file tersebut berada pada direktori sembarang, fusebox memperlakukan file-file tersebut seolah-olah berada pada root. Sehingga jika Anda ingin menambahkan menampilkan gambar, atribut src pada tag HTML nya dimulai dari root aplikasi. Contoh gambar berada pada direktori [root]/images/ dan kita akan menampilkan gambar pada direktori [root]/app/modules/karyawan/dsp_list.php :

<a href="#"><img src="images/edit.png" align="left"> Ubah Data</a>

Atau suatu saat kita perlu menambahkan library lain, dan kita meleakkan library tersebut pada [root]/libs/adodb/, dimanapun Anda ingin memanggil file dalam direktori tersebut, selama masih dalam scope fusebox (didefinisikan dalam fusebox.xml) maka pemanggilan dimulai dari root.

<?php
include_once "libs/adodb/adodb.inc.php";
// another code here ...
?>

Hal penting dalam membuat aplikasi database adalah menentukan setting dari database kita (nama database, host, username dan password). Dalam contoh ini konfigurasi tersebut kita definisikan dalam [root]/app/modules/db/config.php. Berikut contoh dari file config.php

<?php
$hostname = "localhost";
$dbname = "fbx_db";
$username = "root";
$password = "k0s0n6";
?>

Jangan lupa untuk membuat file koneksinya:

<?php
// Filename: act_connect.php
$DB = mysql_pconnect($hostname, $username, $password) or trigger_error(mysql_error(),E_USER_ERROR);
mysql_select_db($dbname,$DB) or die(mysql_error());
?>

Hal menarik lagi dalam pengembangan menggunakan fusebox adalah file kode menjadi sangat singkat, berikut adalah contoh dari file [root]/app/modules/jabatan/act_insert.php

<?php
$sql = sprintf("insert into jabatan(kode,nama) values(%s,%s)",
quote($_POST["kode"],"string",true),
quote($_POST["nama"],"string",true));
$query = mysql_query($sql) or die(mysql_error());
if ($query) $message = "Data telah disimpan";
?>

Oke sekian dulu untuk langkah-langkah kali ini, sampai jumpa pada tulisan selanjutnya. Untuk melihat seluruh kode dari aplikasi ini silahkan mendownloadnya disini.

Happy fuseboxing

Lokasi file fusebox.xml adalah pada direktori yang kita tentukan melalui variabel $FUSEBOX_APPLICATION_PATH, yaitu pada fbxdb/app/, buatlah file fusebox.xml.php kemudian tulis script ini:

<?xml version="1.0" encoding="UTF-8"?>
<fusebox>
<circuits>
</circuits>

<classes>
</classes>

<parameters>
<parameter name="defaultFuseaction" value="" />
<parameter name="mode" value="development-full-load" />
<parameter name="password" value="pwdfbxdb" />
<parameter name="fuseactionVariable" value="fuseaction" />
<parameter name="precedenceFormOrUrl" value="form" />
<parameter name="scriptFileDelimiter" value="php" />
<parameter name="maskedFileDelimiters" value="htm,cfm,cfml,php,php4,asp,aspx" />
<parameter name="characterEncoding" value="utf-8" />
<paramater name="strictMode" value="false" />
<parameter name="allowImplicitCircuits" value="false" />
<parameter name="debug" value="false"/>
</parameters>

<globalfuseactions>
<appinit>
</appinit>
<preprocess>
</preprocess>
<postprocess>
</postprocess>
</globalfuseactions>

<plugins>
<phase name="preProcess">
</phase>
<phase name="preFuseaction">
</phase>
<phase name="postFuseaction">
</phase>
<phase name="fuseactionException">
</phase>
<phase name="postProcess">
</phase>
<phase name="processError">
</phase>
</plugins>
</fusebox>

Sekarang pikirkan circuit yang mungkin untuk aplikasi kita. Circuit yang pasti harus ada adalah circuit jabatan dan karyawan, kemudian untuk koneksi database tentukan juga circuit db, tambahkan circuit-circuit lain yang kira-kira dibutuhkan, misal circuit global (untuk circuit yang selalu dipanggil pada setiap request atau circuit yang umum digunakan pada circuit yang lain), layout (untuk layouting aplikasi kita) dan home (sebagai circuit default).

Pertama-tama buatlah circuit defaultnya (home), tambahkan script berikut pada fusebox.xml dalam tag <circuits>

<circuit alias="home" path="modules/home/" parent="" />

Kemudian buatlah file circuit.xml pada path yang telah ditentukan diatas, tentukan fuseaction yang mungkin. Berikut adalah contohnya:

<?xml version="1.0" encoding="utf-8"?>
<circuit access="public">
<fuseaction name="main">
<set name="withLayout" value="true"/>
<include template="dsp_main" contentvariable="mainContent"/>
</fuseaction>
</circuit>

Sekarang kita dapat menentukan defaultFuseaction pada fusebox.xml.php:

<parameter name="defaultFuseaction" value="home.main" />

Lanjutkan dengan membuat circuit global, layout dan db. Tambahkan tag <circuit> dalam <circuits>  dalam file fusebox.xml.php

<circuit alias="global" path="modules/global/" parent=""/>
<circuit alias="layout" path="modules/layout/" parent=""/>
<circuit alias="db" path="modules/db/" parent="" />

Kemudian buat file-file circuit.xml.php pada direktori yang sudah ditentukan diatas, tentukan pula fuseaction yang mungkin. Berikut adalah contohnya:

Circuit global:

<?xml version="1.0" encoding="utf-8"?>
<circuit access="internal">
<fuseaction name="settings">
<set name="layout" value="false"/>
<include template="myGlobals"/>
</fuseaction>
<fuseaction name="setPostBack">
<include template="act_setPostBack"/>
</fuseaction>
</circuit>

Circuit layout:

<?xml version="1.0" encoding="utf-8"?>
<circuit access="public">
<fuseaction name="wrap">
<if condition="$withLayout=='true'">
<true>
<xfa name="home" value="home.main"/>
<xfa name="jabatan" value="jabatan.list"/>
<xfa name="karyawan" value="karyawan.list"/>
<include template="lay_main"/>
</true>
<false><include template="lay_blank"/></false>
</if>
</fuseaction>
</circuit>

Circuit db:

<?xml version="1.0" encoding="utf-8"?>
<circuit access="internal">
<fuseaction name="connect">
<include template="config"/>
<include template="db_function"/>
<include template="act_connect"/>
</fuseaction>
</circuit>

Sebuah circuit dapat mempunyai access  internal atau public. Internal berarti semua fuseaction didalamnya bersifat internal, yaitu hanya dapat diakses melalui fuseaction tidak melalui URL, sedangkan public berarti semua fuseaction didalamnya bersifat public, yaitu setiap fuseaction dalam circuit ini dapat diakses langsung melalui URL. Internal adalah default dari circuit jika tidak didefinisikan.

Setiap fuseaction dalam circuit pun dapat kita tentukan access nya, nilai yang mungkin adalah private, internal, atau public. Konsep internal dan public sama seperti circuit, fuseaction private hanya dapat di akses melalui circuit yang sama.

Setelah membuat circuit global,layout dan db, ada hal yang perlu kita lakukan disini. Saya berfikir kalau setiap request harus memiliki setting default serta koneksi ke sumber data/database (walaupun tidak selalu) dan di akhir request fuseaction saya ingin membungkusnya dengan layout. Maka saya perlu menambahkan setting berikut pada fusebox.xml dalam tag <globalfuseactions>

<preprocess>
<fuseaction action="global.settings"/>
<fuseaction action="db.connect"/>
</preprocess>
<postprocess>
<fuseaction action="layout.wrap"/>
</postprocess>

Jika Anda yakin bahwa koneksi ke sumber data selalu digunakan setiap kali request, jangan ragu-ragu untuk mendefinisikannya sebagai preprocess dalam globalfuseactions.

Saatnya kita buat circuit utama, yaitu jabatan dan karyawan. Buat dulu definisi circuitnya di fusebox.xml

        <circuit alias="jabatan" path="modules/jabatan/" parent="" />
<circuit alias="karyawan" path="modules/karyawan/" parent="" />

Kemudian buat circuit.xml.php pada direktori bersangkutan.

Circuit jabatan:

<?xml version="1.0" encoding="utf-8"?>
<circuit access="public">
<fuseaction name="list">
<set name="withLayout" value="true"/>

<xfa name="add" value="jabatan.add"/>
<xfa name="edit" value="jabatan.edit"/>
<xfa name="delete" value="jabatan.delete"/>

<include template="qry_list"/>
<include template="dsp_list" contentvariable="mainContent"/>
</fuseaction>

<fuseaction name="add">
<set name="withLayout" value="true"/>
<set name="formTitle" value="Tambah Data Jabatan"/>

<xfa name="submitPost" value="jabatan.insert"/>
<xfa name="list" value="jabatan.list"/>

<include template="dsp_form" contentvariable="mainContent"/>
</fuseaction>

<fuseaction name="edit">
<set name="withLayout" value="true"/>
<set name="formTitle" value="Ubah Data Jabatan"/>
<set name="id" value="{$attributes['id']}"/>

<xfa name="submitPost" value="jabatan.update"/>
<xfa name="list" value="jabatan.list"/>

<include template="qry_dataById"/>
<include template="dsp_form" contentvariable="mainContent"/>
</fuseaction>

<fuseaction name="insert">
<do action="global.setPostBack"/>
<include template="act_insert"/>
<do action="add"/>
</fuseaction>

<fuseaction name="update">
<do action="global.setPostBack"/>
<include template="act_update"/>
<do action="edit"/>
</fuseaction>

<fuseaction name="delete">
<include template="act_delete"/>
<relocate url="{$myself}jabatan.list"/>
</fuseaction>
</circuit>

Circuit karyawan:

<?xml version="1.0" encoding="utf-8"?>
<circuit access="public">
<fuseaction name="list">
<set name="withLayout" value="true"/>

<xfa name="add" value="karyawan.add"/>
<xfa name="edit" value="karyawan.edit"/>
<xfa name="delete" value="karyawan.delete"/>

<include template="qry_list"/>
<include template="dsp_list" contentvariable="mainContent"/>
</fuseaction>

<fuseaction name="add">
<set name="withLayout" value="true"/>
<set name="formTitle" value="Tambah Data Karyawan"/>

<xfa name="submitPost" value="karyawan.insert"/>
<xfa name="list" value="karyawan.list"/>

<include template="qry_list" circuit="jabatan"/>
<set value="\$jabatan_options = \$rows;" evaluate="true"/>
<include template="dsp_form" contentvariable="mainContent"/>
</fuseaction>

<fuseaction name="edit">
<set name="withLayout" value="true"/>
<set name="formTitle" value="Ubah Data Karyawan"/>
<set name="id" value="{$attributes['id']}"/>

<xfa name="submitPost" value="karyawan.update"/>
<xfa name="list" value="karyawan.list"/>

<include template="qry_list" circuit="jabatan"/>
<set value="\$jabatan_options = \$rows;" evaluate="true"/>
<include template="qry_dataById"/>

<include template="dsp_form" contentvariable="mainContent"/>
</fuseaction>

<fuseaction name="insert">
<do action="global.setPostBack"/>
<include template="act_insert"/>
<do action="add"/>
</fuseaction>

<fuseaction name="update">
<do action="global.setPostBack"/>
<include template="act_update"/>
<do action="edit"/>
</fuseaction>

<fuseaction name="delete">
<include template="act_delete"/>
<relocate url="{$myself}karyawan.list"/>
</fuseaction>
</circuit>

Oke…. kita telah selesai membuat struktur aplikasi. Hal yang penting dilakukan disini adalah membuat algoritma yang kemudian dituangkan melalui fusebox.xml dan circuit.xml, sehingga file-file tersebut dapat dijadikan panduan untuk melakukan perawatan aplikasi pada masa yang akan datang.

Bagian selanjutnya adalah melakukan fusecoding untuk menyempurnakan pembuatan aplikasi kita.

Happy fuseboxing

Dalam setiap membuat aplikasi fusebox, saya selalu menentukan outline dari direktori yang akan digunakan. Baiklah, saya tentukan saja direktori-direktori tersebut (catatan: outline direktori ini hanya contoh, Anda dapat membuat outline sendiri sesuai keinginan Anda) :

fbxdb/
——–/app/
—————/fusebox.core/
—————/modules/
—————/parsed/
—————/fusebox.xml.php
——–/images/
——–/styles/
——–/index.php

Root direktori adalah fbxdb yang diletakkan dibawah root webserver (sehingga dapat di akses melalui http://localhost/fbxdb), app adalah direktori dari aplikasi yang akan kita buat, didalamnya terdapat direktori fusebox.core/, masukkan semua core files fusebox dalam direktori tersebut. Direktori parsed/ digunakan fusebox untuk menghasilkan file-file php, direktori ini harus memiliki permission 777. Direktori modules/ adalah direktori utama aplikasi kita, circuit-circuit akan kita masukkan disini.

Pada root direktori terdapat file index.php, file tersebut masih kosong sehingga perlu kita buat scriptnya.

<?php
$FUSEBOX_APPLICATION_NAME = "fbxdb";
$FUSEBOX_APPLICATION_PATH = "app/";
$FUSEBOX_APPLICATION_KEY = "fusebox";
@include($FUSEBOX_APPLICATION_PATH."parsed/app_".$FUSEBOX_APPLICATION_NAME.".php");
include("app/fusebox.core/fusebox5.php");
?>

Pada file index terdapat beberapa variabel bawaan Fusebox yang perlu disetting, yaitu:

• $FUSEBOX_APPLICATION_NAME,
  Menentukan nama dari aplikasi yang kita bangun, jika tidak didefinisikan, variabel ini berisi “cacheddata”
• $FUSEBOX_APPLICATION_PATH
  Menentukan direktori dimana file fusebox.xml dan direktori parsed diletakkan.  Jika tidak didefinisikan, application path berda pada root.
• FUSEBOX_APPLICATION_KEY
  Menentukan key aplikasi aktif. Fusebox 5 mengizinkan untuk membuat aplikasi multiple yang setiap aplikasi dibedakan dengan key ini. Secara default variabel ini bernilai “fusebox”.

Ok, outline direktori telah kita lakukan, hal selanjutnya adalah menyiapkan databasenya. Karena ini hanya contoh, maka buatlah database yang simple, misal kita akan membuat database untuk menyimpan nama-nama karyawan beserta jabatannya, RDBMS yang digunakan adalah MySQL. Buat database, beri nama fbx_db, kemudian buat tabel-tabel berikut:

CREATE TABLE `jabatan` (
`id` int(11) NOT NULL auto_increment,
`kode` varchar(10) NOT NULL,
`nama` varchar(100) NOT NULL,
PRIMARY KEY  (`id`),
UNIQUE KEY `kode` (`kode`)
) ENGINE=MyISAM;

CREATE TABLE `karyawan` (
`id` bigint(20) NOT NULL auto_increment,
`kode` varchar(15) NOT NULL,
`nama` varchar(100) NOT NULL,
`id_jabatan` int(11) NOT NULL,
`alamat` varchar(255) default NULL,
`telepon` varchar(20) default NULL,
`hp` varchar(20) default NULL,
`email` varchar(255) default NULL,
`website` varchar(255) default NULL,
PRIMARY KEY  (`id`),
UNIQUE KEY `kode` (`kode`)
) ENGINE=MyISAM;

Oke… sekian dulu untuk bagian pertama, bagian selanjutnya adalah membuat fusebox.xml dan circuit.xml.

Happy fuseboxing

Kita pun dapat membangun sebuah aplikasi menggunakan metoda OOP dan pola MVC menggunakan fusebox, dalam fusebox.xml terdapat tag <classes> yang berfungsi untuk me-registrasi class-class pada aplikasi kita, yang nantinya dapat di akses melalui <instatiate> dan <invoke> pada circuit.xml. Dengan menggunakan konsep OOP secara tidak langsung aplikasi Anda akan mempunyai pola MVC (implicit MVC). Sekarang bayangkan dalam root direktori aplikasi Anda mempunyai direktori classes/ dan circuits/, kemudian masukkan semua class-class kedalam direktori classes/. Asumsi saya adalah class-class tersebut merupakan model dari aplikasi, kemudian di dalam direktori circuits/ adalah file circuit.xml dan file-file fuse, asumsikan circuit.xml adalah controller dan file-file fuse adalah view.

Idealnya sebuah class/model merupakan interface ke sumber data (database) atau sebuah pemrosesan yang tidak mengeluarkan output secara langsung, output-output haruslah berupa variabel yang nantinya dikeluarkan/dicetak oleh view (fuse file) dalam jendela browser (yang dibicarakan adalah aplikasi web/website) dan semua itu dikendalikan oleh controller(circuit.xml).

Jika Anda menggunakan FLiP sebagai metoda pengembangan, proses pemodelan (mengubah file-file fuse untuk query dan action ke dalam suatu class) akan menghilangkan penulisan fusedoc pada class karena class berbeda konsep dengan fuse. Namun demikian sebagai gantinya Anda dapat membuat class abstract yang dapat menjabarkan fungsi-fungsi dari class tersebut bagi fusecoder Anda (jika Anda bekerja dalam team, dan Anda adalah arsiteknya).

Dalam kesempatan lain akan saya berikan contoh penggunaan OOP ini, jadi tunggu aja yah

Anggap kita akan membuat aplikasi input data obat, berikut adalah salah satu contoh yang bisa kita terapkan :

<fuseaction name="add">
	<do action="login.checksession"/>
	<set name="withLayout" value="true"/>
	<set name="titleContent" value="TAMBAH DATA OBAT"/>

	<xfa name="submitPost" value="obat.insert"/>
	<xfa name="list_obat" value="obat.list"/>
	<do action="global.setPostBack"/>

	<include template="qry_listoptions" circuit="pemasok"/>
	<include template="qry_listoptions" circuit="pabrik"/>
	<include template="qry_listoptions" circuit="kategori"/>
	<include template="qry_listoptions" circuit="kelompok"/>
	<include template="dsp_add" contentvariable="mainContent"/>
</fuseaction>

<fuseaction name="insert">
	<do action="login.checksession"/>

	<include template="act_validate"/>
	<if condition="$isValid">
		<true>
			<include template="act_insert"/>
			<set name="withLayout" value="true"/>
			<set name="titleContent" value="DATA OBAT"/>

			<xfa name="obat_list" value="obat.list"/>
			<xfa name="obat_add" value="obat.add"/>
			<xfa name="obat_edit" value="obat.edit"/>

			<include template="dsp_insert" contentvariable="mainContent"/>
		</true>
		<false>
			<do action="add"/>
		</false>
	</if>
</fuseaction>

Script diatas adalah potongan dari file circuit.xml, circuit tersebut mempunyai alias “obat” yang didefinisikan pada file fusebox.xml.

Disitu kita lihat ada 2 buah fuseaction add dan insert, fuseaction add adalah untuk menampilkan form tambah data, sedangkan insert adalah action jika form di-submit.

Pada kedua fuseaction tersebut kita akan lebih mudah membaca alur program daripada harus membaca script php secara langsung, dan ini dapat dirasakan ketika kita perlu mengubah aplikasi pada masa yang akan datang sebagai pengganti flow chart diagram jika Anda tidak (sempat) membuatnya atau paling tidak sebagai dokumentasi aliran program bagi Anda sendiri.

include(”path/globalFunction.php”);

di dalam file fusebox.init.php

maka pada awal aplikasi di panggil akan menjalankan globalFunction.php terlebih dahulu.