~ We are changing the world with technology. ~

Matt Mullenweg

Tips Mengelola Timestamps di Laravel

Tips Mengelola Timestamps di Laravel

378 Dilihat

Secara default, Eloquent yang ada di Laravel berasumsi bahwa setiap table yang mereka tuju memiliki timestamps field, dalam hal ini adalah created_at dan updated_at. Namun apa jadinya jika aplikasi yang sedang kamu kembangkan adalah existing apps dengan bawaan database-nya masing-masing.

Laravel memberikan kebebasan penggunanya dalam menyesuaikan segala kondisi yang mereka hadapi, dalam hal ini adalah ketika berinteraksi waktu menggunakan Eloquent. Berikut adalah tips mengelola tanggal timestamps di Laravel.

Baca Juga: Aplikasi E-Commerce Laravel 6 #14: Kelola Pesanan (Admin) & Broadcast Resi

Disable Timestamps

Jika rancangan database kamu memiliki struktur tanpa timestamps untuk mencatat riwayat kapan data tersebut disimpan, maka ketika proses query menggunakan Eloquent, seperti Model::create($data) dilakukan, secara otomatis akan memberikan feedback berupa error karena satu kerangka atau bagian dari proses tersebut tidak dikenali, dalam hal ini adalah column created_at dan updated_at.

Adapun cara untuk menonaktifkan proses tersebut adalah dengan menambahkan property berikut ini di dalam model atau Eloquent terkait.

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    public $timestamps = false;
}

Mengganti Nama Field Timestamps

Kasus berikutnya adalah ketika nama column untuk mencatat riwayat data berbeda dengan nama column yang sudah dikenali oleh Laravel secara default. Misalnya saja kamu sedang mengerjakan aplikasi yang sudah berjalan dan struktur database sebelumnya menggunakan nama date_created dan date_updated, maka ada dua cara untuk memberi tahu Laravel column mana yang sebaiknya dituju. Pertama untuk best practice-nya adalah dengan menambahkan kedua baris code berikut di dalam Eloquent atau model terkait

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    const CREATED_AT = 'create_time';
    const UPDATED_AT = 'update_time'; 
}

Adapun cara kedua yang sedikit lebih bertele-tele adalah dengan men-disable timestamps kemudian mendeteksi event creating dan updating untuk memanipulasi column date_created dan date_updated, sehingga code-nya menjadi

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;
use Carbon\Carbon;

class Post extends Model
{
    public $timestamps = false;
    
    protected static function boot()
    {
        parent::boot();
        static::creating(function($post) {
            $post->date_created = Carbon::now();
            $post->date_updated = Carbon::now();
        });

        static::updating(function($post) {
            $post->date_updated = Carbon::now();
        });
    }
}

Menampilkan Timestamps Pivot Table Many-to-Many

Pivot table yang dihasilkan dari relasi antar table akan menampilkan key yang saling terhubung tanpa dilengkapi dengan timestamps atau kapan data relasi tersebut ditambahkan. Misanya kita memiliki 3 buah table dengan struktur sebagaimana gambar dibawah ini

manage timestamps laravel - db structure

Adapun relasinya dari Post.php menggunakan belongsToMany

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    protected $guarded = [];

    public function category()
    {
        return $this->belongsToMany(Category::class);
    }
}

Kemudian tambahkan data baru yang saling berelasi, saya asumsikan di-table posts dan categories sudah terdapat 1 buah record, maka kita akan menambahkan datanya dengan code

$post = \App\Post::first();
$post->category()->attach(1);

Maka sebuah record baru akan tercipta di dalam table category_post. Apabila data tersebut kita load menggunakan code.

$post = \App\Post::with(['category'])->first();
return $post;

Hasil yang akan ditampilkan adalah data utama beserta relasinya dalam hal ini adalah category dan diikuti dengan pivot masing-masing data.

manage timestamps laravel - eager loading laravel

Lalu pertanyaannya bagaimana cara menampilkan timestamps dari pivot table-nya? Caranya mudah, modifikasi relasinya dari file Post.php menjadi

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    protected $guarded = [];

    public function category()
    {
        return $this->belongsToMany(Category::class)->withTimestamps();
    }
}

Sehingga sturktur data yang dihasilkan akan terlihat seperti gambar di bawah ini.

eager loading with timestamps

Order By Menggunakan Timestamps

Ada beragam cara dalam mengurutkan data menggunakan Timestamps di Laravel, cara paling klasik adalah dengan membuat query .

