Разработка функционала разделов в PHP CMS

Расширенные примеры реализации страницы раздела PHP

Полный класс SectionManager с обработкой исключений и валидацией

class SectionManager {
    private PDO $pdo;

    public function __construct(PDO $pdo) {
        $this->pdo = $pdo;
        $this->pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    }

    /**
     * Получить все разделы с пагинацией и сортировкой
     */
    public function getAll(int $page = 1, int $perPage = 20, string $orderBy = 'sort_order'): array {
        $offset = ($page - 1) * $perPage;
        $allowedOrder = ['sort_order', 'title', 'created_at'];
        if (!in_array($orderBy, $allowedOrder)) {
            $orderBy = 'sort_order';
        }
        $stmt = $this->pdo->prepare(
            "SELECT * FROM sections ORDER BY $orderBy LIMIT :limit OFFSET :offset"
        );
        $stmt->bindValue(':limit', $perPage, PDO::PARAM_INT);
        $stmt->bindValue(':offset', $offset, PDO::PARAM_INT);
        $stmt->execute();
        return $stmt->fetchAll(PDO::FETCH_ASSOC);
    }

    /**
     * Получить количество разделов
     */
    public function count(): int {
        return (int)$this->pdo->query('SELECT COUNT(*) FROM sections')->fetchColumn();
    }

    /**
     * Создать раздел с проверкой уникальности slug
     */
    public function create(array $data): int {
        $this->validate($data);
        try {
            $stmt = $this->pdo->prepare(
                'INSERT INTO sections (title, slug, description, parent_id, sort_order) VALUES (?, ?, ?, ?, ?)'
            );
            $stmt->execute([
                $data['title'],
                $data['slug'],
                $data['description'] ?? '',
                $data['parent_id'] ?? null,
                $data['sort_order'] ?? 0
            ]);
            return (int)$this->pdo->lastInsertId();
        } catch (PDOException $e) {
            if ($e->getCode() == 23000) {
                throw new RuntimeException('Раздел с таким slug уже существует.');
            }
            throw $e;
        }
    }

    /**
     * Валидация данных
     */
    private function validate(array $data): void {
        if (empty($data['title'])) {
            throw new InvalidArgumentException('Название раздела не может быть пустым.');
        }
        if (empty($data['slug'])) {
            $data['slug'] = $this->transliterate($data['title']);
        }
        if (!preg_match('/^[a-z0-9-]+$/', $data['slug'])) {
            throw new InvalidArgumentException('Slug должен содержать только латинские буквы, цифры и дефис.');
        }
    }

    private function transliterate(string $text): string {
        $trans = [
            'а'=>'a','б'=>'b','в'=>'v','г'=>'g','д'=>'d','е'=>'e','ё'=>'e','ж'=>'zh','з'=>'z',
            'и'=>'i','й'=>'y','к'=>'k','л'=>'l','м'=>'m','н'=>'n','о'=>'o','п'=>'p','р'=>'r',
            'с'=>'s','т'=>'t','у'=>'u','ф'=>'f','х'=>'kh','ц'=>'ts','ч'=>'ch','ш'=>'sh','щ'=>'shch',
            'ъ'=>'','ы'=>'y','ь'=>'','э'=>'e','ю'=>'yu','я'=>'ya'
        ];
        $text = mb_strtolower($text, 'UTF-8');
        $text = strtr($text, $trans);
        $text = preg_replace('/[^a-z0-9-]/', '-', $text);
        $text = preg_replace('/-+/', '-', $text);
        return trim($text, '-');
    }

    /**
     * Обновление с частичной валидацией
     */
    public function update(int $id, array $data): void {
        if (isset($data['slug'])) {
            $this->validate(['slug' => $data['slug'], 'title' => 'dummy']);
        }
        parent::update($id, $data); // используется метод из базового класса (упрощение)
    }
}

// Использование с транзакцией
$pdo->beginTransaction();
try {
    $manager = new SectionManager($pdo);
    $id = $manager->create(['title' => 'Новый', 'slug' => 'new']);
    $manager->update($id, ['sort_order' => 1]);
    $pdo->commit();
} catch (Exception $e) {
    $pdo->rollBack();
    // логирование ошибки
}

Результат: При успешной вставке возвращается ID, при ошибках выбрасываются исключения с понятными сообщениями.

Пример работы с AJAX для создания раздела с возвратом JSON

// PHP обработчик create_ajax.php
require 'SectionManager.php';
$pdo = new PDO(...);
$manager = new SectionManager($pdo);
header('Content-Type: application/json');
try {
    $id = $manager->create($_POST);
    echo json_encode(['success' => true, 'id' => $id, 'message' => 'Раздел создан']);
} catch (Exception $e) {
    http_response_code(400);
    echo json_encode(['success' => false, 'error' => $e->getMessage()]);
}

Пример ответа:

{"success":true,"id":15,"message":"Раздел создан"}

Безопасность: CSRF защита при формах

session_start();
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    if (!isset($_POST['csrf_token']) || $_POST['csrf_token'] !== $_SESSION['csrf_token']) {
        die('CSRF token mismatch');
    }
    // обработка формы
}
// Генерация токена в форме
$_SESSION['csrf_token'] = bin2hex(random_bytes(32));
// В форме: <input type="hidden" name="csrf_token" value="<?= $_SESSION['csrf_token'] ?>">

Результат: Защита от межсайтовой подделки запросов.

Типичные ошибки и их решения

Расширенный пример: импорт разделов из CSV

function importSectionsFromCSV(string $filename, SectionManager $manager): array {
    $result = ['imported' => 0, 'errors' => []];
    if (($handle = fopen($filename, 'r')) !== false) {
        $header = fgetcsv($handle);
        while (($row = fgetcsv($handle)) !== false) {
            $data = array_combine($header, $row);
            try {
                $manager->create($data);
                $result['imported']++;
            } catch (Exception $e) {
                $result['errors'][] = $e->getMessage();
            }
        }
        fclose($handle);
    }
    return $result;
}
// Использование
$result = importSectionsFromCSV('sections.csv', $manager);
echo "Импортировано: {$result['imported']}, ошибок: " . count($result['errors']);

Результат вывода:

Импортировано: 10, ошибок: 2

Поиск разделов по ключевому слову

public function search(string $query): array {
    $stmt = $this->pdo->prepare(
        'SELECT * FROM sections WHERE title LIKE :q OR description LIKE :q2 ORDER BY title'
    );
    $like = '%' . $query . '%';
    $stmt->bindValue(':q', $like, PDO::PARAM_STR);
    $stmt->bindValue(':q2', $like, PDO::PARAM_STR);
    $stmt->execute();
    return $stmt->fetchAll(PDO::FETCH_ASSOC);
}

Пример вызова: $manager->search('новости'); возвращает массив разделов, содержащих слово "новости".