Псевдонимы записей в Yii2. Создание и управление

Настройка ЧПУ – неотъемлемый атрибут работы по SEO-оптимизации любого сайта. Формировать URL только по id записи – не лучший вариант.

В данном уроке мы добавим псевдонимы записей (слаг/алиас) для постов блога.

Суть такова. В форме (создания, редактирования) поста есть текстовове поле, в которое мы можем прописать свой собственный slug и при этом оно должно валидироваться. Если мы оставим поле пустым, то Yii2 сам сделает эту работу методом Inflector::slug(), куда мы передадим название поста (то есть, по умолчанию слаг будет транслитом названия поста). В базе данных поле slug обязательно для заполнения (NOT NULL) и является уникальным.

Добавим в базу данных поле slug (если его не было изначально). Пример добавления поля через миграцию:

// Из консоли
php yii migrate/create add_post_field_slug

В созданной миграции:

public function safeUp()
{
$this->addColumn('{{%post}}', 'slug', $this->string(255)->notNull()->after('status')->unique());
$this->createIndex('{{%idx-post-slug}}', '{{%post}}', 'slug', true);
}
public function safeDown()
{
$this->dropColumn('{{%post}}', 'slug');
}

В форме (backend\views\post\_form.php) добавим поле:

<?= $form->field($model, 'slug')->textInput(['maxlength' => true]) ?>

В модель Post добавляем следующий код:

private $_post;
public function rules()
{
return [
[['name'], 'required'], // На стороне клиента "slug" необязательный
[['name', 'slug'], 'string', 'max' => 255], // "slug" - ограниченная строка
['slug', SlugValidator::class], // "slug" валидируется классом SlugValidator
// "name" и "slug" - уникальны (фильтр по ID поста при редактировании)
[['name', 'slug'], 'unique', 'targetClass' => Post::class, 'filter' => $this->_post ? ['<>', 'id', $this->_post->id] : null]
];
}

Класс SlugValidator:

<?php
namespace common\models\validators;
use yii\validators\RegularExpressionValidator;
class SlugValidator extends RegularExpressionValidator
{
public $pattern = '#^[a-z0-9_-]*$#s';
public $message = 'Only [a-z0-9_-] symbols are allowed.';
}

Контроллер backend\controllers\PostController.php:

public function actionCreate()
{
$model = new Post();
if ($model->load(Yii::$app->request->post())) {
$model->slug = $model->slug ?: Inflector::slug($model->name);
if($model->save()) {
return $this->redirect(['view', 'id' => $model->id]);
}
}
return $this->render('create', [
'model' => $model,
]);
}

Обновление записи происходит аналогично. В метод actionUpdate($id) необходимо тоже добавить:

$model->slug = $model->slug ?: Inflector::slug($model->name);

Теперь ссылка на пост во фронтенде будет выглядеть так:

<a href="<?= Url::to(['/blog/post/view', 'slug' => $model->slug]) ?>"><?= Html::encode($model->name) ?></a>
// Или
<?
$name = Html::encode($model->name);
$url = Url::to(['/blog/post/view', 'slug' => $model->slug]);
$options = [
'title' => $name
];
echo Html::a($name, $url, $options);
?>

Метод, в котором получаем отдельный пост:

public function actionView($slug)
{
// Получаем пост по его слагу
if (!$post = Post::find()->where(['slug' => $slug])->one()) {
throw new NotFoundHttpException('Page not found!');
}
return $this->render('view', [
'post' => $post
]);
}

Правило в urlManager:

[
'pattern' => 'blog/post/<slug:[\w-]+>',
'route' => 'blog/post/view',
'suffix' => '.html'
]

Теперь посты открываются по красивым адресам по типу:

http://site.ru/blog/post/primer-slaga.html

В прочем, если бы мы заострили на это внимание и оптимизировали бы каждую страницу тщательно, то было бы лучше прописать его самостоятельно. Например так:

http://site.ru/blog/post/slug-example.html

Это был, наверное, самый простой способ сделать слаги (алиасы, псевдонимы) у постов на фреймворке Yii2. Есть, конечно, готовые решения, типа SluggableBehavior. Это поведение, которое будет производить всю валидацию и транслитерацию за вас. В примере, который я описал выше есть возможность управлять всем этим делом. Фишка заключается в том, что по большому счёту никакой автоматической генерации в принципе не нужно. В большинстве случаев имеет бОльший смысл прописать его самостоятельно. Ну, а если вам вдруг стало просто лень, то пусть себе транслитерирует и сохраняет в базу транслит. Это уже будет ЧПУ.

Источник: Перейти