CodeIgniter 3 на CodeIgniter 4маршруты, сессии, фильтры и судьба MY_-классов
CodeIgniter 4 не обновление, а другой фреймворк с тем же духом. Переносить проект приходится по частям, и важно понимать, что куда переехало.
- Раздел
- CodeIgniter
- Стек
- PHP 8.3CodeIgniter 4Composer
- Уровень
- Средний
- Опубликовано
- Обновлено
- Чтение
- 8 мин
- Обновления «на месте» нет: создаётся новый проект CI4, код переносится в него.
- Маршруты объявляются явно, автороутинг по умолчанию выключен.
- Хуки pre_controller и post_controller заменяют фильтры.
- MY_Controller становится BaseController, MY_Model заменяет CodeIgniter\Model.
- Создать проект CI4 через Composer рядом со старым
- Перенести маршруты в app/Config/Routes.php явно
- Переписать хуки авторизации в фильтры
- Перевести контроллеры на BaseController и неймспейсы
- Сменить вызовы сессии и проверить параллельные AJAX
Почему это не апгрейд, а переезд#
CodeIgniter 3 остановился на версии 3.1.13, и для проектов на современном PHP он становится проблемой: устаревшие конструкции, отсутствие неймспейсов, библиотеки, которые никто не правит. CodeIgniter 4 переписан с нуля: неймспейсы и PSR-4, Composer, объекты запроса и ответа, встроенный CLI spark.
Официальное руководство по обновлению прямо говорит, что инструмента автоматической миграции нет. Рабочая схема: поставить свежий проект CI4 через composer create-project codeigniter4/appstarter, положить его рядом и переносить модули по одному, начиная с самых простых страниц. Требования к PHP у CI4 растут с каждой минорной версией, поэтому для новых установок ориентируйтесь на PHP 8.3 и выше.
Стратегически есть два пути. Первый: полный перенос на отдельной ветке и одно переключение. Он подходит для небольших проектов на десяток контроллеров. Второй: оба приложения работают параллельно, а веб-сервер направляет часть адресов в CI4, часть оставляет на CI3. Так можно переносить раздел за разделом, но придётся решить вопрос общей сессии и общего шаблона, поэтому для среднего проекта чаще выбирают первый путь с хорошим набором тестов.
Маршруты: от массива $route к Routes.php#
В CI3 маршруты описывались массивом, а всё, чего в нём не было, разрешалось автоматически по URL. В CI4 автороутинг по умолчанию выключен, и это хорошо: каждый адрес объявлен явно, с HTTP-методом.
<?php
// CI3: application/config/routes.php
$route['default_controller'] = 'home';
$route['translate_uri_dashes'] = TRUE;
$route['blog/(:num)'] = 'blog/show/$1';<?php
// CI4: app/Config/Routes.php
use CodeIgniter\Router\RouteCollection;
/** @var RouteCollection $routes */
$routes->get('/', 'Home::index');
$routes->get('blog/(:num)', 'Blog::show/$1');
$routes->group('admin', ['filter' => 'auth'], static function ($routes) {
$routes->get('posts', 'Admin\Posts::index');
$routes->post('posts', 'Admin\Posts::create');
});Если у вас были адреса с дефисами, их перенос мы разбирали в заметке про URL с дефисами в CodeIgniter: в CI4 за это отвечает $routes->setTranslateURIDashes(true). Если без автороутинга не обойтись, включайте улучшенный режим (Auto Routing Improved): там методы контроллера получают префикс HTTP-метода, например getIndex(), и случайно открыть служебный метод снаружи уже нельзя.
Список всех маршрутов вместе с назначенными фильтрами выводит команда php spark routes. Мы запускаем её после каждого перенесённого раздела и сверяем с логом посещаемых адресов старого сайта: так видно, какой URL забыли объявить, ещё до того, как это заметят пользователи и поисковые роботы.
Хуки уходят, приходят фильтры#
В CI3 проверку авторизации или заголовки ответа часто вешали на хуки pre_controller и post_controller. В CI4 для этого есть фильтры: класс с методами before() и after(), который подключается к маршруту, группе маршрутов или глобально.
<?php
// app/Filters/AuthFilter.php
namespace App\Filters;
use CodeIgniter\Filters\FilterInterface;
use CodeIgniter\HTTP\RequestInterface;
use CodeIgniter\HTTP\ResponseInterface;
class AuthFilter implements FilterInterface
{
public function before(RequestInterface $request, $arguments = null)
{
if (! session()->get('user_id')) {
return redirect()->to('/login');
}
}
public function after(RequestInterface $request, ResponseInterface $response, $arguments = null)
{
// ничего
}
}
// app/Config/Filters.php, массив $aliases:
// 'auth' => \App\Filters\AuthFilter::class,Если before() возвращает объект ответа, запрос до контроллера не доходит. Это удобнее хуков: фильтр видно прямо в описании маршрута. Для событий, не привязанных к запросу (например, «после сохранения пользователя»), в CI4 есть отдельный механизм Events.
Глобальные фильтры, например CSRF или принудительный HTTPS, включаются в массиве $globals того же файла app/Config/Filters.php, а фильтры по методу запроса в массиве $methods. Хорошая привычка: держать в before() только проверку и редирект, а тяжёлую логику выносить в сервисы, чтобы фильтр было легко протестировать.
Сессии: новый API и старые грабли#
Библиотека сессий сохранила драйверы (файлы, база данных, Redis, Memcached), но методы переименованы:
<?php
// CI3
$this->load->library('session');
$this->session->set_userdata('user_id', 42);
$id = $this->session->userdata('user_id');
$this->session->set_flashdata('notice', 'Сохранено');
// CI4
$session = session();
$session->set('user_id', 42);
$id = $session->get('user_id');
$session->setFlashdata('notice', 'Сохранено');Важная деталь касается параллельных запросов. Файловый и Redis-драйверы блокируют сессию на время запроса, и десяток одновременных AJAX-вызовов выстраивается в очередь. Мы описывали похожую проблему эпохи CI2 в заметке про баг сессий при AJAX. Практическое правило для CI4: если запрос только читает сессию, вызывайте session_write_close() как можно раньше, чтобы снять блокировку, и не храните в сессии ничего, что меняется в каждом запросе.
Что делать с MY_-классами#
Префикс MY_ в CI3 был способом расширить ядро. В CI4 его нет, вместо него обычное наследование и сервисы:
| CI3 | CI4 |
|---|---|
MY_Controller | App\Controllers\BaseController |
MY_Model на Query Builder | наследник CodeIgniter\Model с $table и $allowedFields |
MY_Router, MY_Input | свой класс и подмена в app/Config/Services.php |
MY_Form_validation | собственные правила в app/Config/Validation.php |
<?php
// CI3: application/core/MY_Controller.php
class MY_Controller extends CI_Controller { /* общая логика */ }
// CI4: app/Controllers/BaseController.php (создан при установке)
namespace App\Controllers;
use CodeIgniter\Controller;
abstract class BaseController extends Controller
{
protected $helpers = ['url', 'form'];
protected function render(string $view, array $data = []): string
{
return view('layout/header', $data)
. view($view, $data)
. view('layout/footer', $data);
}
}Подмену системных классов через Services используйте только когда по-другому нельзя: при обновлении фреймворка такие места надо перепроверять в первую очередь. Чаще достаточно фильтра или хелпера.
Модели в CI4 стали заметно умнее, чем типичный MY_Model из CI3: из коробки есть валидация по правилам, мягкое удаление через $useSoftDeletes, автоматические метки времени и сущности (Entity) для работы с записью как с объектом. Часть самописного кода из старого базового класса после переезда можно просто удалить, но сверяйте поведение: например, именование полей с датами по умолчанию может отличаться от вашего.
Что изменилось к 2026 году#
Чек-лист, с которым мы переносим проекты сейчас:
- Сначала тесты на ключевые страницы старого сайта, хотя бы проверка кода ответа и заголовка.
$this->input->post()меняется на$this->request->getPost(),$this->load->view()наreturn view().- Конфиги переезжают из массивов в классы
app/Config/*.php, секреты в.env. - Защиту CSRF и экранирование вывода через
esc()включайте с первого дня.
Если проект совсем маленький, сравните миграцию с альтернативой: иногда проще оставить десяток маршрутов на лёгком роутере, вроде того, что мы собирали в заметке про роутер на 40 строк. Остальное по фреймворку в разделе CodeIgniter.
«Миграция с CI3 на CI4 это перенос логики в новый каркас, а не замена версии в composer.json.»
Главный вывод заметки


