Memanfaatkan Fitur Laravel Collection

Laravel collection adalah sebuah fitur bawaan laravel yang digunakan untuk mengolah data array, baik itu dari Eloquent maupun data yang dibuat sendiri berbentuk array.

Class collection hadir untuk memudahkan kita mengolah data array, selain dari segi kemudahan, dalam segi kecepatan juga bisa dikatakan cukup baik.

Membuat Laravel Collection

Seperti awal penulis katakan bahwa laravel collection berguna untuk mengolah data array dengan sangat mudah. Class laravel terletak di Illuminate\Support\Collection. Meskipun collection memiliki class tapi kita anda menggunakan helper atau function collect(), cara penggunaannya sama saja.

Karena mungkin didalam helper collect() tersebut dipanggil kelas Collection maka cara dan pelakuannya sama.

Pertama-tama buatlah sebuah controller dengan nama BelajarCollectionController.php dengan menjalankan perintah dibawah ini:

php artisan make:controller BelajarCollectionController

Lalu selanjutnya ikuti step-step dibawah ini.

Menggunakan Class Collection

Didalam file BelajarCollectionController.php yang tadi anda buat tersebut, tambahkan kode dibawah ini tepat dibawah kode use Illuminate\Http\Request; didalam file BelajarCollectionController.

use Illuminate\Support\Collection;Code language: PHP (php)

Setelah itu tambahkan method dibawah ini didalam controller BelajarCollectionController yang tadi sudah dibuat.

public function collectionDenganClass()
{
    $collection = new Collection(['PHP', 'Laravel', 'HTML', 'Bootstrap']);

    dd($collection);
}Code language: PHP (php)

Selanjutnya tambahkan route agar method tersebut dapat diakses di browser.

Route::get('/collection-dengan-class', 'App\Http\Controllers\BelajarCollectionController@collectionDenganClass');Code language: PHP (php)

Lalu akses di browser anda dengan URL berikut ini.

http://127.0.0.1:8000/collection-dengan-class

Maka akan nampak tampilan seperti dibawah ini.

Fungsi dd() diatas digunakan untuk debug data array, agar lebih mudah dibaca dengan tampilan seperti diatas berwarna hitam adalah hasil dari dd().

Menggunakan Helper Collection

Selain itu di laravel collection anda juga dapat menggunakan sebuah helper atau function collect() untuk dapat menggunakan fitur tersebut, caranya seperti dibawah ini.

Tambahkan kode dibawah ini didalam controller yang tadi sudah dibuat.

public function collectionDenganHelper()
{
    $collection = collect(['PHP', 'Laravel', 'HTML', 'Bootstrap']);

    dd($collection);
}Code language: PHP (php)

Lalu tambahkan kode dibawah ini didalam file route anda.

Route::get('/collection-dengan-helper', 'App\Http\Controllers\BelajarCollectionController@collectionDenganHelper');Code language: PHP (php)

Setelah itu silahkan akses di browser anda, maka hasilnya akan sama seperti saat anda menggunakan class Collection tadi, itu karena helper collect() memanggil class Collection.

Helper collect() tersebut sangat mempercepat pekerja karena anda tidak perlu mendeklarasikan didalam controller, hanya tinggal memanggil helper tadi anda sudah bisa menggunakan collection.

Mencari Data Di Array Dengan Collection

Ada dua cara mencari data di array dengan collection laravel. Yaitu menggunakan contains() dan where(), keduanya tentu saja berbeda satu sama lainnya. Penulis akan menjelaskan setelah praktek kode dibawah ini.

Buatlah sebuah method dengan nama cariCollectionDenganContains(), seperti pada kode dibawah ini.

public function cariCollectionDenganContains()
{
    $collection = collect([
        [
            'id' => 2020120901,
            'nama' => 'Aris',
        ],
        [
            'id' => 2020120902,
            'nama' => 'Pida',
        ],
        [
            'id' => 2020120903,
            'nama' => 'Rinjani Azalia Putri',
        ],
    ]);

    if($collection->contains('nama', 'Aris')) {
        return '<h3>Nama Aris ada didalam daftar collection</h3>';
    }

    return '<h3>Nama yang dicari tidak ditemukan</h3>';
}Code language: PHP (php)

Lalu tambahkan route seperti dibawah ini:

Route::get('/cari-collection-dengan-contains', 'App\Http\Controllers\BelajarCollectionController@cariCollectionDenganContains');Code language: PHP (php)

Setelah itu coba akses di browser anda dengan URL dibawah ini:

http://127.0.0.1:8000/cari-collection-dengan-contains

Maka selanjutnya akan tampil di browser seperti gambar dibawah ini:

