Bekerja dengan Form ¶

Bagian ini memaparkan bagaimana membuat halaman dengan form untuk mengambil data dari pengguna. Halaman akan menampilkan form dengan input field Nama dan Email. Setelah mendapatkan dua data dari pengguna, halaman akan menampilkan kembali data yang diinput pada form sebagai konfirmasi.

Untuk mencapai tujuan, disamping membuat sebuah action, dan dua view, anda juga harus membuat model.

Sepanjang tutorial ini, anda akan mempelajari bagaimana cara untuk:

• Membuat sebuah model sebagai representasi data yang diinput oleh pengguna melalui form,
• Membuat rules untuk memvalidasi data yang telah diinput.
• Membuat form HTML di dalam view.

Membuat Model ¶

Data yang akan diambil dari pengguna akan direpresentasikan oleh class model EntryForm sebagaimana ditunjukkan di bawah dan di simpan pada file models/EntryForm.php. Silahkan membaca bagian Class Autoloading untuk penjelasan lengkap mengenai penamaan file class.

<?php

namespace app\models;

use Yii;
use yii\base\Model;

class EntryForm extends Model
{
    public $name;
    public $email;

    public function rules()
    {
        return [
            [['name', 'email'], 'required'],
            ['email', 'email'],
        ];
    }
}

Class di extends dari yii\base\Model, class standar yang disediakan oleh Yii, yang secara umum digunakan untuk representasi data dari form.

Info: yii\base\Model digunakan sebagai parent untuk class model yang tidak berhubungan dengan database. yii\db\ActiveRecord normalnya digunakan sebagai parent untuk class model yang berhubungan dengan tabel di database.

Class EntryForm terdiri dari dua public property, name dan email, dimana akan digunakan untuk menyimpan data yang diinput oleh pengguna. Class ini juga terdapat method yang dinamakan rules(), yang akan mengembalikan (return) sejumlah pengaturan (rules) untuk memvalidasi data. Pengaturan validasi (Validation Rules) yang di deklarasikan harus mendeskripsikan bahwa

• kedua field, yaitu name and email wajib di input
• data email harus merupakan alamat email yang valid

Jika anda memiliki objek EntryForm yang sudah mengandung data yang di input oleh pengguna, anda boleh memanggil method validate() untuk melaksanakan validasi data. Kegagalan validasi data akan menentukan (set) property hasErrors menjadi true, dan anda dapat mengetahui pesan kegagalan validasi melalui errors.

<?php
$model = new EntryForm();
$model->name = 'Qiang';
$model->email = 'bad';
if ($model->validate()) {
    // Valid!
} else {
    // Tidak Valid!
    // Panggil $model->getErrors()
}

Membuat Action ¶

Selanjutnya, anda harus membuat entry action pada controller site yang akan memanfaatkan model yang baru saja dibuat. Proses membuat dan menggunakan action dijelaskan pada bagian Mengatakan Hello.

<?php

namespace app\controllers;

use Yii;
use yii\web\Controller;
use app\models\EntryForm;

class SiteController extends Controller
{
    // ...kode lain...

    public function actionEntry()
    {
        $model = new EntryForm();

        if ($model->load(Yii::$app->request->post()) && $model->validate()) {
            // data yang valid diperoleh pada $model

            // lakukan sesuatu terhadap $model di sini ...

            return $this->render('entry-confirm', ['model' => $model]);
        } else {
            // menampilkan form pada halaman, ada atau tidaknya kegagalan validasi tidak masalah
            return $this->render('entry', ['model' => $model]);
        }
    }
}

Pertama-tama, action membuat objek EntryForm. Kemudian objek tersebut membangun model menggunakan data dari $_POST, yang disediakan oleh Yii dengan method yii\web\Request::post(). Jika model berhasil dibuat (misal, jika pengguna telah mengirim form HTML), action akan memanggil method validate() untuk memastikan data yang di input tersebut valid.

Info : Expression Yii::$app adalah representasi dari objek aplikasi, dimana objek tersebut adalah singleton yang bebas diakses secara global. Objek tersebut juga merupakan service locator yang menyediakan components seperti request, response, db, dll. untuk mendukung pekerjaan yang spesifik. Pada kode di atas, component request dari objek aplikasi digunakan untuk mengakses data $_POST.

Jika tidak ada error, action akan me-render view bernama entry-confirm untuk menginformasikan ke pengguna bahwa pengiriman data tersebut berhasil. Jika tidak ada data yang dikirim atau data tersebut tidak valid, view entry yang akan di render, dimana form HTML akan ditampilkan, beserta informasi kegagalan pengiriman form tersebut.

Catatan: Pada contoh sederhana ini kita hanya me-render halaman konfirmasi jika data yang dikirim tersebut valid. Pada prakteknya, anda harus pertimbangkan untuk menggunakan refresh() atau redirect() untuk mencegah permasalahan pengiriman form.

Membuat View ¶

