Konfigurasi Laravel dan PostgreSQL Beserta Contoh Migration

https://jagongoding.com/web/laravel/konfigurasi-laravel-dan-postgresql-beserta-contoh-migration/

Daftar Isi

Bismillah.

Pada kesempatan kali ini saya akan membahas tentang bagaimana mengatur konfigurasi Laravel dengan postgresql. Tidak hanya itu, di bagian akhir dari tulisan ini juga akan dicontohkan membuat tabel baru dengan migration dan membuat data dummy untuk memberikan gambaran lebih detil tentang laravel dan postgresql.

Apa yang dibutuhkan?

Pertama yang dibutuhkan adalah tentu saja anda menginstall PostgreSQL server. Jika anda menggunakan arch linux, anda bisa membaca tutorial jagongoding yang lain tentang Cara Menginstall PostgreSQL 11 di Arch Linux.

Selanjutnya, karena kita akan menginstall laravel. Maka kita juga membutuhkan semua yang dibutuhkan oleh Laravel.

1. Install Laravel

Langkah pertama install laravel. Buka terminal anda dan jalankan perintah di bawah. Lebih jelasnya bisa dilihat di Cara Install Laravel di Linux Semua Distro jika anda menggunakan linux.

laravel new belajar-postgres

cd belajar-postgres
php artisan serve

Buka localhost:8000 pada browser untuk memastikan apakah project baru laravel sudah berhasil terpasang.

2. Nyalakan PostgreSQL Server

Pastikan PostgreSQL sudah menyala. Ini tentu saja tergantung dari sistem operasi yang teman-teman gunakan, jika menggunakan linux, secara umum postgresql bisa dinyalakan dengan perintah systemctl berikut:

sudo systemctl start postgresql

3. Buat Database

Ada beberapa cara membuat database di postgresql. Di sini saya mencontohkan tiga cara, silakan perhatikan dengan baik lalu pilih salah satu cara yang menurut anda lebih memudahkan.

Cara 1: Menggunakan perintah createdb

Dengan menggunakan perintah createdb, anda otomatis akan membuat database milik dari user yang sedang login tanpa melakukan autentikasi. Perintahnya adalah sebagai berikut:

createdb belajar

Cara 2: Menggunakan DB Client GUI

Cara yang kedua adalah menggunakan DB Client GUI. Di sini saya contohkah menggunakan DB Client adminer, simpel tapi powerfull untuk berbagai macam DBMS. Anda bisa bebas menggunakan DB Client yang lainnya.

Cara 3: Membuat dengan QUERY

Cara membuat database yang ketiga adalah dengan menggunakan Query secara langsung dari psql client. Yang pertama anda lakukan adalah login ke postgresql dengan menggunakan perintah psql. Secara umum tanpa menambahkan parameter apa pun, anda akan otomatis login menggunakan user yang sedang aktif.`

psql

Lalu tulis query untuk membuat database baru.

CREATE DATABASE belajar;

4. Atur Koneksi

Setelah database berhasil kita buat. Langkah selanjutnya adalah mengatur koneksi agar aplikasi laravel kita terhubung ke database yang telah kita buat. Pertama-tama buka file .env, kalau belum ada maka copy dulu file yang sudah ada dari .env.example.

cp .env.example .env

Jangan lupa jika belum ada APP_KEY maka kita generate dulu dengan perintah berikut:

php artisan key:generate

Pada nilai dengan prefix DB_ kita atur seperti di bawah ini agar bisa terkoneksi dengan database postgresql yang baru saja kita buat.

...

DB_CONNECTION=pgsql
DB_HOST=localhost
DB_PORT=5432
DB_DATABASE=<nama-database>
DB_USERNAME=<username>
DB_PASSWORD=<password>

...

Ganti nilai yang diapit tanda < dan > dengan konfigurasi yang sesuai`.

Harusnya aplikasi kita sekarang telah berhasil terkoneksi dengan postgresql.

Setelah ini kita akan mencoba untuk membuat migration dan seeder, agar bisa terbukti apakah benar-benar sudah berhasil terkoneksi atau tidak.

5. Contoh Migration dan Seeder

Sebenarnya secara default laravel sudah hadir dengan dua buah migration, yaitu untuk tabel users dan tabel password_resets. Sehingga kalau kita jalankan perintah php artisan migrate kita otomatis akan mendapatkan dua tabel tersebut di database kita dan satu tabel tambahan yaitu migrations.

Pertama-tama kita akan coba lakukan php artisan migrate terlebih dahulu untuk mengecek apakah koneksi database kita sudah benar atau tidak. Setelah itu kita akan coba membuat tabel baru dengan migration yang baru.

php artisan migrate

