# Bekerja dengan Database ¶

Bagian ini akan memaparkan bagaimana membuat halaman yang menampilkan daftar data negara yang diambil dari tabel `country` pada database. Untuk menyelesaikan tugas ini, anda akan melakukan konfigurasi koneksi ke database, membuat class Active Record, membuat action, dan membuat view.

Sepanjang tutorial ini, anda akan mempelajari bagaimana cara untuk:

- konfigurasi koneksi ke database,
- membuat class ActiveRecord,
- mengambil (query) data menggunakan class ActiveRecord,
- menampilkan data ke view dengan halaman per halaman.

Sebagai catatan untuk menyelesaikan bagian ini, anda harus memiliki pengetahuan dan pengalaman dasar dalam menggunakan database. Secara khusus, anda harus mengetahui cara membuat database, dan cara menjalankan perintah SQL menggunakan aplikasi klien database.

## Menyiapkan Database ¶

Untuk memulai, buatlah database dengan nama `yii2basic`, yang akan digunakan untuk mengambil data dalam aplikasi anda. Anda bisa membuat database SQLite, MySQL, PostgreSQL, MSSQL, atau Oracle, dimana Yii mendukung banyak aplikasi database. Untuk memudahkan, database yang digunakan adalah MySQL.

Selanjutnya, buat tabel dengan nama `country` pada database, dan insert beberapa data sampel. Anda bisa menjalankan perintah SQL dibawah untuk memudahkan:

    CREATE TABLE `country` (
      `code` CHAR(2) NOT NULL PRIMARY KEY,
      `name` CHAR(52) NOT NULL,
      `population` INT(11) NOT NULL DEFAULT '0'
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8;

    INSERT INTO `country` VALUES ('AU','Australia',24016400);
    INSERT INTO `country` VALUES ('BR','Brazil',205722000);
    INSERT INTO `country` VALUES ('CA','Canada',35985751);
    INSERT INTO `country` VALUES ('CN','China',1375210000);
    INSERT INTO `country` VALUES ('DE','Germany',81459000);
    INSERT INTO `country` VALUES ('FR','France',64513242);
    INSERT INTO `country` VALUES ('GB','United Kingdom',65097000);
    INSERT INTO `country` VALUES ('IN','India',1285400000);
    INSERT INTO `country` VALUES ('RU','Russia',146519759);
    INSERT INTO `country` VALUES ('US','United States',322976000);

Hingga saat ini, anda memiliki database bernama `yii2basic`, dan didalamnya terdapat tabel `country` dengan tiga kolom, berisi 10 baris data.

## Konfigurasi Koneksi Database ¶

Sebelum melanjutkan, pastikan anda memasang ekstensi PHP PDO dan driver PDO untuk database yang anda gunakan (misal, `pdo_mysql` untuk MySQL). Ini adalah kebutuhan mendasar jika aplikasi anda menggunakan relational database.

Jika sudah terpasang, buka file `config/db.php` dan sesuaikan parameter yang sesuai untuk database anda. Secara default, isi file konfigurasi tersebut adalah:

    <?php

    return [
        'class' => 'yii\db\Connection',
        'dsn' => 'mysql:host=localhost;dbname=yii2basic',
        'username' => 'root',
        'password' => '',
        'charset' => 'utf8',
    ];

File `config/db.php` adalah tipikal konfigurasi yang menggunakan file. File konfigurasi seperti ini menentukan parameter-parameter yang dibutuhkan untuk membuat dan menginisialisasi objek yii\db\Connection, dimana anda dapat menjalankan perintah SQL dengan database yang dituju.

Konfigurasi koneksi database di atas dapat diakses pada kode aplikasi melalui expression `Yii::$app->db`.

> Info: File `config/db.php` akan di include oleh konfigurasi aplikasi utama `config/web.php`, yang berfungsi sebagai konfigurasi untuk inisialisasi objek aplikasi. Untuk penjelasan lebih lengkap, silahkan lihat bagian Konfigurasi.

Jika anda membutuhkan dukungan database yang tidak didukung oleh Yii, silahkan cek extensions di bawah ini:

- Informix
- IBM DB2
- Firebird

## Membuat Active Record ¶

Untuk mengambil data di tabel `country`, buat class turunan Active Record dengan nama `Country`, dan simpan pada file `models/Country.php`.

    <?php

    namespace app\models;

    use yii\db\ActiveRecord;

    class Country extends ActiveRecord
    {
    }

Class `Country` di extends dari yii\db\ActiveRecord. Anda tidak perlu untuk menulis kode di dalamnya! Hanya dengan kode di atas, Yii akan mengetahui nama tabel yang dimaksud dari nama class tersebut.

> Info: Jika nama class tidak sesuai dengan nama tabel, anda dapat meng-override method yii\db\ActiveRecord::tableName() untuk menentukan nama tabel secara eksplisit.

Menggunakan class `Country`, anda bisa memanipulasi data pada tabel `country` dengan mudah, sebagaimana yang ditunjukkan pada kode di bawah ini:

    use app\models\Country;

    // mengambil semua negara dari tabel country, dan mengurutkan berdasarkan "name" (nama)
    $countries = Country::find()->orderBy('name')->all();

    // mengambil negara yang memiliki primary key "US"
    $country = Country::findOne('US');

    // menampilkan "United States"
    echo $country->name;

    // Mengganti nama negara menjadi "U.S.A." dan menyimpan ke database
    $country->name = 'U.S.A.';
    $country->save();

> Info: Active Record adalah cara yang efektif untuk mengakses dan memanipulasi data dari database secara object-oriented. Anda bisa mengetahui lebih banyak lagi pada bagian Active Record. Sebagai alternatif, anda mungkin berinteraksi dengan database menggunakan metode data akses yang lebih mendasar yang disebut Data Access Objects.

## Membuat Action ¶

Untuk menampilkan data negara ke pengguna, anda harus membuat action. Dibanding menempatkan action baru ini pada controller `site` seperti yang sudah anda lakukan pada bagian sebelumnya, sekarang ini ada baiknya membuat spesifik controller untuk semua action yang berhubungan dengan data negara. Namakan controller baru ini dengan `CountryController`, dan buat action `index` pada controller tersebut, seperti yang ditunjukkan di bawah ini.

    <?php

    namespace app\controllers;

    use yii\web\Controller;
    use yii\data\Pagination;
    use app\models\Country;

    class CountryController extends Controller
    {
        public function actionIndex()
        {
            $query = Country::find();

            $pagination = new Pagination([
                'defaultPageSize' => 5,
                'totalCount' => $query->count(),
            ]);

            $countries = $query->orderBy('name')
                ->offset($pagination->offset)
                ->limit($pagination->limit)
                ->all();

            return $this->render('index', [
                'countries' => $countries,
                'pagination' => $pagination,
            ]);
        }
    }

Simpan kode di atas pada file `controllers/CountryController.php`.

Action `index` memanggil `Country::find()`. Method Active Record ini membuat query ke database dan mengambil semua data negara dari tabel `country`. Untuk membatasi jumlah negara yang didapatkan pada setiap pengambilan data, query tersebut dipecah menjadi halaman per halaman dengan bantuan dari objek yii\data\Pagination. Objek `Pagination` diperuntukkan untuk dua tujuan:

- Menentukan klausa `offset` dan `limit` pada perintah SQL yang digunakan untuk query agar mengambil hanya satu halaman data dalam sekali perintah (pada umumnya akan mengambil 5 baris dalam satu halaman).
- Digunakan pada view untuk menampilkan tombol halaman yang terdiri dari tombol-tombol nomor halaman, yang selanjutnya akan dijelaskan pada sub bagian berikutnya.

Di akhir kode, action `index` me-render view dengan nama `index`, dan mengirimkan data negara beserta dengan informasi halaman dari data tersebut.

## Membuat View ¶

Di dalam folder `views`, pertama-tama buatlah sub-folder dengan nama `country`. Folder ini akan digunakan untuk menyimpan semua view yang akan di render oleh controller `country`. Di dalam folder `views/country`, buatlah file dengan nama `index.php` berisi kode di bawah ini:

    <?php
    use yii\helpers\Html;
    use yii\widgets\LinkPager;
    ?>
    <h1>Countries</h1>
    <ul>
    <?php foreach ($countries as $country): ?>
        <li>
            <?= Html::encode("{$country->name} ({$country->code})") ?>:
            <?= $country->population ?>
        </li>
    <?php endforeach; ?>
    </ul>

    <?= LinkPager::widget(['pagination' => $pagination]) ?>

Terkait dengan tampilan data negara, view ini terdiri dari dua bagian. Bagian pertama, dilakukan perulangan (looping) pada data negara yang tersedia dan di-render sebagai unordered list HTML. Bagian kedua, widget yii\widgets\LinkPager di-render menggunakan informasi halaman (pagination) yang dikirimkan dari action. Widget `LinkPager` menampilkan tombol-tombol halaman. Mengklik pada salah satu tombol tersebut akan melakukan pengambilan data negara terkait dengan halaman yang diklik.

## Mari Kita Coba ¶

Untuk melihat bagaimana kode-kode di atas bekerja, gunakan browser anda untuk mengakses URL ini:

    https://hostname/index.php?r=country%2Findex

Awalnya, anda akan melihat sebuah halaman yang menampilkan 5 negara. Dibawah daftar negara tersebut, anda akan melihat tombol halaman yang berjumlah empat tombol. Jika anda mengklik tombol "2", anda akan melihat halaman tersebut menampilkan 5 negara lain pada database: halaman kedua pada record. Silahkan melakukan observasi secara perlahan-lahan dan anda akan mengetahui bahwa URL pada browser juga akan berganti menjadi

    https://hostname/index.php?r=country%2Findex&page=2

Di belakang layar, Pagination menyediakan semua kebutuhkan untuk memecah data menjadi halaman per halaman:

- Pertama-tama, Pagination menampilkan halaman pertama, dimana menjalankan perintah SELECT pada tabel `country` dengan klausa `LIMIT 5 OFFSET 0`. Hasilnya, 5 negara pertama akan diambil dan ditampilkan.
- Widget LinkPager me-render tombol halaman menggunakan URL yang dibentuk oleh method Pagination. URL tersebut mengandung query string `page`, yang merupakan representasi dari nomor halaman.
- Jika anda mengklik tombol halaman "2", sebuah request yang mengarah ke route `country/index` akan dijalankan hingga selesai. Pagination membaca query string `page` dari URL dan kemudian menentukan halaman sekarang adalah halaman 2. Query data negara yang baru mengandung klausa `LIMIT 5 OFFSET 5` dan mengambil 5 data negara selanjutnya untuk kemudian ditampilkan.

## Rangkuman ¶

Pada bagian ini, anda mempelajari bagaimana bekerja dengan database. Anda juga mempelajari bagaimana cara mengambil dan membagi data dengan halaman per halaman dengan bantuan yii\data\Pagination dan yii\widgets\LinkPager.

Di bagian selanjutnya, anda akan mempelajari bagaimana menggunakan generator kode yang disebut Gii, untuk membantu anda mengimplementasikan fitur-fitur umum pada aplikasi secara instan, seperti operasi Create-Read-Update-Delete (CRUD) untuk bekerja dengan data yang terdapat pada tabel di sebuah database. Sebenarnya, kode-kode yang barusan anda tulis, semuanya bisa di generate secara otomatis oleh Yii menggunakan tool Gii.