$posts = Post::orderBy('created_at', 'DESC')->get();

Tahukah anda bahwa Laravel dalam hal ini Eloquent sudah menyediakan sebuah fungsi untuk mengambil data dengan mengurutkan data secara ringkas. Jika query diatas di-konversi maka singkatnya bisa menggunakan cara berikut.

$post = \App\Post::latest()->get();

Lalu bagaimana jika ingin menggunakan ascending? Tenang, Eloquent juga menyediakan fungsinya lainnya dengan cara

$post = \App\Post::oldest()->get();

Apabila kita ingin memilih column, dalam hal ini misalnya menggunakan updated_at, caranya bagaimana? Cukup mudah, karena cukup memasukkan nama colum-nya sebagai parameter. Misalnya

$post = \App\Post::with(['category'])->oldest('updated_at')->get();

Update Data Tanpa Mengubah Value Updated_at

Jika kita terjebak dalam sebuah kondisi dimana harus mengubah data tanpa memperbaharui value dari updated_at, maka Eloquent juga menawarkan solusinya tersendiri. Sebagaimana yang kita ketahui bahwa Eloquent akan secara otomatis memperbaharui updated_at apabila terjadi perubahan data dari sebuah records.

Singkatnya, cara ini hampir sama dengan materi pertama yakni dengan men-disable timestamps. Hanya saja proses disable timestamps kita lakukan saat proses update berlangsung. Adapun query-nya akan terlihat seperti berikut

$post = \App\Post::with(['category'])->oldest('updated_at')->first();
$post->name = 'Tips Mengelola Tanggal Timestamps di Laravel';
$post->timestamps = false;
$post->save();

Baca Juga: 7 Tips Cara Cepat Belajar Bahasa Pemrograman

Pendekatan Touch Updated_at

Programmer itu banyak masalahnya, misalnya ketika sebuah aplikasi sedang berjalan dan dibutuhkan pembaharuan hanya pada column updated_at tanpa mengubah value dari data lainnya. Maka cara pertama yang biasanya dilakukan adalah

$post = \App\Post::first();
$post->update(['updated_at' => now()]);

Alih-alih menggunakan cara di atas, Laravel menyediakan cara yang lebih sederhana dengan menggunakan fungsi touch(), sehingga codingan-nya menjadi

$post = \App\Post::first();
$post->touch();

Contoh kasus yang lainnya adalah memperbaharui updated_at beserta parent-nya, misalnya saja dari case yang kita gunakan adalah posts merupakan child dari users, apabila data posts diubah maka secara otomatis juga meng-update column updated_at dari users.

Pendekatan yang bisa kita lakukan adalah mendefinisikan relasi posts ke user, kemudian menambahkan property $touches.

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    protected $guarded = [];
    protected $touches = ['user'];

    public function user()
    {
        return $this->belongsTo(User::class);
    }
}

Apabila kita membuat query untuk meng-update data posts maka secara otomatis updated_at dari user yang terakait dengan post tersebut akan diperbaharui.

$post = \App\Post::with(['user'])->oldest('updated_at')->first();
$post->touch();

 

Full Stack Developer & Remote Worker salah satu perusahaan asal Australia. Senang dengan teknologi baru. Laravel addict yang tidak fanatik. Merekam jejak dengan menulis

Aplikasi E-Commerce Laravel 6 #18: Membuat Fitur Afiliasi Laravel

Aplikasi E-Commerce Laravel 6 #18: Membu...

Beragam cara atau teknik penjualan dilakukan guna mendongkrak transaksi pada sebuah bidang usaha, termasuk salah satu teknik marketing yang banyak digunakan adalah afiliasi. Berikut adalah cara membua...

Aplikasi E-Commerce Laravel 6 #17: Laporan Periode Date Range Laravel

Aplikasi E-Commerce Laravel 6 #17: Lapor...

Laporan memiliki peranan penting dalam mengevaluasi sebuah bisnis, termasuk dalam hal ini adalah transaksi jual beli. Fitur ini tidak lebih dari sekedar feed order, akan tetapi ada pembaca DaengWeb ya...

Aplikasi E-Commerce Laravel 6 #16: Integrasi Telegram Bot Laravel

Aplikasi E-Commerce Laravel 6 #16: Integ...

Membuat notifikasi dalam bentuk sosial chat akan lebih cepat tersampaikan kepada pemilik aplikasi karena di era ini orang-orang banyak menghabiskan waktunya dengan sosial media / chat. Berikut adalah...

Komentar