Dari sini kita bisa pahami bahwa helper atau function contains() tersebut menacari sebuah kata berdasarkan kunci didalam sebuah array, namun contains() tidak bisa mengembalikan data yang ditemukan dalam bentuk array melainkan hanya dalam bentuk boolean saja.

Lalu bagaimana menampilkan hasil pencarian dengan laravel collection?

Kita bisa memanfaatkan helper atau function where() untuk mencari data didalam array dan menampilkan rangkaian data tersebut, buatlah sebuah method dengan nama cariCollectionDenganWhere() seperti kode dibawah ini:

public function cariCollectionDenganWhere()
{
    $collection = collect([
        [
            'id' => 2020120901,
            'nama' => 'Aris',
        ],
        [
            'id' => 2020120902,
            'nama' => 'Pida',
        ],
        [
            'id' => 2020120903,
            'nama' => 'Rinjani Azalia Putri',
        ],
    ]);

    return $collection->where('nama', 'Aris');
}Code language: PHP (php)

Setelah itu tambahkan sebuah route:

Route::get('/cari-collection-dengan-where', 'App\Http\Controllers\BelajarCollectionController@cariCollectionDenganWhere');Code language: PHP (php)

Lalu akses di browser dengan URL seperti dibawah ini:

http://127.0.0.1:8000/cari-collection-dengan-where

Maka akan tampil hasil pencarian seperti dibawah ini:

Perhatikan hasil pencarian dengan nama Aris ditemukan dengan ID 2020120901, yang perlu di ingat, collection akan mengembalikan data tersebut berbentuk data JSON, jika ingin dikembalikan dengan bentuk array anda hanya perlu decode json tersebut.

Filter Data Collection

Selanjutnya adalah fitur filtrasi data dengan filter() di collection, gunanya adalah untuk memfilter atau membatasi data apa yang tidak ingin ditampilkan ketika ingin mengeluarkan semua data collection.

Buatlah sebuah method dengan nama filterCollection() seperti kode dibawah ini:

public function filterCollection()
{
    $collection = collect([
        ['produk' => 'Monitor', 'harga' => 800000],
        ['produk' => 'Mouse', 'harga' => 50000],
        ['produk' => 'Printer', 'harga' => 300000]
    ]);

    $filterCollection = $collection->filter(function($barang) {
        return data_get($barang, 'harga') > 100000;
    });

    dd($filterCollection->all());
}Code language: PHP (php)

Lalu tambahkan sebuah route seperti kode dibawah ini:

Route::get('/filter-collection', 'App\Http\Controllers\BelajarCollectionController@filterCollection');Code language: PHP (php)

Selanjutnya buka di browser anda dengan URL berikut ini:

http://127.0.0.1:8000/filter-collection

Maka akan tampil seperti gambar dibawah ini:

Jika kita perhatikan didalam method filterCollection() ada sebuah proses dimana akan membatasi produk yang harganya dibawah 100000 (seratus ribu), itulah bagaimana fitur filter di collection ini bekerja.

Mengurutkan Data Collection

Selanjutnya adalah mengurutkan data array dengan fitur sortBy(), fitur sortBy() ini dapat mengurutkan berdasarkan key array, sortBy() dapat mengurutkan dari yang terkecil sampai ke yang terbesar. Caranya, buatlah sebuah method dengan nama sortCollection() seperti pada kode dibawah ini:

public function sortCollection()
{
    $collection = collect([
        ['nama' => 'Rinjani'],
        ['nama' => 'Pida'],
        ['nama' => 'Aris']
    ]);

    dd($collection->sortBy('nama'));
}Code language: PHP (php)

Lalu tambahkan route seperti dibawah ini:

Route::get('/sort-collection', 'App\Http\Controllers\BelajarCollectionController@sortCollection');Code language: PHP (php)

Lalu akses di browser dengan URL seperti dibawah ini:

http://127.0.0.1:8000/sort-collection

Maka harusnya tampil seperti dibawah ini:

Hasil dari tampilan browser diatas adalah setelah di urutkan oleh sortBy() laravel, selain sortBy() anda bisa menggunakan sortByDesc() untuk mengurutkan data secara descending.

Memotong Data Collection

Selanjutnya fitur collection juga dapat memudahkan kita untuk memotong data array, maksudnya memotong disini adalah mengambil beberapa data saja dari depan dengan menggunakan fungsi take(), berikut ini caranya.

Buat sebuah method dengan nama potongCollection() seperti kode dibawah ini:

public function potongCollection()
{
    $collection = collect(['PHP', 'MySQL', 'HTML', 'Python', 'Ruby on Rails']);

    dd($collection->take(3));
}Code language: PHP (php)

