Организация постраничного вывода тем на PHP-форуме

Расширенные примеры пагинации для форума

Приведём полные реализации с обработкой краевых случаев и дополнительными возможностями.

Класс Pagination с генерацией HTML-ссылок

Следующий класс формирует блок постраничной навигации с ссылками «Первая», «Предыдущая», номера вокруг текущей страницы, «Следующая», «Последняя».

class Pagination {
    private $totalPages;
    private $currentPage;
    private $url;

    public function __construct($totalItems, $perPage, $currentPage, $url = '') {
        $this->totalPages = (int)ceil($totalItems / $perPage);
        $this->currentPage = max(1, min($currentPage, $this->totalPages));
        $this->url = $url ?: $_SERVER['PHP_SELF'];
    }

    public function render() {
        if ($this->totalPages <= 1) return '';
        $html = '<nav><ul class="pagination">';
        // Первая страница
        if ($this->currentPage > 1) {
            $html .= '<li><a href="' . $this->url . '?page=1">Первая</a></li>';
            $html .= '<li><a href="' . $this->url . '?page=' . ($this->currentPage - 1) . '">Предыдущая</a></li>';
        }
        // Диапазон номеров
        $start = max(1, $this->currentPage - 2);
        $end = min($this->totalPages, $this->currentPage + 2);
        for ($i = $start; $i <= $end; $i++) {
            $active = ($i == $this->currentPage) ? ' class="active"' : '';
            $html .= '<li' . $active . '><a href="' . $this->url . '?page=' . $i . '">' . $i . '</a></li>';
        }
        // Следующая и последняя
        if ($this->currentPage < $this->totalPages) {
            $html .= '<li><a href="' . $this->url . '?page=' . ($this->currentPage + 1) . '">Следующая</a></li>';
            $html .= '<li><a href="' . $this->url . '?page=' . $this->totalPages . '">Последняя</a></li>';
        }
        $html .= '</ul></nav>';
        return $html;
    }
}

Пример использования:

$totalTopics = 156;
$perPage = 10;
$current = isset($_GET['page']) ? (int)$_GET['page'] : 1;
$pagination = new Pagination($totalTopics, $perPage, $current);
echo $pagination->render();

Результат (HTML):
<nav><ul class="pagination"><li><a href="/forum.php?page=1">Первая</a></li>...</ul></nav>

Пагинация с сортировкой по дате и поиском

Добавим в запрос условие поиска и сортировку. Параметры поиска и страницы должны передаваться в URL.

$keyword = isset($_GET['q']) ? trim($_GET['q']) : '';
$page = isset($_GET['page']) ? (int)$_GET['page'] : 1;
$perPage = 10;
$offset = ($page - 1) * $perPage;

$where = '';
$params = [];
if ($keyword) {
    $where = 'WHERE title LIKE :keyword';
    $params[':keyword'] = '%' . $keyword . '%';
}

// Общее количество
$countSql = "SELECT COUNT(*) FROM topics $where";
$countStmt = $pdo->prepare($countSql);
$countStmt->execute($params);
$total = $countStmt->fetchColumn();

// Выборка текущей страницы
$sql = "SELECT * FROM topics $where ORDER BY created_at DESC LIMIT :limit OFFSET :offset";
$stmt = $pdo->prepare($sql);
$stmt->bindValue(':limit', $perPage, PDO::PARAM_INT);
$stmt->bindValue(':offset', $offset, PDO::PARAM_INT);
foreach ($params as $key => $val) {
    $stmt->bindValue($key, $val);
}
$stmt->execute();
$topics = $stmt->fetchAll();

// Формирование ссылок с сохранением поискового запроса
$queryString = http_build_query(array_merge($_GET, ['page' => '']));
$url = $_SERVER['PHP_SELF'] . '?' . $queryString;
// Далее используется Pagination с подстановкой $url

Такой код гарантирует, что при переходе на другую страницу параметр q не потеряется. Обратите внимание на использование http_build_query для корректного формирования строки запроса.

Пример URL: /forum.php?q=php&page=2

AJAX-пагинация с поддержкой истории браузера (History API)

Улучшенный вариант, когда при клике на страницу URL изменяется, и пользователь может вернуться на предыдущую страницу. Сервер отдает HTML-блок, а JavaScript подменяет содержимое.

// JavaScript
function loadPage(page) {
    fetch('ajax.php?page=' + page + '&html=1')
        .then(response => response.text())
        .then(html => {
            document.getElementById('topics-wrapper').innerHTML = html;
            history.pushState({page: page}, '', '?page=' + page);
        });
}

// Обработка клика по ссылкам пагинации
$(document).on('click', '.pagination a', function(e) {
    e.preventDefault();
    const page = $(this).data('page'); // или из href
    loadPage(page);
});

// Восстановление состояния при нажатии назад
window.addEventListener('popstate', function(e) {
    if (e.state && e.state.page) {
        loadPage(e.state.page);
    }
});

На сервере (ajax.php) при наличии параметра html=1 возвращается не JSON, а готовый HTML-фрагмент (например, список тем). Это упрощает обработку на клиенте.

if (isset($_GET['html'])) {
    // вывод HTML-блока
    foreach ($topics as $topic) {
        echo '<div class="topic">' . htmlspecialchars($topic['title']) . '</div>';
    }
    exit;
}

Такой подход сочетает удобство AJAX и сохраняемость навигации.