Свои правила валидации в CodeIgniter

Свои правила валидации в CodeIgniterот callback_ в контроллере до классов правил CI4

Встроенных правил Form Validation хватает до первого нестандартного условия. Показываем callback-правила второй и третьей версий, ловушку с HMVC и то, как то же самое пишется в CodeIgniter 4.

Раздел
CodeIgniter
Стек
PHPCodeIgniter 3CodeIgniter 4
Уровень
Средний
Опубликовано
Обновлено
Чтение
8 мин
Коротко
  • В CI2/CI3 своё правило это метод контроллера и префикс callback_.
  • Подчёркивание в имени метода закрывает его от вызова по URL.
  • В HMVC передавайте контроллер модуля в run($this).
  • В CI4 правила живут в классах из $ruleSets или в замыканиях.
Как решаем
  1. Опишите проверку методом, который возвращает true или false
  2. В CI3 подключите его как callback_ и задайте set_message()
  3. В CI4 вынесите метод в класс App\Validation
  4. Зарегистрируйте класс в Config\Validation::$ruleSets
  5. Берите данные из 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
<?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
<?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
<?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
<?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
<?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
<?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/3CodeIgniter 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.

callback_префикс своего правила в CI2/CI3
$ruleSetsреестр классов правил в CI4
4.3версия CI4 с правилами-замыканиями

«Своё правило валидации это просто функция, которая отвечает да или нет; меняется только место, где она живёт.»

Главный вывод заметки

Вопросы и ответы

Вопросы и ответы

Почему мой callback не вызывается и правило всегда проходит?
Чаще всего метод не найден: опечатка в имени после callback_, метод объявлен не в том контроллере или вы используете HMVC, где библиотека ищет метод в главном контроллере. Для HMVC расширьте библиотеку публичным свойством $CI и вызывайте run($this).
Зачем два подчёркивания в callback__имя?
Первое подчёркивание часть префикса callback_, второе начало имени метода. Методы контроллера, имя которых начинается с подчёркивания, роутер CodeIgniter не открывает по URL, поэтому проверку нельзя вызвать напрямую из браузера.
Как в CodeIgniter 4 сравнить два поля формы в своём правиле?
Используйте расширенную сигнатуру метода: значение поля, строка параметров, массив всех данных формы и ссылка на текст ошибки. В массиве data лежат остальные поля, и правило вроде after_date[start] сможет сравнить даты.
Где лучше хранить правила: в контроллере или в модели?
Правила, которые защищают целостность данных, удобнее держать в модели через $validationRules: они сработают при любом сохранении. Правила, относящиеся только к конкретной форме, например подтверждение пароля, оставляйте в контроллере.
Заметка обновлена 12 ноября 2026: код проверен на актуальных версиях, добавлены современные варианты.

Читайте также