Selanjutnya tambahkan route seperti dibawah ini:

Route::get('/potong-collection', 'App\Http\Controllers\BelajarCollectionController@potongCollection');Code language: PHP (php)

Lalu akses di browser anda dengan URL seperti dibawah ini:

http://127.0.0.1:8000/potong-collection

Maka akan tampil seperti dibawah ini:

Dari tampilan diatas bisa diperhatikan bahwa dari 5 data array yang tampil hanya 3 saja, itu karena dipotong dengan fungsi take() tadi, dimana dia akan mengambil 3 array dari depan.

Mencari Perbedaan Dua Buah Array

Untuk dapat menampilkan data array yang berbeda diantara array 1 dan array 2 dapat menggunakan fungsi diff(), contohnya buatlah sebuah method dengan nama diffCollection() seperti kode dibawah ini:

public function diffCollection()
{
    $collection1 = collect(['PHP', 'MySQL', 'HTML', 'Ruby']);
    $collection2 = collect(['PHP', 'CSS', 'HTML', 'Python']);

    $newCollection = $collection1->diff($collection2);

    dd($newCollection);
}Code language: PHP (php)

Lalu tambahkan route:

Route::get('/diff-collection', 'App\Http\Controllers\BelajarCollectionController@diffCollection');Code language: PHP (php)

Setelah itu buka browser anda dan ketikan URL dibawah ini:

http://127.0.0.1:8000/diff-collection

Maka hasilnya akan seperti dibawah ini:

Dari gambar diatas terlihat yang muncul hanya MySQL dan Ruby, itu karena diantara array 1 dan array 2 yang tidak memiliki kesamaan nilai adalah MySQL dan Ruby.

Membalikan Nilai Array

Maksud dari membalikan nilai array disini adalah memutar antara key dan value, dimana key akan jadi value dan value akan jadi key, untuk lebih jelasnya buatlah sebuah method dengan nama flipCollection() seperti kode dibawah ini:

public function flipCollection()
{
    $collection = collect([
        'name' => 'iPhone',
        'brand' => 'Apple'
    ]);

    dd($collection->flip());
}Code language: PHP (php)

Seperti biasa tambahkan route seperti dibawah ini:

Route::get('/flip-collection', 'App\Http\Controllers\BelajarCollectionController@flipCollection');Code language: PHP (php)

Lalu akses di browser dengan URL seperti dibawah ini:

http://127.0.0.1:8000/flip-collection

Maka selanjutnya akan tampil seperti dibawah ini:

Perhatikan bahwa yang awalnya name dan brand adalah key, iPhone dan Apple adalah value setelah di flip dia jadi bertukar tempat.

Mengambil Nilai Array Berdasarkan Key

Kita akan mencoba mengambil nilai dari array berdasarkan key yang diberikan dengan menggunakan fungsi get(), buatlah sebuah method dengan nama getCollection() seperti kode dibawah ini:

public function getCollection()
{
    $collection = collect([
        'name' => 'iPhone',
        'brand' => 'Apple'
    ]);

    return $collection->get('name');
}Code language: PHP (php)

Selanjutnya buatlah sebuah route seperti kode dibawah ini:

Route::get('/get-collection', 'App\Http\Controllers\BelajarCollectionController@getCollection');Code language: PHP (php)

Lalu akses di browser anda dengan URL dibawah ini:

http://127.0.0.1:8000/get-collection

Maka hasilnya seperti gambar dibawah ini:

Group Data Array

Group data sangat berguna ketika anda ingin membuat sebuah laporan dimana data yang diterima adalah sebuah array, misalnya buatlah sebuah method dengan nama groupCollection() lalu buat kode seperti dibawah ini:

public function groupCollection()
{
    $collection = collect([
        ['Januari' => 100],
        ['Februari' => 50],
        ['Maret' => 10],
        ['Januari' => 30],
        ['Februari' => 40],
        ['Maret' => 25]
    ]);

    dd($collection->groupBy('Maret'));
}Code language: PHP (php)

Lalu masukkan route dibawah ini:

Route::get('/group-collection', 'App\Http\Controllers\BelajarCollectionController@groupCollection');Code language: PHP (php)

Dan akses dengan URL dibawah ini:

http://127.0.0.1:8000/group-collection

Maka hasilnya seperti dibawah ini.

Yang nampak hanya nilai dari mulai Maret, itu karena hasil dari group data berdasarkan bulan Maret tersebut.

Sekian pembahasan mengenai Laravel Collection, semoga bermanfaat dan dapat membantu anda semua.