CodeIgniter 3 на CodeIgniter 4

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.
Как решаем
  1. Создать проект CI4 через Composer рядом со старым
  2. Перенести маршруты в app/Config/Routes.php явно
  3. Переписать хуки авторизации в фильтры
  4. Перевести контроллеры на BaseController и неймспейсы
  5. Сменить вызовы сессии и проверить параллельные 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
<?php
// CI3: application/config/routes.php
$route['default_controller'] = 'home';
$route['translate_uri_dashes'] = TRUE;
$route['blog/(:num)'] = 'blog/show/$1';
PHP
<?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
<?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
<?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 его нет, вместо него обычное наследование и сервисы:

CI3CI4
MY_ControllerApp\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
<?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 году#

Чек-лист, с которым мы переносим проекты сейчас:

  1. Сначала тесты на ключевые страницы старого сайта, хотя бы проверка кода ответа и заголовка.
  2. $this->input->post() меняется на $this->request->getPost(), $this->load->view() на return view().
  3. Конфиги переезжают из массивов в классы app/Config/*.php, секреты в .env.
  4. Защиту CSRF и экранирование вывода через esc() включайте с первого дня.

Если проект совсем маленький, сравните миграцию с альтернативой: иногда проще оставить десяток маршрутов на лёгком роутере, вроде того, что мы собирали в заметке про роутер на 40 строк. Остальное по фреймворку в разделе CodeIgniter.

3.1.13последний релиз CodeIgniter 3
app/вместо application/ в CI4
PSR-4автозагрузка с неймспейсами

«Миграция с CI3 на CI4 это перенос логики в новый каркас, а не замена версии в composer.json.»

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

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

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

Можно ли обновить CodeIgniter 3 до 4 через Composer?
Нет. CodeIgniter 4 переписан с нуля, у него другая структура каталогов, неймспейсы и API. Создаётся новый проект CI4, и код контроллеров, моделей и представлений переносится в него вручную по официальному руководству.
Куда переносить хуки из CI3?
Логику, привязанную к HTTP-запросу (авторизация, заголовки, редиректы), переносите в фильтры с методами before и after. Реакции на события приложения, не связанные с маршрутом, удобнее оформить через Events.
Нужен ли аналог MY_Controller в CI4?
Да, его роль играет BaseController, который создаётся при установке проекта. В нём держат общие хелперы, загрузку данных для шаблона и вспомогательные методы. Ваши контроллеры просто наследуют его.
Работают ли старые сессии пользователей после переезда?
Обычно нет: формат и имена cookie у CI4 другие, поэтому при переключении пользователи будут разлогинены. Планируйте переключение на время с низкой нагрузкой и предупредите об этом поддержку.
Заметка обновлена 12 ноября 2026: код проверен на актуальных версиях, добавлены современные варианты.

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