Terakhir, buatlah dua file view dengan nama entry-confirm dan entry. View ini akan di-render oleh action entry, yang sebelumnya dibahas.

View entry-confirm hanya menampilkan data nama dan email. File view tersebut harus di simpan di views/site/entry-confirm.php.

<?php
use yii\helpers\Html;
?>
<p>You have entered the following information:</p>

<ul>
    <li><label>Name</label>: <?= Html::encode($model->name) ?></li>
    <li><label>Email</label>: <?= Html::encode($model->email) ?></li>
</ul>

View entry akan menampilkan form HTML. File view tersebut harus di simpan di views/site/entry.php.

<?php
use yii\helpers\Html;
use yii\widgets\ActiveForm;
?>
<?php $form = ActiveForm::begin(); ?>

    <?= $form->field($model, 'name') ?>

    <?= $form->field($model, 'email') ?>

    <div class="form-group">
        <?= Html::submitButton('Submit', ['class' => 'btn btn-primary']) ?>
    </div>

<?php ActiveForm::end(); ?>

View ini menggunakan widget yaitu ActiveForm untuk membangun form HTML. Method begin() dan end() dari widget masing-masing berfungsi untuk me-render tag pembuka dan penutup dari form tag. Diantara dua method tersebut, akan dibuat field input oleh method field(). Input field yang pertama diperuntukkan untuk data "name", dan yang kedua diperuntukkan untuk data "email". Setelah field input, method yii\helpers\Html::submitButton() akan dipanggil untuk me-render tombol pengiriman data.

Mari kita uji ¶

Untuk melihat bagaimana prosesnya, gunakan browser anda untuk mengakses URL ini :

https://hostname/index.php?r=site%2Fentry

Anda akan melihat halaman yang menampilkan form dengan dua field input. Dibagian atas dari semua input field, ada label yang menginformasikan data yang mana yang akan diinput. Jika anda menekan tombol pengiriman data tanpa menginput apapun, atau anda tidak menginput email address yang tidak valid, anda akan melihat pesan kegagalan yang di tampilkan di bagian bawah field input yang bermasalah.

Setelah menginput nama dan alamat email yang benar dan menekan tombol kirim, anda akan melihat halaman baru yang menampilkan data yang barusan anda input.

Penjelasan ¶

Anda mungkin bertanya-tanya bagaimana form HTML bekerja dibelakang layar, sepertinya tampak ajaib karna form tersebut mampu menampilkan label di setiap field input dan menampilkan pesan kegagalan jika anda tidak menginput data dengan benar tanpa me-reload halaman.

Betul, validasi data sebenarnya dilakukan di sisi klien menggunakan Javascript, dan selanjutnya dilakukan lagi di sisi server menggunakan PHP. yii\widgets\ActiveForm cukup cerdas untuk menerjemahkan pengaturan validasi yang anda deklarasikan pada class EntryForm, kemudian merubahnya menjadi kode Javascript, dan menggunakan Javascript untuk melakukan validasi data. Jika saja anda menonaktifkan Javascript pada browser anda, validasi tetap akan dilakukan di sisi server, sepertinya yang ditunjukkan pada method actionEntry. Hal ini memastikan bahwa data akan divalidasi dalam segala kondisi.

Perhatian: Validasi melalui sisi klien akan membuat pengalaman pengguna lebih baik. Validasi di sisi server harus selalu dilakukan, walaupun validasi melalui sisi klien digunakan atau tidak.

Label untuk field input dibuat oleh method field(), menggunakan nama property dari model. Contoh, label Name akan dibuat untuk property name.

Anda boleh memodifikasi label di dalam view menggunakan kode seperti di bawah ini:

<?= $form->field($model, 'name')->label('Your Name') ?>
<?= $form->field($model, 'email')->label('Your Email') ?>

Info: Yii menyediakan banyak widget untuk membantu anda dalam membangun view yang kompleks dan dinamis. Sebentar lagi anda akan mengetahui, bahwa menulis widget juga sangat mudah. Anda mungkin akan mengganti sebagian besar dari kode view anda menjadi widget-widget yang mampu digunakan ulang untuk menyederhanakan penulisan view ke depannya.

Rangkuman ¶

Pada bagian kali ini, anda telah mengetahui semua bagian dari pola arsitektur MVC. Anda sudah mempelajari bagaimana untuk membuat class model sebagai representasi data pengguna dan memvalidasinya.

Anda juga mempelajari bagaimana mengambil data dari pengguna dan bagaimana menampilkan kembali data tersebut ke browser. Pekerjaan seperti ini biasanya memakan waktu lama pada saat mengembangkan aplikasi, tetapi Yii menyediakan widget yang bermanfaat yang akan membuat pekerjaan ini menjadi lebih mudah.

Di bagian selanjutnya, anda akan mempelajari bagaimana untuk bekerja dengan database, dimana hal tersebut hampir sangat dibutuhkan pada setiap aplikasi.