Mekanisme Laravel

Dalam artikel ini saya akan memberikan beberapa rule yang direkomendasikan dalam menggunakan Laravel.

N+1 Issue

Anggap dulu Anda membuat aplikasi toko online yang pastinya akan menggunakan tabel yang namanya produk yang biasanya berelasi ke kategori. Apa yang kita lakukan adalah menampilkan produk beserta dengan kategori yang kurang lebih struktur untuk tabel produk akan seperti ini:

1products
2    id - bigint
3    category_id - bigint
4    title - string
5 
6categories
7    id - bigint
8    name - string
9    slug - string
10
bashCopy

Perhatikan tanda yang saya beri untuk kolom category_id, yang itu artinya setiap produk yang kita buat pastinya mempunyai id dari tabel kategori. Saya akan mencoba untuk menampilkan produknya yang itu kurang lebih seperti ini:

1$products = Product::get();
2
3foreach($products as $product) {
4    echo $product->title . ' / ' . $product->category->name . '<br/>';
5}
6
phpCopy

Apa yang dilakukan dari kode di atas adalah membuat query yang berulang pada tabel kategori. Lihat query di bawah:

1select * from `products`
2select * from `categories` where `categories`.`id` = 1 limit 1
3select * from `categories` where `categories`.`id` = 1 limit 1
4select * from `categories` where `categories`.`id` = 1 limit 1
5select * from `categories` where `categories`.`id` = 1 limit 1
6select * from `categories` where `categories`.`id` = 1 limit 1
7select * from `categories` where `categories`.`id` = 2 limit 1
8select * from `categories` where `categories`.`id` = 2 limit 1
9...
10
sqlCopy

Jika Anda ingin melihat query, coba pakai laravel debugbar, maka Anda akan melihat query yang berulang behind the scene nya. Anda mungkin sudah tahu, untuk menangani hal seperti ini bisa dengan yang namanya eager loading.

1//$products = Product::get();
2$products = Product::with('category:id,name,slug')->get();
3
4foreach($products as $product) {
5    echo $product->title . ' / ' . $product->category->name . '<br/>';
6}
7
phpCopy

Tetapi poin nya bukan itu, saya ingin memberi tahu, bahwa Anda bisa melakukan yang namanya prevention dengan menambahkan 1 bari kode pada AppServiceProvider. By default, dia akan seperti ini kurang lebih:

1namespace App\Providers;
2
3use Illuminate\Support\ServiceProvider;
4
5class AppServiceProvider extends ServiceProvider
6{
7    public function register()
8    {
9        //
10    }
11
12    public function boot()
13    {
14        //
15    }
16}
17
phpCopy

Dan kita akan menambahkan yang tepat pada method boot seperti:

1namespace App\Providers;
2
3use Illuminate\Database\Eloquent\Model;
4use Illuminate\Support\ServiceProvider;
5
6class AppServiceProvider extends ServiceProvider
7{
8    public function register() {...}
9
10    public function boot()
11    {
12        Model::preventLazyLoading(!$this->app->isProduction());
13    }
14}
15
phpCopy

Perhatikan bahwa disana saya memberikan !$this->app->isProduction() pada parameter nya, itu artinya error akan muncul pada saat mode local saja, jika sudah mode production, maka itu akan tidak kelihatan lagi error nya. Anda bisa set environment nya pada file .env.

Dan sekarang, jika Anda hilangkan eager load nya pada saat menampilkan produk, maka harusnya akan ada error exception yang kita terima. Perhatikan kode dibawah ini:

1$products = Product::get();
2//$products = Product::with('category:id,name,slug')->get();
3
4foreach($products as $product) {
5    echo $product->title . ' / ' . $product->category->name . '<br/>';
6}
7
phpCopy

Lihat di browser, maka akan ada error exception yang itu dari LazyLoadingViolationException.

1Attempted to lazy load [category] on model [App\Models\Product] but lazy loading is disabled.
2
bashCopy

Namun, jika kita ingin menampilkan error secara diam-diam, bisa dibilang kita ingin melihat ni apa-apa saja yang kena lazy load saat production. Kita bisa menggunakan yang namanya handleLazyLoadingViolationUsing, untuk itu kita bisa buat kode nya seperti:

