Свои правила валидации в CodeIgniterот callback_ в контроллере до классов правил CI4
Встроенных правил Form Validation хватает до первого нестандартного условия. Показываем callback-правила второй и третьей версий, ловушку с HMVC и то, как то же самое пишется в CodeIgniter 4.
- Раздел
- CodeIgniter
- Стек
- PHPCodeIgniter 3CodeIgniter 4
- Уровень
- Средний
- Опубликовано
- Обновлено
- Чтение
- 8 мин
- В CI2/CI3 своё правило это метод контроллера и префикс callback_.
- Подчёркивание в имени метода закрывает его от вызова по URL.
- В HMVC передавайте контроллер модуля в run($this).
- В CI4 правила живут в классах из $ruleSets или в замыканиях.
- Опишите проверку методом, который возвращает true или false
- В CI3 подключите его как callback_ и задайте set_message()
- В CI4 вынесите метод в класс App\Validation
- Зарегистрируйте класс в Config\Validation::$ruleSets
- Берите данные из getValidated(), а не из всего POST
Когда встроенных правил мало#
Библиотека Form Validation в CodeIgniter закрывает типовые проверки одной строкой: required, valid_email, min_length[3], matches[password]. Но в любой живой форме быстро появляется условие, которого нет в списке: логин не должен совпадать со служебными именами, дата окончания должна быть позже даты начала, ИНН должен сойтись по контрольной сумме. Для таких случаев во второй и третьей версиях фреймворка был механизм callback_, а в CodeIgniter 4 его заменили собственными классами правил и замыканиями.
Ниже разбираем оба подхода на одном примере: проверяем, что логин свободен и не входит в список зарезервированных. Если вы ещё не устанавливали фреймворк, начните с раздела CodeIgniter, там собраны базовые заметки.
Callback-правило в CodeIgniter 2 и 3#
Правило с префиксом callback_ говорит библиотеке: вызови метод текущего контроллера с этим именем и передай ему значение поля. Метод возвращает TRUE или FALSE, а текст ошибки задаётся через set_message(), первым аргументом которого служит имя метода.
<?php
class Signup extends CI_Controller
{
public function index()
{
$this->load->library('form_validation');
$this->form_validation->set_rules(
'username',
'Логин',
'trim|required|min_length[3]|callback__username_free'
);
if ($this->form_validation->run() === FALSE) {
$this->load->view('signup');
return;
}
// данные прошли проверку
redirect('signup/done');
}
// подчёркивание в начале: метод нельзя открыть по URL
public function _username_free($username)
{
$reserved = array('admin', 'root', 'support');
if (in_array(strtolower($username), $reserved, TRUE)) {
$this->form_validation->set_message(
'_username_free',
'Поле {field} содержит зарезервированное имя.'
);
return FALSE;
}
return TRUE;
}
}Обратите внимание на двойное подчёркивание в callback__username_free. Публичный метод контроллера в CodeIgniter доступен по адресу вида /signup/username_free, и любой посетитель может дёрнуть проверку напрямую. Методы с подчёркиванием в начале роутер не вызывает, поэтому имя _username_free закрывает эту дыру, а к префиксу callback_ просто добавляется ещё одно подчёркивание.
Несколько деталей, на которых часто спотыкаются:
- Плейсхолдер в сообщении. В CodeIgniter 2 имя поля подставлялось через
%s, в третьей версии появился{field}, а старый%sоставили для совместимости. - Порядок правил. Правила выполняются слева направо, поэтому
trimстоит ставить до callback, иначе метод получит значение с пробелами. - Изменение значения. Если callback вернёт строку вместо булева значения, библиотека запишет её как новое значение поля. Это удобно для нормализации, но легко забыть и получить строку там, где ждали
TRUE. - Параметр в скобках. Запись
callback__check[users]передастusersвторым аргументом метода.
Проверка через модель и проблема с HMVC#
Держать логику обращения к базе в контроллере неудобно, проверка занятости логина естественно живёт в модели. В CodeIgniter 3 появились правила-вызовы: вместо строки передаётся массив из имени правила и любого callable, например метода модели. Имя нужно, чтобы привязать к нему сообщение.
<?php
// CodeIgniter 3: правило-вызов метода модели
$this->load->model('users_model');
$this->form_validation->set_rules('username', 'Логин', array(
'required',
array('username_free', array($this->users_model, 'is_username_free')),
));
$this->form_validation->set_message('username_free', 'Логин {field} уже занят.');В CodeIgniter 2 такой возможности не было, и модель вызывали из callback-метода контроллера. Хуже было тем, кто использовал модульное расширение HMVC: callback-методы из контроллеров модулей молча не находились, и правило всегда проходило. Причина в том, что библиотека ищет метод в объекте $this->CI, а это главный контроллер, а не контроллер модуля. Общепринятое решение: расширить библиотеку и передавать текущий контроллер в run().
<?php
// application/libraries/MY_Form_validation.php
class MY_Form_validation extends CI_Form_validation
{
public $CI;
}
// в контроллере модуля
if ($this->form_validation->run($this) === FALSE) {
// ...
}Сам запрос к базе пишите на подготовленных выражениях, подробнее об этом в заметке про PDO и prepared statements.
Свой класс правил в CodeIgniter 4#
В четвёртой версии префикса callback_ нет. Правило теперь обычный публичный метод любого класса, зарегистрированного в Config\Validation::$ruleSets. Метод получает значение поля и может через ссылку $error вернуть свой текст ошибки.
<?php
// app/Validation/UserRules.php
namespace App\Validation;
class UserRules
{
private const RESERVED = ['admin', 'root', 'support'];
public function not_reserved($value, ?string &$error = null): bool
{
if (! is_string($value)) {
return false;
}
if (in_array(mb_strtolower($value), self::RESERVED, true)) {
$error = 'Это имя зарезервировано.';
return false;
}
return true;
}
}Регистрируем класс рядом со встроенными наборами:
<?php
// app/Config/Validation.php (фрагмент)
public array $ruleSets = [
Rules::class,
FormatRules::class,
FileRules::class,
CreditCardRules::class,
\App\Validation\UserRules::class,
];В свежих установках вместо Rules и соседей подключены их строгие версии из пространства имён CodeIgniter\Validation\StrictRules, которые не приводят типы молча. Поэтому мы проверяем is_string() сами: строгий режим не гарантирует, что в поле придёт строка, а не массив. Если правилу нужен параметр, сигнатура расширяется до ($value, string $params, array $data, ?string &$error = null), где в $data лежат все поля формы, что удобно для сравнения двух дат.
У класса правил есть приятный побочный эффект: его легко тестировать отдельно от фреймворка. Метод не зависит от контроллера, запроса и сессии, поэтому проверка (new UserRules())->not_reserved('Admin') в обычном PHPUnit-тесте сразу покажет, учитывает ли правило регистр. С callback-методом контроллера в CodeIgniter 3 так не получалось: приходилось поднимать весь контроллер или выносить логику в хелпер. Ещё одно правило хорошего тона: держите в одном классе проверки одной предметной области (пользователи, заказы, адреса) и не смешивайте их, иначе через год класс превратится в свалку из сотни методов, а имена правил начнут конфликтовать между собой.
Замыкания и проверка в контроллере#
Для разовой проверки заводить класс необязательно: начиная с версии 4.3 правило можно передать замыканием прямо в массиве. Есть условие: правила поля тогда записываются массивом, а не строкой через вертикальную черту. Замыкание получает значение, все данные формы, ссылку на текст ошибки и имя поля.
<?php
// app/Controllers/Signup.php
namespace App\Controllers;
class Signup extends BaseController
{
public function create()
{
$rules = [
'username' => [
'label' => 'Логин',
'rules' => 'required|min_length[3]|not_reserved|is_unique[users.username]',
'errors' => [
'is_unique' => 'Логин {value} уже занят.',
],
],
'promo' => [
'label' => 'Промокод',
'rules' => [
'permit_empty',
static function ($value, $data, &$error, $field): bool {
if (preg_match('/^[A-Z0-9]{6}$/', (string) $value) === 1) {
return true;
}
$error = 'Промокод: 6 заглавных латинских букв или цифр.';
return false;
},
],
],
];
if (! $this->validateData($this->request->getPost(), $rules)) {
return view('signup', ['errors' => $this->validator->getErrors()]);
}
$clean = $this->validator->getValidated();
// сохраняем $clean, а не весь POST
return redirect()->to('/signup/done');
}
}Здесь работают сразу три механизма: встроенное is_unique закрывает проверку занятости логина без единой строки своего кода, наш not_reserved отсекает служебные имена, а замыкание проверяет формат промокода. Метод getValidated() возвращает только поля, для которых были правила, и это хорошая привычка: в модель не попадут лишние ключи из POST.
Что изменилось к 2026 году#
Сводка того, как один и тот же приём выглядит в разных поколениях фреймворка:
| Задача | CodeIgniter 2/3 | CodeIgniter 4 |
|---|---|---|
| Своё правило | Метод контроллера и callback_имя | Метод класса из $ruleSets |
| Разовая проверка | Тот же callback | Замыкание в массиве правил |
| Текст ошибки | set_message() | Ссылка $error, ключ errors или языковой файл |
| Проверка в модели | Callable-правило (только CI3) | Свойство модели $validationRules |
| Чистые данные | Повторное чтение $this->input->post() | getValidated() |
Ветки 2.x и 3.x давно не получают обновлений безопасности, поэтому новый код имеет смысл писать только на CodeIgniter 4 и актуальном PHP 8. При переносе старой формы не пытайтесь эмулировать callback_: соберите проверки в один класс правил по предметной области, так их проще покрыть тестами. Если валидация живёт в модели, правила из свойства $validationRules сработают на каждом insert() и save(), и контроллер станет тоньше.
Тексты ошибок своих правил удобно держать не в коде, а в языковом файле app/Language/ru/Validation.php: ключом служит имя правила, а плейсхолдеры {field}, {param} и {value} подставит сам фреймворк. Так сообщения переводятся вместе с остальным интерфейсом и не размазываются по контроллерам.
Про соседние темы миграции, в частности про ЧПУ с дефисами, читайте в заметке о дефисах в URL CodeIgniter, а общие рецепты для языка собраны в разделе PHP.
«Своё правило валидации это просто функция, которая отвечает да или нет; меняется только место, где она живёт.»
Главный вывод заметки


