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