1public function boot()
2{
3    Model::preventLazyLoading();
4
5    if ($this->app->isProduction()) {
6        Model::handleLazyLoadingViolationUsing(function ($model, $relation) {
7            $class = get_class($model);
8
9            info("Attempted to lazy load [{$relation}] on model [{$class}].");
10        });
11    }
12}
13
phpCopy

Maka dengan seperti itu, jika aplikasi kita sudah di mode production dan memang ada yang memiliki isu n+1. Harusnya error akan muncul pada storage/logs/laravel.log. Jika Anda ingin melihat bagaimana melihat log ini dengan mudah, Anda bisa lihat pada artikel ini: Penampil Log yang Mantap untuk Laravel

Polymorphic mapping

Relasi yang kita gunakan jika kita ingin memanfaatkan satu tabel yang itu bisa di pakai di beberapa tabel. Bayangkan jika Anda mempunyai tabel artikel dan video dengan masing-masing dari mereka mempunyai komentar. Dan itu harusnya bisa dibuat 1 tabel saja untuk komentarnya, dan akan dipakaikan ke tabel artikel dan video.

Jadi kurang lebih struktur tabel nya akan seperti:

1articles
2    id - bigint
3    title - string
4 
5videos
6    id - bigint
7    title - string
8 
9comments
10    id - bigint
11    user_id - bigint
12    body - text
13    commentable_id - bigint
14    commentable_type - string
15
bashCopy

Dan harusnya isi dari kolom commentable_type akan menunjukkan model yang dipakai seperti:

1mysql> select id, body, commentable_type, commentable_id from comments;
2+----+------+--------------------+----------------+
3| id | body | commentable_type   | commentable_id |
4+----+------+--------------------+----------------+
5|  1 | ...  | App\Models\Article |              3 |
6|  2 | ...  | App\Models\Article |             44 |
7|  3 | ...  | App\Models\Video   |              1 |
8|  4 | ...  | App\Models\Article |              4 |
9|  5 | ...  | App\Models\Video   |             66 |
10|  6 | ...  | App\Models\Video   |             64 |
11+----+------+--------------------+----------------+
12
bashCopy

Ini adalah standard dari laravel yang memasukkan full namespace dari model tersebut. Yang itu bisa dibilang tidak good practice. Kenapa seperti itu, bayangkan jika kita merubah classname nya dengan alasan yang bisa saja. Maka semua kode akan break karena telah mengambil class tersebut sebagai identifier nya.

Untuk merubah default ini kita bisa menggunakan yang namanya morphMap pada metode boot yang ada pada AppServiceProvider.

1namespace App\Providers;
2
3use Illuminate\Database\Eloquent\Model;
4use Illuminate\Database\Eloquent\Relations\Relation;
5use Illuminate\Support\ServiceProvider;
6
7class AppServiceProvider extends ServiceProvider
8{
9    public function register() {...}
10
11    public function boot()
12    {
13        ...
14        Relation::morphMap([
15            'video' => \App\Models\Video::class,
16            'article' => \App\Models\Article::class,
17        ]);
18    }
19}
20
phpCopy

Dengan begitu, maka nanti setiap ada penambahan file harusnya akan sudah di map dengan ketentuan yang sudah kita buat. Namun, jika data yang Anda miliki sudah ada, jangan lupa untuk memperbarui nya secara manual ya seperti:

1UPDATE `comments`
2SET commentable_type = 'video'
3WHERE commentable_type = 'App\\Models\\Video'
4
sqlCopy

Dengan begitu, harusnya sekarang akan sudah berubah, dan jangan lupa update juga untuk artikel nya. Jadi sekarang jika kita lihat isi tabel nya akan sudah berubah seperti:

1mysql> select id, body, commentable_type, commentable_id from comments;
2+----+------+------------------+----------------+
3| id | body | commentable_type | commentable_id |
4+----+------+------------------+----------------+
5|  1 | ...  | article          |              3 |
6|  2 | ...  | article          |             44 |
7|  3 | ...  | video            |              1 |
8|  4 | ...  | article          |              4 |
9|  5 | ...  | video            |             66 |
10|  6 | ...  | article          |             64 |
11+----+------+------------------+----------------+
12
bashCopy

