v4.6.0.rst

Version 4.6.0

Release Date: Unreleased

4.6.0 release of CodeIgniter4

• Highlights
• BREAKING
  • Behavior Changes
    • Exceptions
  • Interface Changes
  • Method Signature Changes
  • Removed Deprecated Items
• Enhancements
  • Exceptions
  • Commands
  • Testing
  • Database
    • Query Builder
    • Forge
    • Others
  • Model
  • Libraries
  • Helpers and Functions
  • Others
• Message Changes
• Changes
  • Exceptions
• Deprecations
• Bugs Fixed

Highlights

• TBD

BREAKING

Behavior Changes

Exceptions

The exception class has been redesigned. See :ref:`exception-design` for details. The following breaking changes have been made accordingly:

• Validation::setRule() now throws CodeIgniter\Exceptions\InvalidArgumentException instead of TypeError.
• CriticalError now extends CodeIgniter\Exceptions\RuntimeException instead of Error.
• DatabaseException now extends CodeIgniter\Exceptions\RuntimeException instead of Error.
• ConfigException now extends CodeIgniter\Exceptions\RuntimeException instead of CodeIgniter\Exceptions\CriticalError.
• TestException now extends CodeIgniter\Exceptions\LogicException instead of CodeIgniter\Exceptions\CriticalError.

Interface Changes

Method Signature Changes

Removed Deprecated Items

• API: The deprecated failValidationError() method in CodeIgniter\API\ResponseTrait has been removed. Use failValidationErrors() instead.
• HTTP: The deprecated getReason() method in CodeIgniter\HTTP\Response and ResponseInterface has been removed. Use getReasonPhrase() instead.
• Logger: The deprecated CodeIgniter\Log\Logger::cleanFilenames() and CodeIgniter\Test\TestLogger::cleanup() have been removed. Use the clean_path() function instead.

Enhancements

Exceptions

The exception class has been redesigned. See :ref:`exception-design` for details. The following new Exception classes have been added accordingly:

• CodeIgniter\Exceptions\LogicException
• CodeIgniter\Exceptions\RuntimeException
• CodeIgniter\Exceptions\BadFunctionCallException
• CodeIgniter\Exceptions\BadMethodCallException
• CodeIgniter\Exceptions\InvalidArgumentException

The following new Exception interfaces have been added:

• CodeIgniter\Files\Exceptions\ExceptionInterface
• CodeIgniter\HTTP\Exceptions\ExceptionInterface
• CodeIgniter\Router\Exceptions\ExceptionInterface

Commands

Testing

Database

Query Builder

Forge

Others

Model

Libraries

• Added retainMultiplePatterns() to FileCollection class. See :ref:`FileCollection::retainMultiplePatterns() <file-collections-retain-multiple-patterns>`.

Helpers and Functions

Others

Message Changes

Changes

Exceptions

The exception classes have been redesigned. See :ref:`exception-design` for details. The following changes have been made accordingly:

• The deleteMatching() method in Cache Handler classes now throws CodeIgniter\Exceptions\BadMethodCallException instead of Exception.
• Cache\ResponseCache::get() now throws CodeIgniter\Exceptions\RuntimeException instead of Exception.
• Classes that threw RuntimeException have been changed to throw CodeIgniter\Exceptions\RuntimeException.
• Classes that threw InvalidArgumentException have been changed to throw CodeIgniter\Exceptions\InvalidArgumentException.
• Classes that threw LogicException have been changed to throw CodeIgniter\Exceptions\LogicException.
• Classes that threw BadMethodCallException have been changed to throw CodeIgniter\Exceptions\BadMethodCallException.
• Classes that threw BadFunctionCallException have been changed to throw CodeIgniter\Exceptions\BadFunctionCallException.
• RedirectException now extends CodeIgniter\Exceptions\RuntimeException instead of Exception.
• PageNotFoundException now extends CodeIgniter\Exceptions\RuntimeException instead of OutOfBoundsException.

Deprecations

Bugs Fixed

See the repo's CHANGELOG.md for a complete list of bugs fixed.