Jika tidak ada error dan anda mendapatkan output seperti gambar di atas, maka itu artinya koneksi kita berhasil dan di database kita yaitu database belajar sekarang telah terdapat 3 tabel baru.

Pada bagian selanjutnya kita akan mencoba membuat tabel baru bernama tabel buku dengan memanfaatkan migration laravel.

Buat Migration Untuk Tabel Buku

Kita akan membuat tabel baru bernama tabel buku. Dengan attribut seperti berikut:

buku
	id - integer
	judul - varchar
	penulis - varchar
	stok - integer
	buku_terjemahan - boolean
	deskripsi - longtext
	created_at - timestamp
	updated_at - timestamp

Jalankan perintah php artisan make:migration <nama-migration> untuk membuat migration baru.

php artisan make:migration create_buku_table --create=buku

Setelah itu kita akan mendapati file baru di dalam direktori database/migrations sesuai dengan nama migration yang kita definisikan.

Ketika kita buka file database/migrations/XXXX_XX_XX_XXXXXX_create_buku_table.php, kita akan dapati kode sebagai berikut pada fungsi up:

<?php

Schema::create('buku', function (Blueprint $table) {
		$table->bigIncrements('id');
		$table->timestamps();
});

Ini otomatis tertambahkan jika kita saat membuat migration baru kita sertakan flag --create=<nama-table>. Ini memudahkan kita karena kita tidak perlu menulis banyak kode secara manual.

Baik, selanjutnya kita akan membuat kolom-kolom seperti yang sudah berlalu penjelasannya. Kita tambahkan kode berikut ini kedalam fungsi up().

<?php

public function up()
{
    Schema::create('buku', function (Blueprint $table) {
        $table->bigIncrements('id');
        $table->string('judul', 60);
        $table->string('penulis', 30);
        $table->integer('stok');
        $table->boolean('buku_terjemahan')->default(false);
        $table->longText('deskripsi')->nullable();
        $table->timestamps();
    });
}

Eksekusi perintah php artisan migrate untuk mengaplikasikan migration yang baru kita buat.

php artisan migrate

Jika tidak terjadi error, berarti tabel buku telah berhasil kita buat.

Buat Seeder Untuk Tabel Buku

Oke, di sini kita akan membuat seeder baru untuk tabel buku. Lalu kita isi data dummy sebanyak 100 baris. Bagi kalian yang ingin mempelajari lebih jauh, saya pernah menulis tutorial tersendiri tentang Cara Membuat Data Dummy di Laravel.

Ada pun pada kesempatan kali ini, kita ambil simpelnya saja.

Jalankan perintah php artisan make:seeder untuk membuat seeder baru.

php artisan make:seeder TabelBukuSeeder

Maka file baru di folder database/seeds/ akan dibuat.

Buka file database/seeds/TabelBukuSeeder.php. Lalu pada fungsi run() ubah kodenya menjadi seperti berikut:

<?php

/**
 * Run the database seeds.
 *
 * @return void
 */
public function run()
{
    $faker = \Faker\Factory::create();

    \DB::table('buku')->truncate();

    for ($i=0; $i < 100; $i++) { 
        DB::table('buku')->insert([
            'judul' => $faker->sentence(3),
            'penulis' => $faker->name,
            'stok' => $faker->numberBetween(1, 10),
            'buku_terjemahan' => $faker->randomElement([true, false]),
            'deskripsi' => $faker->text(100),
            'created_at' => now(),
            'updated_at' => now()
        ]);
    }
}

Buka file database/seeds/DatabaseSeeder lalu pada fungsi run(), panggil kelas TabelBukuSeeder.

<?php

/**
 * Seed the application's database.
 *
 * @return void
 */
public function run()
{
    $this->call(TabelBukuSeeder::class);
}

Setelah semuanya rampung, eksekusi perintah php artisan db:seed.

php artisan db:seed

Jika tidak ada error, maka sekarang tabel buku memiliki 100 data dummy.

Kesimpulan

Kesimpulannya, laravel dengan segala kemudahannya membuat kita benar-benar bisa fokus ke proses pembuatan program. Karena layer database telah dihandle sedemikian rupa sehingga kita tidak perlu berkotor-kotor untuk bersentuhan langsung dengan layer database.

Oleh karena itu jika teman-teman perhatikan di atas, tidak ada bedanya ketika kita menggunakan postgresql atau mysql sebagai DBMS kita, laravel menjembataninya dengan baik sekali. Sehingga jika teman-teman ingin mengubah DBMS ke mysql, tinggal mengganti .env nya saja.

Semoga bermanfaat :) Nantikan tutorial-tutorial selanjutnya!

Kumpulan Tutorial Kito

Rabu, 02 Februari 2022

LARAVEL-tutorial awal