Model strictness

Sejak laravel versi 9.35.0, kita telah diberikan metode baru untuk model yaitu Model::shouldBeStrict, dimana metode 3 strictness eloquent yaitu:

1. Model::preventLazyLoading()
2. Model::preventSilentlyDiscardingAttributes()
3. Model::preventsAccessingMissingAttributes()

Sebelum kita lanjut lebih jauh, disini saya akan menunjukkan struktur dari tabel users yang saya miliki.

1users
2    id - bigint
3    name - string
4    email - string
5    email_verified_at - datetime
6    password - string
7    remember_token - string
8    created_at - datetime
9    updated_at - datetime
10
bashCopy

Baik, sekarang saya akan mencoba menampilkan single user dengan mencoba memasukkan field yang tidak ada di dalam struktur tabel nya yaitu about.

1Route::get('users/{user}', function (User $user) {
2    return [
3        "id" => $user->id,
4        "name" => $user->name,
5        "about" => $user->about,
6        "created_at" => $user->created_at->format('j M Y, g:i a'),
7    ];
8});
9
phpCopy

Seharusnya, by default about akan menjadi null, lihat outputnya di browser akan sudah seperti:

1{
2    "id": 3,
3    "name": "Jimmy Page",
4    "about": null,
5    "created_at": "20 Oct 2022, 4:41 am"
6}
7
jsonCopy

Dan jika Anda perhatikan baik-baik, json itu menampilkan semua kolom yang ada di tabel users kecuali password, dan sudah pasti. Disini kita tidak punya yang namanya kolom about. Sekarang, saya akan menambahkan 1 baris kode lagi pada metode boot seperti:

1public function boot()
2{
3    Model::shouldBeStrict();
4  
5    Model::preventLazyLoading();
6    if ($this->app->isProduction()) {...}
7
8    Relation::morphMap([...]);
9}
10
phpCopy

Perhatikan pada baris yang tandai, itu adalah penambahan yang saya maksud, guna untuk memberitahu kita, mana nih attribute yang tidak ada dalam kolom tabel nya yang kita coba untuk tampilkan. Refresh di browser, dan sekarang akan muncul exception error dari MissingAttributeException yang kurang lebih itu seperti:

1The attribute [about] either does not exist or was not retrieved for model [App\Models\User].
2
bashCopy

Sama layaknya seperti preventLazyLoading, kita tentunya juga bisa membuat ini diam-diam di waktu mode production.

1public function boot()
2{
3    Model::shouldBeStrict();
4
5    Model::preventLazyLoading();
6    
7    if ($this->app->isProduction()) {
8        Model::handleLazyLoadingViolationUsing(function ($model, $relation) {
9            $class = get_class($model);
10
11            info("Attempted to lazy load [{$relation}] on model [{$class}].");
12        });
13        
14        Model::handleLazyLoadingViolationUsing(...);
15    }
16
17    Relation::morphMap(...);
18}
19
phpCopy

Dan jika Anda memang tidak ingin menampilkan exception lewat log laravel, entah mungkin itu dengan alasan tersendiri. Anda bisa matikan itu dengan cara seperti:

1public function boot()
2{
3    Model::preventAccessingMissingAttributes();
4    Model::preventSilentlyDiscardingAttributes();
5
6    Model::preventLazyLoading(!$this->app->isProduction());
7
8    Relation::morphMap([
9        'video' => \App\Models\Video::class,
10        'article' => \App\Models\Article::class,
11    ]);
12}
13
phpCopy

Saya sengaja mengaktifkan preventAccessingMissingAttributes, karena itu bergantung dengan kebenaran data yang kita tidak tampilkan, kita tidak bisa menjamin sampai mana typo yang kita lakukan. Jadi harusnya, dengan adanya metode ini, memudahkan kita melihat dimana kesalahan kita untuk kemudian kita benarkan.

Kesimpulan

Bisa sama-sama kita simpulkan bahwa menggunakan laravel itu yang penting explicit. Semua yang diberikan by default itu bisa dibilang implicit, sehingga tugas kita sebagai developer membuatnya explicit. Semoga artikel ini bermanfaat, saya Irsyad. Dan saya akan melihat Anda nanti di artikel selanjutnya.