Yii2 — это мощный PHP-фреймворк, который позволяет быстро разрабатывать веб-приложения. Если вы хотите создать собственный блог с возможностью комментирования, Yii2 предоставляет все необходимые инструменты: от генерации кода (Gii) до готовых решений для аутентификации и валидации. В этой статье мы шаг за шагом построим блог с системой комментариев, разберём типичные ошибки и дадим практические советы.

Digital-студия WNDER

Подготовка окружения и установка Yii2

Прежде чем писать код, убедитесь, что у вас установлены PHP (версия 7.4 или выше), Composer и веб-сервер (Apache или Nginx). Для локальной разработки удобно использовать OpenServer или Docker. Установим базовый шаблон Yii2 через Composer:

composer create-project --prefer-dist yiisoft/yii2-app-basic blog

После установки настройте подключение к базе данных в файле config/db.php. Создайте базу данных и выполните миграции:

./yii migrate

Теперь у вас есть рабочее приложение Yii2. Можно приступать к созданию моделей и контроллеров.

Создание моделей Post и Comment

Для блога нам понадобятся две модели: Post (статьи) и Comment (комментарии). Воспользуемся генератором Gii, который доступен по адресу http://ваш-сайт/index.php?r=gii. Но можно создать модели вручную. Рассмотрим пример модели Post:

<?php
namespace app\models;

use yii\db\ActiveRecord;

class Post extends ActiveRecord
{
    public static function tableName()
    {
        return 'post';
    }

    public function rules()
    {
        return [
            [['title', 'content'], 'required'],
            [['title'], 'string', 'max' => 255],
            [['content'], 'string'],
        ];
    }

    public function getComments()
    {
        return $this->hasMany(Comment::class, ['post_id' => 'id']);
    }
}

Аналогично создайте модель Comment с полями post_id, author, content и связью с Post. Не забудьте создать соответствующие таблицы в базе данных через миграции или вручную.

Реализация контроллеров и представлений

Создайте контроллер PostController с действиями для просмотра списка статей и отдельной статьи с комментариями. Пример действия для просмотра поста:

public function actionView($id)
{
    $post = Post::findOne($id);
    if (!$post) {
        throw new NotFoundHttpException('Статья не найдена.');
    }
    $comment = new Comment();
    if ($comment->load(Yii::$app->request->post()) && $comment->validate()) {
        $comment->post_id = $post->id;
        $comment->save();
        Yii::$app->session->setFlash('success', 'Комментарий добавлен.');
        return $this->refresh();
    }
    return $this->render('view', [
        'post' => $post,
        'comment' => $comment,
    ]);
}

В представлении view.php выведите статью и форму для добавления комментария, а также список существующих комментариев. Используйте виджет ActiveForm для генерации формы.

<?php use yii\widgets\ActiveForm; ?>
<h1><?= $post->title ?></h1>
<div><?= $post->content ?></div>

<h3>Комментарии</h3>
<?php foreach ($post->comments as $comment): ?>
    <div>
        <strong><?= $comment->author ?></strong>: <?= $comment->content ?>
    </div>
<?php endforeach; ?>

<?php $form = ActiveForm::begin(); ?>
<?= $form->field($comment, 'author')->textInput() ?>
<?= $form->field($comment, 'content')->textarea() ?>
<button type="submit">Отправить</button>
<?php ActiveForm::end(); ?>

Не забудьте добавить валидацию и фильтрацию данных для безопасности.

Добавление системы комментариев с ответами

Чтобы комментарии были удобными, добавим возможность отвечать на них. Для этого в таблицу comment добавьте поле parent_id (по умолчанию NULL). Тогда в модели Comment появится связь:

public function getParent()
{
    return $this->hasOne(Comment::class, ['id' => 'parent_id']);
}

public function getChildren()
{
    return $this->hasMany(Comment::class, ['parent_id' => 'id']);
}

В представлении можно рекурсивно выводить комментарии и их ответы. Например, создайте отдельный вид _comment.php и подключайте его рекурсивно.

<div style="margin-left: 20px;">
    <strong><?= $model->author ?></strong>: <?= $model->content ?>
    <?php foreach ($model->children as $child): ?>
        <?= $this->render('_comment', ['model' => $child]) ?>
    <?php endforeach; ?>
</div>

Такой подход позволяет строить древовидные комментарии любой глубины.

Правило: Всегда экранируйте пользовательский ввод в представлениях с помощью Html::encode(), чтобы избежать XSS-атак. Например, выводите комментарии так: <?= Html::encode($comment->content) ?>.

Практические советы и лайфхаки

Вот несколько рекомендаций, которые сэкономят вам время и нервы:

  • Используйте Gii для генерации CRUD-операций — это ускорит разработку в разы.
  • Для защиты от спама добавьте капчу (например, через расширение yii2-captcha).
  • Кешируйте список комментариев, если блог популярен.
  • Настройте ЧПУ (человекопонятные URL) с помощью компонента urlManager.

Сравним основные параметры моделей Post и Comment в таблице:

Поле Тип Модель Описание
id integer Post, Comment Первичный ключ
title string Post Заголовок статьи
content text Post, Comment Текст статьи или комментария
author string Comment Имя автора комментария
post_id integer Comment Ссылка на статью
parent_id integer Comment Ссылка на родительский комментарий

Заключение

Мы рассмотрели основные шаги по созданию блога на Yii2 с системой комментариев: от установки фреймворка до реализации древовидных ответов. Yii2 предоставляет гибкие инструменты для быстрой разработки, а следование правилам безопасности и использование практических советов поможет избежать распространённых ошибок. Теперь вы можете расширять функционал: добавлять категории, теги, модерацию комментариев и многое другое. Удачи в разработке!

Студия WNDER