Pagination Laravel 9 + Bootstrap5 + MySQL

Pagination Laravel 9

Pagination Laravel 9 – Tutorial pagination Laravel 9 dengan Bootstrap 5 dan database MySQL. Kasus kali ini adalah mengolah data pelanggan (Customer).

1. Membuat Project Laravel

Pastikan Anda sudah menginstall composer, kemudian jalankan perintah berikut di command prompt.

composer create-project laravel/laravel laravel-pagination

2. Mengatur Database MySQL

Buat database dengan nama laravel_pagination di http://localhost/phpmyadmin jika Anda menginstall XAMPP untuk server MySQL.

Sesuaikan pengaturan koneksi mysql di project laravel pada file .env

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_pagination
DB_USERNAME=root
DB_PASSWORD=

Sesuaikan DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, dan DB_PASSWORD sesuai server MySQL.

3. Membuat Migration Customer

Laravel 9 sudah menyediakan migration untuk users, password_resets, failed_jobs, dan personal_access_tokens yang ada di direktori database/migrations. Anda bisa menghapus file tersebut dan membuat migration baru dengan perintah berikut.

php artisan make:migration create_customers_table

Kemudian sesuaikan field pada migration sebagai berikut.

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('customers', function (Blueprint $table) {
            $table->id('customer_id');
            $table->string('customer_name');
            $table->string('contact_name');
            $table->string('address');
            $table->string('city');
            $table->string('postal_code');
            $table->string('country');
            $table->timestamps();
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('customers');
    }
};

Lakukan migration dengan mengetikan perintah berikut.

php artisan migrate

Setelah berhasil menjalankan perintah migrate, maka di database akan ada tabel customers.

4. Membuat Model Customer (Eloquent)

Buat model Customer menggunakan perintah berikut.

php artisan make:model Customer

Hasil dari model yang dibuat ada di app/models/Customer.php sebagai berikut.

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;

class Customer extends Model
{
    use HasFactory;
}

5. Membuat Factory + Faker

Factory dan Faker berfungsi untuk membuat data dummy sebagai percobaan. Jika Anda sudah punya data bisa diimport atau diinput lewat phpmyadmin dan lewati langkah ini, langsung menuju ke langkah 7 . Buat Factory untuk model Customer dengan nama CustomerFactory dengan perintah berikut.

php artisan make:factory CustomerFactory

Pastikan nama factory sesuai dengnan nama model, diikuti dengan akhiran Factory. Sesuaikan data dummy di database/factories/CustomerFactory.php sebagai berikut.

<?php

namespace Database\Factories;

use Illuminate\Database\Eloquent\Factories\Factory;

/**
 * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Model>
 */
class CustomerFactory extends Factory
{
    /**
     * Define the model's default state.
     *
     * @return array
     */
    public function definition()
    {
        return [
            'customer_name' => $this->faker->name(),
            'contact_name' => $this->faker->lastName(),
            'address' => $this->faker->address(),
            'city' => $this->faker->city(),
            'postal_code' => $this->faker->postcode(),
            'country' => $this->faker->country(),
        ];
    }
}

6. Membuat Seeder

Seeder berfungsi untuk membangkitkan data sesuai data dummy yang sudah diatur di CustomerFactory. Pada kasus ini, akan dibuat 500 data dummy. Sesuaikan file database/seeders/DatabaseSeeder.php sebagai berikut.

<?php

namespace Database\Seeders;

use App\Models\Customer;
use Illuminate\Database\Console\Seeds\WithoutModelEvents;
use Illuminate\Database\Seeder;

class DatabaseSeeder extends Seeder
{
    /**
     * Seed the application's database.
     *
     * @return void
     */
    public function run()
    {
        Customer::factory(500)->create();
    }
}

Jalankan DatabaseSeeder menggunakan perintah berikut.

php artisan db:seed 

Maka pada tabel customer akan ada data dummy sebanyak 500 data.

7. Membuat Controller Customer

Gunakan perintah berikut untuk membuat controller.

php artisan make:controller CustomerController

Sesuaikan app/controllers/CustomerController.php sebagai berikut.

<?php

namespace App\Http\Controllers;

use App\Models\Customer;
use Illuminate\Http\Request;

