Upgrading from 4.2.10 to 4.2.11

Please refer to the upgrade instructions corresponding to your installation method.

Breaking Changes

Config\App::$proxyIPs

The config value format has been changed. Now you must set your proxy IP address and the HTTP header name for the client IP address pair as an array:

public $proxyIPs = [
        '10.0.1.200'     => 'X-Forwarded-For',
        '192.168.5.0/24' => 'X-Forwarded-For',
];

ConfigException will be thrown for old format config value.

Session Handler Key Changes

The key of the session data record for DatabaseHandler Driver, MemcachedHandler Driver and RedisHandler Driver has changed. Therefore, any existing session data will be invalidated after the upgrade if you are using these session handlers.

  • When using DatabaseHandler, the id column value in the session table now contains the session cookie name (Config\App::$sessionCookieName).

  • When using MemcachedHandler or RedisHandler, the key value contains the session cookie name (Config\App::$sessionCookieName).

There is maximum length for the id column and Memcached key (250 bytes). If the following values exceed those maximum length, the session will not work properly.

  • the session cookie name, delimiter, and session id (32 characters by default) when using DatabaseHandler

  • the prefix (ci_session), session cookie name, delimiters, and session id when using MemcachedHandler

Project Files

Version 4.2.11 did not alter any executable code in project files.

All Changes

This is a list of all files in the project space that received changes; many will be simple comments or formatting that have no effect on the runtime:

  • app/Config/App.php

  • app/Config/Autoload.php

  • app/Config/Logger.php

  • app/Config/Toolbar.php

  • app/Views/welcome_message.php

  • composer.json

  • phpunit.xml.dist