Setelah membahas cara menampilkan data, maka sekarang saatnya kita akan membahas cara menginput data baru (insert) atau mengedit data (update). Pada prinsip nya penggunaan Doctrine untuk melakukan insert dan update data adalah sama.

Doctrine menyediakan cara yang sangat mudah untuk melakukan insert dan update data. Namun sebelumnya Anda harus sudah menyiapkan form inputan data, yang nantinya akan meminta data dari user kemudian data itu dikirim dan diolah untuk masuk ke database.

Penasaran caranya?

Logika dasar penggunaan Doctrine untuk masalah ini sangat sederhana. Sebelumnya Anda harus punya Form inputan, sesuai field yang akan diisikan ke table. Kemudia hasil inputan form tersebut akan ditangkap dan diolah menggunakan Doctrine untuk dimasukkan ke Table. Jika data yang akan dimasukkan sudah ada, maka ini adalah proses update. Jika data yang akan dimasukkan belum ada, maka ini adalah proses insert. Sedangkan untuk proses penyimpanan, baik untuk kebutuhan insert maupun update, pada Doctrine dikenal dengan istilah save.

Untuk menu hidangan kali ini kita akan membahas mulai dari pembuatan form inputan sampai penyimpanan data inputan, yang semuanya menggunakan Doctrine. Asumsi nya Anda telah memiliki Model dan schema.yml, serta telah memiliki 1 tabel yang akan dimanipulasi. Pada Contoh ini kita menggunakan Table user dengan nama Model User.

1. Pembuatan Class Form dengan Doctrine

Cara membuat Class Form (library) sudah pernah kita bahas pada artikel sebelumnya. Penggunaan Class Form akan mempermudah kita dalam penggunaan form itu nantinya secara berulang-ulang.

Tapi sebenarnya ada cara yang lebih mudah lagi dalam pembuatan form, dengan bantuan Doctrine. Syaratnya, kita sudah menyediakan schema.yml dan model dari table yang kita miliki. Doctrine akan secara otomatis membuatkan class form yang berisi widget, validator, dan syarat lainnya, sesuai dengan konfigurasi table-database yang telah dibuat.

Cara nya sangat mudah, gunakan command symfony berikut ini,

> symfony doctrine:build-forms

Untuk melihat hasilnya, silahkan dilihat pada direktory lib/form/doctrine. Anda juga dapat melakukan modifikasi pada form tersebut, misalnya pada settingan widget, validator dan label.

2. Penggunaan Form dan Handling Submission

Begitu mudahnya ternyata kita bisa membuat form secara otomatis berdasarkan tabel. Maka sekarang kita akan mencoba menggunakan class form yang telah dibuat tadi, kita akan tampilkan pada modul yang diinginkan. Seperti biasa pembuatannya akan menggunakan action.class untuk deklarasi class form dan template untuk menampilkan form nya. Langkah pertama adalah membuat modul sesuai kebutuhan. Kemudian,

Pendeklarasian pada action.class (contoh) dengan nama executeNewuser

public function executeNewuser(sfWebRequest $request) 
{   
   $this->formuser = new UserForm();	 
}

Penggunaan pada template, misal

<form action="<?php echo url_for('user/tambah');?>" method="POST">
<table>
<?php echo $formuser; ?>
<tr>
 <td colspan="2" >
   <input type="submit" value="simpan">
 </td>
</tr>
</table>
</form>

Mudah kan? ternyata untuk membuat tampilan Form sederhana kita hanya perlu melakukan beberapa line coding saja, dengan bantuan Doctrine.

Langkah berikut nya adalah melakukan handling submission. Caranya 100% sama dengan pembahasan tentang handling submission pada materi Form sebelumnya. Jadi Anda bisa langsung copy-paste scriptnya. Ini contoh simple nya,

$this->formuser = new UserForm();
//script mengecek validasi form 
if ($request->isMethod('post')) {
   $this->formuser->bind($request->getParameter('user'));
   if ($this->formuser->isValid()){
      // Simpan Inputan ke TABLE user
   }else{
      // jika tidak valid, tampilkan form inputan lagi
      $this->setTemplate('newuser');
   }
}

Dari contoh diatas, secara otomatis form yang kita buat dari Doctrine juga akan memiliki handling submission dan validasi.

3. Proses Penyimpanan Data

Untuk penerapan Insert dan Update pada Doctrine, bisa menggunakan method save(). Perbedaannya adalah, untuk update kita perlu melakukan pencarian data terlebih dahulu, sedangkan untuk insert tidak. Intinya adalah, method save() hanya dimiliki oleh object Model Doctrine. Object ini bisa kita dapatkan dari class Model (tabel) baru, atau dari hasil pencarian record table.

Asumsi table yang akan di insert bernama user, maka kita cukup mendeklarasikan object dari Class Model User. Berikut ini contoh untuk membuat Object dari class Model (digunakan untuk Insert),

$datauser = new User();

Sedangkan jika ingin digunakan untuk melakukan update, maka kita tidak perlu menggunakan cara diatas. Cukup dengan melakukan pencarian data record yang akan di update dengan menggunakan Class Model.

$datauser = Doctrine::getTable('User')->find($id);

Ingat, penggunaan find() hanya untuk pencarian record berdasarkan Primary Key.

Nah! untuk proses selanjutnya, yaitu pengisian data ke Table, cara nya akan sama, yaitu menggunakan save(). Kita cukup melakukan set untuk setiap field yang ada pada table. Jika ada field “name” maka cara pengisiannya adalah setName($var). Berikut contohnya,

$datauser->setName('Udin');
$datauser->setDate('2010-12-11');
$datauser->setAddress('jl. Bukan Batu no.12345'); 
$datauser->setGender('Men'); 

$datauser->save(); // simpan data user ke table User

Mudah bukan.. oks, selamat ber-experiment lebih lanjut.

Hidup memang udah susah
Tapi jangan dibikin susah
Hidup memang bikin pusing
Jangan tambah dibawa pening
(slank)