Разработка PHP-форума: ключевые этапы и варианты реализации

Ниже приведены расширенные примеры реализации ключевых компонентов форума на PHP.

Пример 1: Класс Topic с методами выборки и пагинации

Класс, работающий с таблицей topics, включая подсчёт общего количества тем и выборку с пагинацией.

<?php
namespace Forum;

class Topic {
    private $pdo;

    public function __construct(\PDO $pdo) {
        $this->pdo = $pdo;
    }

    public function getAllTopics(int $page = 1, int $perPage = 10): array {
        $offset = ($page - 1) * $perPage;
        $stmt = $this->pdo->prepare(
            "SELECT id, title, author, created_at 
             FROM topics 
             ORDER BY created_at DESC 
             LIMIT :limit OFFSET :offset"
        );
        $stmt->bindValue(':limit', $perPage, \PDO::PARAM_INT);
        $stmt->bindValue(':offset', $offset, \PDO::PARAM_INT);
        $stmt->execute();
        return $stmt->fetchAll();
    }

    public function getTotalTopics(): int {
        $stmt = $this->pdo->query("SELECT COUNT(*) FROM topics");
        return (int) $stmt->fetchColumn();
    }

    public function addTopic(string $title, string $author): bool {
        $stmt = $this->pdo->prepare(
            "INSERT INTO topics (title, author) VALUES (:title, :author)"
        );
        return $stmt->execute(['title' => $title, 'author' => $author]);
    }
}
  

Результат вызова getAllTopics(1, 3) (если в таблице 5 записей) - массив из трёх последних тем.

Array
(
    [0] => Array
        (
            [id] => 5
            [title] => Третья тема
            [author] => Иван
            [created_at] => 2025-03-20 10:00:00
        )
    [1] => Array
        (
            [id] => 4
            [title] => Вторая тема
            [author] => Пётр
            [created_at] => 2025-03-19 15:30:00
        )
    [2] => Array
        (
            [id] => 3
            [title] => Первая тема
            [author] => Анна
            [created_at] => 2025-03-18 12:00:00
        )
)
  

Пример 2: Добавление сообщения с проверкой CSRF

Включает генерацию CSRF-токена, встраивание в форму, проверку на стороне сервера.

// В контроллере add_post.php
session_start();
if (empty($_SESSION['csrf'])) {
    $_SESSION['csrf'] = bin2hex(random_bytes(32));
}

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    // Проверка токена
    if (!hash_equals($_SESSION['csrf'], $_POST['csrf'] ?? '')) {
        die('Недействительный CSRF-токен');
    }
    
    $text = $_POST['message'] ?? '';
    $topicId = $_POST['topic_id'] ?? 0;
    
    // Валидация
    if (empty($text) || empty($topicId)) {
        // обработка ошибки
    } else {
        // Запись в БД
        $pdo = Database::getInstance()->getPdo();
        $stmt = $pdo->prepare("INSERT INTO posts (topic_id, text, author) VALUES (:topic_id, :text, :author)");
        $stmt->execute([
            'topic_id' => $topicId,
            'text' => htmlspecialchars($text, ENT_QUOTES),
            'author' => $_SESSION['user'] ?? 'Guest'
        ]);
        header('Location: /topic.php?id=' . $topicId);
        exit;
    }
}
  

HTML-форма с CSRF:

<form method="post" action="/add_post.php">
  <input type="hidden" name="csrf" value="<?= htmlspecialchars($_SESSION['csrf'], ENT_QUOTES) ?>">
  <input type="hidden" name="topic_id" value="<?= htmlspecialchars($topicId, ENT_QUOTES) ?>">
  <textarea name="message" required></textarea>
  <button type="submit">Ответить</button>
</form>
  

Пример 3: Использование транзакций для сложных операций

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

public function deleteTopic(int $topicId): bool {
    $pdo = $this->pdo;
    try {
        $pdo->beginTransaction();
        // Удаляем сообщения
        $stmt = $pdo->prepare("DELETE FROM posts WHERE topic_id = :id");
        $stmt->execute(['id' => $topicId]);
        // Удаляем саму тему
        $stmt = $pdo->prepare("DELETE FROM topics WHERE id = :id");
        $stmt->execute(['id' => $topicId]);
        $pdo->commit();
        return true;
    } catch (\PDOException $e) {
        $pdo->rollBack();
        // Логирование ошибки
        return false;
    }
}
  

Пример 4: Реализация вложенных ответов (древовидные комментарии)

Можно добавить столбец parent_id в таблицу posts. При выборке строить дерево с помощью рекурсивной функции или вложенных множеств (nested set). Ниже - простой пример с рекурсией:

class Post {
    public function getPostsByTopic(int $topicId): array {
        $stmt = $this->pdo->prepare("SELECT id, parent_id, text, author FROM posts WHERE topic_id = :tid ORDER BY created_at");
        $stmt->execute(['tid' => $topicId]);
        $rows = $stmt->fetchAll();
        return $this->buildTree($rows, 0);
    }

    private function buildTree(array $elements, int $parentId = 0): array {
        $branch = [];
        foreach ($elements as $element) {
            if ($element['parent_id'] == $parentId) {
                $children = $this->buildTree($elements, $element['id']);
                if ($children) {
                    $element['children'] = $children;
                }
                $branch[] = $element;
            }
        }
        return $branch;
    }
}
  

Результат - вложенный массив, удобный для рекурсивного вывода в шаблоне.

Пример 5: Кеширование для ускорения загрузки

Используем простой файловый кеш для списка тем.

public function getCachedTopics(): array {
    $cacheFile = __DIR__ . '/../cache/topics.php';
    $cacheTime = 300; // 5 минут
    
    if (file_exists($cacheFile) && (time() - filemtime($cacheFile) < $cacheTime)) {
        return include $cacheFile;
    }
    
    $topics = $this->getAllTopics();
    file_put_contents($cacheFile, '<?php return ' . var_export($topics, true) . ';');
    return $topics;
}
  

При каждом запросе нужно проверять время обновления (например, при добавлении темы сбросить кеш).