class CustomerController extends Controller
{
    public function index(Request $request)
    {
        $data['q'] = $request->get('q');
        $data['customers'] = Customer::where('customer_name', 'like', '%' . $data['q'] . '%')->paginate(10)->withQueryString();
        return view('customer.index', $data);
    }
}

Perintah $request->get('q') berfungsi untuk mengambil input pencarian dari url.

Perintah where('customer_name', 'like', '%' . $data['q'] . '%') berfungsi sebagai query mengandung kata $data['q'].

Perintah paginate(10) berfungsi membuat halaman dimana terdiri dari 10 item setiap halaman.

Perintah withQueryString() berfungsi agar query string di url (misal: q atau pencarian) tetap ditampilkan di setiap halaman.

8. Menambahkan Route Customer

Tambahkan route untuk crud user di routes/web.php bertipe resource seperti berikut.

<?php

use App\Http\Controllers\CustomerController;
use Illuminate\Support\Facades\Route;

/*
|--------------------------------------------------------------------------
| Web Routes
|--------------------------------------------------------------------------
|
| Here is where you can register web routes for your application. These
| routes are loaded by the RouteServiceProvider within a group which
| contains the "web" middleware group. Now create something great!
|
*/

Route::get('/', function () {
    return view('welcome');
});

Route::get('customer', [CustomerController::class, 'index']);

9. Membuat View

Buat view untuk menampilkan data customer di direktori resources/views/customer/index.blade.php.

<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">

    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.1.3/dist/css/bootstrap.min.css" rel="stylesheet">

    <title>Pagination Laravel</title>
</head>

<body>
    <div class="container">
        <h1>Customers</h1>
        <div class="card">
            <div class="card-header">
                <form class="row row-cols-lg-auto g-1">
                    <div class="col">
                        <input class="form-control" type="text" name="q" value="{{ $q }}" placeholder="Search here..." />
                    </div>
                    <div class="col">
                        <button class="btn btn-success">Search</button>
                    </div>
                </form>
            </div>
            <div class="card-body p-0">
                <table class="table table-bordered table-striped table-hover m-0">
                    <thead>
                        <tr>
                            <th>#</th>
                            <th>Customer Name</th>
                            <th>Contact Name</th>
                            <th>Address</th>
                            <th>City</th>
                            <th>Postal Code</th>
                            <th>Country</th>
                        </tr>
                    </thead>
                    <?php
                    $i = $customers->firstItem();
                    ?>
                    @foreach($customers as $customer)
                    <tr>
                        <td>{{ $i++ }}</td>
                        <td>{{ $customer->customer_name }}</td>
                        <td>{{ $customer->contact_name }}</td>
                        <td>{{ $customer->address }}</td>
                        <td>{{ $customer->city }}</td>
                        <td>{{ $customer->postal_code }}</td>
                        <td>{{ $customer->country }}</td>
                    </tr>
                    @endforeach
                </table>
            </div>
            @if($customers->hasPages())
            <div class="card-footer">
                {{ $customers->links() }}
            </div>
            @endif
        </div>
    </div>
</body>

</html>

10. Mengatur Template Pagination

Atur agar template pagination sesuai dengan bootstrap 5 di app/providers/AppServiceProvider.php sebagai berikut.

<?php

namespace App\Providers;

use Illuminate\Pagination\Paginator;
use Illuminate\Support\ServiceProvider;

class AppServiceProvider extends ServiceProvider
{
    /**
     * Register any application services.
     *
     * @return void
     */
    public function register()
    {
    }

    /**
     * Bootstrap any application services.
     *
     * @return void
     */
    public function boot()
    {
        Paginator::useBootstrapFive();
    }
}

11. Menjalankan Project

Silahkan gunakan perintah berikut untuk mengaktifkan server laravel.

php artisan serve

Ketikkan alamat sesuai server diikuti dengan /customer di browser (http://127.0.0.1:8000/customer). Hasilnya seperti berikut.

Data Customer
Tambah Customer

Itulah tutorial membuat Pagination Laravel 9. Jika ada yang ditanyakan, silahkan berkomentar.

Leave a Comment

Alamat email Anda tidak akan dipublikasikan.

Situs ini menggunakan Akismet untuk mengurangi spam. Pelajari bagaimana data komentar Anda diproses.

To top