페이지네이션

use Illuminate\Support\Facades\DB;

// 1페이지당 15건씩 가져오기
$users = DB::table('users')->paginate(15);

use App\Models\User;

$users = User::paginate(15);

// 조건 포함
$users = User::where('votes', '>', 100)->paginate(15);

$users = DB::table('users')->simplePaginate(15);
$users = User::where('active', true)->simplePaginate(15);

// orderBy가 필수
$users = DB::table('users')->orderBy('id')->cursorPaginate(15);
$users = User::where('active', true)->cursorPaginate(15);

http://example.com/users?cursor=eyJpZCI6MTUsIl9wb2ludHNUb05leHRJdGVtcyI6dHJ1ZX0

-- paginate() / simplePaginate() — OFFSET 사용
SELECT * FROM users ORDER BY id ASC LIMIT 15 OFFSET 15;

-- cursorPaginate() — WHERE 절 사용(인덱스가 효과적)
SELECT * FROM users WHERE id > 15 ORDER BY id ASC LIMIT 15;

<?php

namespace App\Http\Controllers;

use App\Models\User;
use Illuminate\View\View;

class UserController extends Controller
{
    public function index(): View
    {
        $users = User::orderBy('name')->paginate(20);

        return view('users.index', compact('users'));
    }
}

<div class="container">
    @foreach ($users as $user)
        <p>{{ $user->name }}</p>
    @endforeach
</div>

{{-- 페이지네이션 링크를 출력(Tailwind CSS 대응) --}}
{{ $users->links() }}

{{-- 현재 페이지 앞뒤 5페이지 분량을 표시 --}}
{{ $users->onEachSide(5)->links() }}

public function index(Request $request): View
{
    $perPage = $request->integer('per_page', 15);
    $perPage = min(max($perPage, 1), 100); // 1~100 범위로 제한

    $users = User::paginate($perPage);

    return view('users.index', compact('users'));
}

$users = User::paginate(
    perPage: 15,
    columns: ['*'],
    pageName: 'users'
);

$posts = Post::paginate(
    perPage: 10,
    columns: ['*'],
    pageName: 'posts'
);

$users = User::paginate(15);

// /admin/users?page=N 형식의 URL을 생성
$users->withPath('/admin/users');

// sort=votes를 각 페이지 링크에 추가
$users->appends(['sort' => 'votes']);

// 현재 요청의 모든 쿼리 파라미터를 이어받기
$users->withQueryString();

// URL 끝에 #users를 추가
$users->fragment('users');

use App\Models\User;

Route::get('/api/users', function () {
    return User::paginate(15);
});

{
    "total": 50,
    "per_page": 15,
    "current_page": 1,
    "last_page": 4,
    "first_page_url": "http://example.com/api/users?page=1",
    "last_page_url": "http://example.com/api/users?page=4",
    "next_page_url": "http://example.com/api/users?page=2",
    "prev_page_url": null,
    "path": "http://example.com/api/users",
    "from": 1,
    "to": 15,
    "data": [
        { "id": 1, "name": "홍길동" },
        { "id": 2, "name": "김하나" }
    ]
}

use App\Http\Resources\UserResource;
use App\Models\User;

Route::get('/api/users', function () {
    $users = User::paginate(15);

    return UserResource::collection($users);
});

{{-- 커스텀 뷰로 링크를 출력 --}}
{{ $paginator->links('vendor.pagination.custom') }}

{{-- 데이터를 추가로 전달 --}}
{{ $paginator->links('vendor.pagination.custom', ['theme' => 'dark']) }}

php artisan vendor:publish --tag=laravel-pagination

use Illuminate\Pagination\Paginator;

public function boot(): void
{
    Paginator::defaultView('vendor.pagination.custom');
    Paginator::defaultSimpleView('vendor.pagination.simple-custom');
}

use Illuminate\Pagination\Paginator;

public function boot(): void
{
    Paginator::useBootstrapFive(); // Bootstrap 5
    // Paginator::useBootstrapFour(); // Bootstrap 4
}

use Illuminate\Pagination\LengthAwarePaginator;

$items = collect(range(1, 200))->map(fn ($i) => ['id' => $i, 'name' => "아이템{$i}"]);

$perPage = 15;
$currentPage = request()->integer('page', 1);

$paginator = new LengthAwarePaginator(
    items: $items->forPage($currentPage, $perPage),
    total: $items->count(),
    perPage: $perPage,
    currentPage: $currentPage,
    options: ['path' => request()->url()]
);

$paginator = User::paginate(15);

$paginator->currentPage();     // 현재 페이지 번호
$paginator->lastPage();        // 마지막 페이지 번호(simplePaginate에서는 사용 불가)
$paginator->total();           // 총 건수(simplePaginate에서는 사용 불가)
$paginator->perPage();         // 1페이지당 건수
$paginator->count();           // 현재 페이지의 건수
$paginator->firstItem();       // 현재 페이지의 첫 아이템 번호
$paginator->lastItem();        // 현재 페이지의 마지막 아이템 번호
$paginator->hasPages();        // 여러 페이지가 존재하는지
$paginator->hasMorePages();    // 다음 페이지가 존재하는지
$paginator->onFirstPage();     // 첫 페이지인지
$paginator->onLastPage();      // 마지막 페이지인지
$paginator->nextPageUrl();     // 다음 페이지 URL
$paginator->previousPageUrl(); // 이전 페이지 URL
$paginator->url(3);            // 페이지 3의 URL
$paginator->items();           // 현재 페이지의 아이템 배열