CHANGELOG.md

### 12.2.0 <small>(2026-04-02)</small>

#### New

* Added new `SortDirection` enum for use with the query builder "order" methods.
* Added the following methods to the query builder:
	- `Query::orderByNullsFirst()`
	- `Query::orderByNullsLast()`
	- `Query::ascendingNullsFirst()`
	- `Query::descendingNullsFirst()`
	- `Query::ascendingNullsLast()`
	- `Query::descendingNullsLast()`
* Added the following filter methods to the class finder:
	- `ClassFinder::implementing()`
	- `ClassFinder::extending()`
	- `ClassFinder::using()`
	- `ClassFinder::with()`
* Added `ClassFinder::findWith()` method to to enable finding classes using a certain attribute.
* Added `unique_values` validation rule.

#### Deprecations

* Passing the string values `ASC` and `DESC` to the `$order` parameter of these methods is deprecated in favor of the `SortDirection` enum:
	- `Query::orderBy()`
	- `Query::orderByRaw()`
	- `Query::orderByVectorDistance()`
* All enum cases have been converted from `UPPER_SNAKE_CASE` to `PascalCase`. A compatibility layer is available until Mako 13.

--------------------------------------------------------

### 12.0.3, 12.1.1 <small>(2026-03-01)</small>

#### Bugfixes

* Fixed an error in the 429 error template.

--------------------------------------------------------

### 12.1.0 <small>(2026-02-20)</small>

#### New

* Added vector query support to the query builder for the following databases:
	- `MariaDB`
	- `MySQL`
	- `Postgres`
* Now possible to define custom input/output value objects for the query builder.
* Added a `EventStream` response sender to simplify sending [sever-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events).
* Permission calculations now fully support special bits (sticky, setgid and setuid).
* Added the following methods to the `Permissions` class:
	- `add`
	- `remove`

#### Deprecations

* Deprecated the following methods in the `ControllerHelperTrait` trait:
	- `fileResponse` - Create and return `mako\http\response\senders\File` instance instead
	- `streamResponse` - Create and return a `mako\http\response\senders\Stream` instance instead
	- `jsonResponse` - Create and return a `mako\http\response\builders\JSON` instance instead

--------------------------------------------------------

### 11.4.6, 12.0.2 <small>(2026-01-08)</small>

#### Bugfixes

* Eager loading of `BelongsTo` relations could lead to unnecessary queries.

--------------------------------------------------------

### 11.4.5, 12.0.1 <small>(2026-01-08)</small>

#### Bugfixes

* Fixed deprecation warning if foreign key value is null during eager loading of `BelongsTo` relations.

--------------------------------------------------------

### 12.0.0 <small>(2026-01-05)</small>

The major version bump is due to upping the required PHP version from `8.4` to `8.5` and a several breaking changes. Most applications built using Mako `11` should run on Mako `12` with just a few simple adjustments.

#### New

* Added `auto-restart` option to the `app:server` command that enables automatic restart of the development server in the event of a fatal error.
* It is now possible to send custom INI entries to the development server to configure PHP.
* Made improvements to the development error handlers:
	- Several UI improvements.
	- Added syntax highlighting to code.
	- The development handlers may provide hints and suggestions to help resolve certain types of errors.
* Made improvements to the production error handlers:
	- The 429 (too many requests) view will now tell the user when they can retry if a "retryAfter" date is provided.
* Added support for "partitioned" cookies aka "CHIPS".
* New and vastly improved image processing library (`pixel`) that replaces the the old `pixl` library.
* Added CLI frame output component.
* Added CLI notification output component for sending desktop notifications.
* Added a `SimpleCache` (`PSR-16`) implementation to the framework core.
* Added the following methods introduced in Redis 8.0.0:
	- `Redis::hGetDel()`
	- `Redis::hGetEx()`
	- `Redis::hSetEx()`
	- `Redis::xAckDel()`
	- `Redis::xDelEx()`
	- `Redis::vAdd()`
	- `Redis::vCard()`
	- `Redis::vDim()`
	- `Redis::vEmb()`
	- `Redis::vGetAttr()`
	- `Redis::vInfo()`
	- `Redis::vIsMember()`
	- `Redis::vLinks()`
	- `Redis::vRandMember()`
	- `Redis::vRem()`
	- `Redis::vSetAttr()`
	- `Redis::vSim()`
* Added new validation rules:
	- `exact_count`
	- `max_count`
	- `min_count`
* Added `InjectCache` attribute.
* Added `InjectSimpleCache`attribute.
* Added `InjectCrypto`attribute.
* The `mako\env` function can now cast env variable values to boolean, int, float, object and array types.

#### Changes

* Made some changes to the `InjectorInterface`.
* Removed the deprecated `WinCache` cache store.
* Removed the deprecated `Cursor::beginningOfLine()` method.
* Removed the deprecated `CryptoManager::getEncrypter()` method.
* Removed the deprecated `CommandHelperTrait::progressBar()` method.
* Removed the deprecated `CommandHelperTrait::question()` method.
* Removed the deprecated `CommandInterface` methods:
	- `CommandInterface::getCommand()`
	- `CommandInterface::getDescription()`
	- `CommandInterface::getArguments()`
* The default date output format for the ORM has been changed to `ISO-8601`.
* Renamed the `mako\cli\input\helpers` namespace to `mako\cli\input\components`.
* Removed the old `pixl` image processing library (replaced by the new `pixel` library).
* Changed how "literal" CLI output formatting tags are defined (\\\<tag> → \<literal:tag>).
* Changed the function signature of the `mako\env` function.
* Simplified syntax for registering middleware and constraint parameters in route groups.

#### Deprecations

* Deprecated the following Redis methods:
	- `Redis::ftConfigGet()`
	- `Redis::ftConfigSet()`
	- `Redis::ftTagVals()`

#### Improvements

* Various improvements and optimizations.

> Check out the upgrade guide for details on how to upgrade from `11.0.*.`

--------------------------------------------------------

### 11.4.4 <small>(2025-09-19)</small>

#### Changes

* Prevent unnecessary warnings from PHPStan.

--------------------------------------------------------

### 11.4.3 <small>(2025-09-16)</small>

#### Changes

* Moved ingress prefix logic to the router.

--------------------------------------------------------

### 11.4.2 <small>(2025-09-16)</small>

#### New

* The request class can now strip a configurable ingress prefix from the request path.

--------------------------------------------------------

### 11.3.1, 11.4.1 <small>(2025-09-01)</small>

#### Bugfixes

* Fixed issue with deleting records using an ORM object with the `SensitiveStringTrait` trait.

--------------------------------------------------------

### 11.4.0 <small>(2025-08-30)</small>

#### New

* The container can now resolve parameters with the help of custom injector attributes. The following attributes are included by default:
	- `InjectConnection` which allows you to inject a specific database connection.
	- `InjectConnection` which allows you to inject a specific Redis connection.
	- `InjectConfig` which allows you to inject a config value.
	- `InjectEnv` which allows you to inject a environment variable value.
* Added `disableAfterSunset` option to the `Deprecated` middleware.

#### Changes

* Increased the default PBKDF2 key derivation iteration count in the OpenSSL encrypter to improve security. The default can be overridden using the `key_derivation_iterations` configuration parameter.

#### Compatibility

* PHP 8.5 compatibility.

#### Deprecations

* Deprecated the `CryptoManager::getEncrypter()` method. Use the `CryptoManager::getInstance()` or `CryptoManager::getCrypto()` methods instead.

> All deprecated features will be removed in Mako 12.0.

--------------------------------------------------------

### 11.3.0 <small>(2025-07-28)</small>

#### New

* Added "insert and return" functionality to the query builder. The feature is currently supported by the `Firebird`, `MariaDB`, `PostgreSQL`, `SQLite` and `SQL Server` compilers.
	- `Query::insertAndReturn()`
	- `Query::insertMultipleAndReturn()`
* Added `SensitiveString` type to the database library. It can be used to encapsulate sensitive strings to prevent them from being logged in query logs.

#### Changes

* `MariaDB` now has its own connection and query compiler classes that extend the `MySQL` classes. Use the `mariadb:` prefix in your connection dsn instead of `mysql:` to take full advantage of the `MariaDB` features.
* The `ResultSet::getPagination()` return type is now nullable.

--------------------------------------------------------
### 11.2.1 <small>(2025-05-26)</small>

#### Improvements

* All the query builder aggregate methods now also allow a `Raw` instance in addition to a column name.
* The `Query::aggregate()` method is now public.

--------------------------------------------------------

### 11.2.0 <small>(2025-03-24)</small>

#### New

* The class finder can now find enums.
* Added a CLI output component that makes it easy to print a set of aligned labels and values.
* Reactor CLI commands can now prompt for missing arguments if they use the `PromptForMissingArguments` attribute.
* Added new methods to the CLI `Input` class:
	- `Input::makeNonInteractive()`
	- `Input::makeInteractive()`
	- `Input::isInteractive()`
* Added global `--non-interactive` reactor argument.
* Added `Environment::noColor()` method.
* CLI output now respects the `NO_COLOR` environment variable.

#### Changes

* The `select` and `confirm` CLI inputs are now interactive and more user friendly.

#### Deprecations

* Deprecated the `Command::question()` method. Use the `Command::input()` method instead.
* Deprecated the `Cursor::beginningOfLine()` method. Use the `Cursor::moveToBeginningOfLine()` method instead.

> All deprecated features will be removed in Mako 12.0.

--------------------------------------------------------

### 11.1.1 <small>(2025-02-25)</small>

#### Changes

* Loosen type accepted by `Response::setBody()`.

--------------------------------------------------------

### 11.1.0 <small>(2025-02-19)</small>

#### New

* Added a statistics utility class with the following methods:
	- `Statistics::mean()`
	- `Statistics::median()`
	- `Statistics::mode()`
	- `Statistics::multimode()`
	- `Statistics::midrange()`
	- `Statistics::sampleVariance()`
	- `Statistics::populationVariance()`
	- `Statistics::sampleStandardDeviation()`
	- `Statistics::populationStandardDeviation()`
* Added "update and return" functionality to the query builder. The feature is currently supported by the `Firebird`, `PostgreSQL`, `SQLite` and `SQL Server` compilers.
* HTTP exceptions can now provide response headers.
* Added a rate limiter library with support for `APCu` and `Redis` stores.
* Added a rate limiter HTTP middleware.
* Added `Response::setCompressionHandler()` method.
* Added `Response::getCompressionHandler()` method.

#### Changes

* Command argument aliases are now shown in a separate column.

#### Deprecations

* Deprecated the WinCache cache store.

> All deprecated features will be removed in Mako 12.0.

--------------------------------------------------------

### 11.0.2 <small>(2025-01-17)</small>

#### New

* Added `RedisException::getStreamMetadata()` method to assist in debugging of read errors.

--------------------------------------------------------

### 10.0.12, 11.0.1 <small>(2025-01-16)</small>

#### Compatibility

* Replaced the deprecated SETEX and SETNX redis command calls with SET with the EX and NX options.

--------------------------------------------------------

### 11.0.0 <small>(2025-01-03)</small>

The major version bump is due to upping the required PHP version from `8.1` to `8.4` and a several breaking changes. Most applications built using Mako `10` should run on Mako `11` with just a few simple adjustments.

#### New

* Mako applications are now better suited to run on application servers like FrankenPHP.
* The development error view now displays the Mako environment name.
* Added `Connection::blob()` method that allows you to easily fetch a blob column as a stream.
* Added `Query::blob()` method that allows you to easily fetch a blob column as a stream.
* The `ManyToMany::unlink()` and `ManyToMany::synchronize()` methods now support junction attributes.
* Enums are now also supported when writing "raw" SQL.
* Added support for deletes with joins to the MySQL query compiler.
* The database library will use the new driver specific PDO sub-classes.
* Added upsert functionality to the query builder. The feature is currently supported by the `MySQL`, `PostgreSQL` and `SQLite` compilers.
* The database library now allows you to bind stringable objects as query parameters.
* Added `ConnectionManager::getOpenConnections()` method.
* The `Time::createFromTimestamp()` and `TimeImmutable::createFromTimestamp()` methods now support microsecond precision.
* The `Time::createFromFormat()` and `TimeImmutable::createFromFormat()` methods now support microsecond precision.
* It is now possible to customize how JSON request bodies are decoded using the following methods:
	- `Body::setJsonMaxDepth()` to set the maximum JSON nesting level.
	- `Body::setJsonFlags()` to set the JSON decoding options.
* The dependency injection container can now resolve intersection types.
* Added `Deprecated` middleware that allows you to easily set the `Deprecation` and `Sunset` HTTP headers.
* Global constraints and middleware will now be listed and sorted by priority when using the `app:routes` command.
* The Redis client now supports the following Redis Stack features:
	- Bloom filter
	- Cuckoo filter
	- Count-min sketch
	- JSON
	- Redis query engine
	- Auto-suggest
	- T-digest
	- Time series
	- Top-k
* Added `Redis::executeCommand()` helper method that makes it possible to call commands not yet supported by the client.
* Added `Permission` enum to make it easier to interact with file permissions.
* Added `Permissions` class that can be used to interact with a set of `Permission` enum instances.
* Added `FileSystem::setPermissions()` method that accepts an integer or a `Permissions` instance.
* Added `FileSystem::hasPermissions()` method that accepts an integer or a `Permissions` instance.
* Added `FileSystem::getPermissions()` method that returns a `Permissions` instance.
* Added `FileSystem::isExecutable()` method.
* Added `FileSystem::clearCache()` method.
* Added `FileInfo::hasPermissions()` method that accepts an integer or a `Permissions` instance.
* Added `FileInfo::getPermissions()` method that returns a `Permissions` instance.
* Reactor command names can now be registered with the `CommandName` attribute.
* Reactor command descriptions can now be registered with the `CommandDescription` attribute.
* Reactor command arguments can now be registered with the `CommandArguments` attribute.
* Added new `Cursor` class that makes it easier to control the CLI cursor.
* Added a signal handler to make it easier to handle async process control signals.
* Added a CLI spinner output component.
* Added a CLI hyperlink component.
* Added a CLI progress component.
* Added a CLI progress iterator component.
* New and improved look of rendered CLI tables.
* Added a simple way to defer small tasks until after the response has been sent to the client when using FastCGI.

#### Changes

* The gatekeeper `Session::login()` and `Session::forceLogin()` methods will now return a `LoginStatus` enum instance instead of a mix of boolean and integer values.
* Dropped support for underscore separated Redis method calls.
* Renamed the `UUID::sequential()` method to `UUID::v4Sequential()`.
* Renamed the `ErrorHandler::handle()` method to `ErrorHandler::addHandler()`.
* Renamed the `ErrorHandler::handler()` method to `ErrorHandler::handle()`.
* Renamed the `mako\cli\output\helpers` namespace to `mako\cli\output\components`.
* The Redis cache `clear` implementation will no longer flush the entire database but instead just delete the cached keys.

#### Deprecations

* Deprecated the `Command::$command` property. Use the `CommandName` attribute instead.
* Deprecated the `Command::$description` property. Use the `CommandDescription` attribute instead.
* Deprecated the `Command::getCommand()` method.
* Deprecated the `Command::getDescription()` method.
* Deprecated the `Command::getArguments()` method. Use the `CommandArguments` attribute instead.
* Deprecated the `Command::progressBar()` method. Use the `Command::progress()` or `Command::progressIterator()` methods instead.

#### Improvements

* Text in CLI alerts can now be styled and the alerts will render properly with text consisting of characters of varying width.
* More consistent look and feel when creating CLI commands.
* The preloader generator will now ensure preloading of class, property, method and argument attributes.
* Various other improvements and optimizations.

> Check out the upgrade guide for details on how to upgrade from `10.0.*.`

> All deprecated features will be removed in Mako 12.0.

--------------------------------------------------------

### 10.0.11 <small>(2024-12-18)</small>

#### Compatibility

* PHP 8.4 compatibility.

--------------------------------------------------------

### 10.0.10 <small>(2024-08-25)</small>

#### Bugfixes

* Fixed issue with the stty check ([#321](https://github.com/mako-framework/framework/pull/321)).
* Fixed issue with ETag caching ([#322](https://github.com/mako-framework/framework/pull/322)).

--------------------------------------------------------

### 9.1.6, 10.0.9 <small>(2024-07-21)</small>

#### Compatibility

* Ensuring compatibility with future PHP versions.

--------------------------------------------------------

### 10.0.8 <small>(2024-01-25)</small>

#### Bugfixes

* The `app:routes` command no longer fails when there is registered middleware.
* The `Environment::getWidth()` method now works as expected.
* The `Environment::hasAnsiSupport()` method now works as expected.

--------------------------------------------------------

### 10.0.7 <small>(2024-01-19)</small>

#### Improvements

* Query builder update queries can now have joins.

--------------------------------------------------------

### 10.0.6 <small>(2024-01-07)</small>

#### Bugfixes

* Fixed request bug that would occur if `PATH_INFO` was set but empty.

#### Improvements

* The framework now uses `mako\env` instead of `getenv`.

--------------------------------------------------------

### 10.0.5 <small>(2023-12-07)</small>

#### Bugfixes

* Fixed an issue where an uninitialized connection name in migration would throw an exception.

--------------------------------------------------------

### 10.0.4 <small>(2023-12-03)</small>

#### Bugfixes

* Fixed an issue where an uninitialized response body causes problems.

--------------------------------------------------------

### 10.0.3 <small>(2023-11-27)</small>

#### Bugfixes

* The validation factory `$container` constructor parameter no longer accepts null.

--------------------------------------------------------

### 10.0.2 <small>(2023-11-25)</small>

#### New

* Sensitive parameters will be redacted if present in a stack trace when running on PHP 8.2+

--------------------------------------------------------

### 9.1.5 <small>(2023-11-24)</small>

#### Bugfixes

* Ensure closing of connection when using the `ConnectionManager::executeAndClose()` method.

--------------------------------------------------------

### 10.0.0 <small>(2023-11-23)</small>

The major version bump is due to dropped support for PHP `8.0` and a several breaking changes. Most applications built using Mako `9` should run on Mako `10` with just a few simple adjustments.

#### New

* Added the `Session::disableAutoCommit()` method.
* Added the `Session::enableAutoCommit()` method.
* Made the `Session::gc()` method public and added a `$force` parameter.
* The following `Request` properties are now public readonly:
	- `Request::$query`
	- `Request::$post`
	- `Request::$cookies`
	- `Request::$files`
	- `Request::$server`
	- `Request::$headers`
* The following `Response` properties are now public readonly:
	- `Response::$cookies`
	- `Response::$headers`
* The following methods now accept both an int and the `mako\http\response\Status` enum as a parameter value:
	- `Response::setStatus()`
	- `JSON::setStatus()`
	- `Redirect::setStatus()`
* Added the `HttpStatusException::getStatus()` method.
* Simplified middleware and constraint registration.
* Global middleware and constraints can now be registered with parameters.
	- Added the `Dispatcher::registerGlobalMiddleware()` method.
	- Added the `Router::registerGlobalConstraint()` method.
* Added APCu session store.
* Added the `$validateEmptyFields` parameter to the validator to allow forced validation of empty fields.

#### Changes

* Removed the NuoDB query compiler.
* Removed the deprecated event library (use the bus library instead).
* Removed the deprecated command bus library (use the bus library instead).
* Removed the deprecated `TimeInterface::formatLocalized()` method.
* All class properties are now typed.
* The `mako\http\response\Status` class has been converted to an enum.
* The following methods now return an `mako\http\response\Status` instance instead of an int:
	- `Response::getStatus()`
	- `JSON::getStatus()`
	- `Redirect::getStatus()`
* Removed the `Dispatcher::registerMiddleware()` method.
* Removed the `Dispatcher::setMiddlewareAsGlobal()` method.
* Changed the `Dispatcher::setMiddlewarePriority()` method signature.
* Removed the `Router::registerConstraint()` method.
* Removed the `Router::setConstraintAsGlobal()` method.
* Application controllers and routing have been moved to the `app/http` namespace.

#### Improvements

* Various improvements and optimizations.

> Check out the upgrade guide for details on how to upgrade from `9.1.*.`

--------------------------------------------------------

### 9.1.4 <small>(2023-11-16)</small>

#### Bugfixes

* The `not_empty` validation rule is now available.

--------------------------------------------------------

### 9.1.3 <small>(2023-11-09)</small>

#### Bugfixes

* The logger service will no longer start the session unnecessarily if the gatekeeper service is enabled.

--------------------------------------------------------

### 9.1.2 <small>(2023-09-12)</small>

#### Bugfixes

* The `mako\env()` function now works as expected with the falsy boolean value defined as "0".

--------------------------------------------------------

### 9.1.1 <small>(2023-06-23)</small>

#### New

* Added `Arr::append()` method.

--------------------------------------------------------

### 9.1.0 <small>(2023-04-15)</small>

#### New

* Added the following methods to the `mako\file\FileSystem` class:
	- `FileSystem::isLink()`
	- `FileSystem::getLinkTarget()`
	- `FileSystem::createSymbolicLink()`
	- `FileSystem::createHardLink()`
* Added `HTTPService::getRoutingPath()` method to make it easier to reorganize the application structure.
* Added the following methods to the `mako\utility\Arr` class:
	- `Arr::toObject()`
* Added `mako\http\exceptions\UnauthorizedException` exception.
* Exceptions handled by the Mako exception handlers will be assigned a unique id that makes it easier to find the corresponding log entry.
* Added a new bus library with command, event and query buses.
* New and improved output for the `app:routes` command.
* The `Query::insertAndGetId()` method now allows inserting empty rows just like the `Query::insert()` method.
* Added `mako\env()` helper function.

#### Deprecations

* Deprecated the `mako\chrono\TimeInterface::formatLocalized()` method.
* Deprecated the old command bus library (see the new command and query buses).
* Deprecated the old event library (see the new event bus).

--------------------------------------------------------

### 8.1.5, 9.0.3 <small>(2023-01-21)</small>

#### Bugfixes

* Fixed migration rollbacks.

--------------------------------------------------------

### 9.0.2 <small>(2023-01-12)</small>

#### Bugfixes

* Fixed autoloading of the `RangeNotSatisfiableException` exception.

--------------------------------------------------------

### 9.0.1 <small>(2022-12-26)</small>

#### Bugfixes

* The `CommandInterface::handle()` and `SelfHandlingCommandInterface::handle()` methods no longer enforce a `mixed` return type.

--------------------------------------------------------

### 9.0.0 <small>(2022-12-22)</small>

The major version bump is due to dropped support for PHP `7.4` and a several breaking changes. Most applications built using Mako `8` should run on Mako `9` with just a few simple adjustments.

#### New

* The name of CLI arguments with aliases can now be defined using an array instead of a string.
* The preloader generator will now attempt to preload typed properties, method arguments and return types.
* Route middleware can now be registered using only the class name.
* Route constraints can now be registered using only the class name.
* Added the following methods to the query builder:
	- `Query::rightJoin()`
	- `Query::rightJoinRaw()`
	- `Query::crossJoin()`
	- `Query::lateralJoin()`
	- `Query::insertMultiple()`
* Added the `mako\f` "function builder" helper function.


#### Changes

* Removed the `Validator::rule()` helper method in favor of the new `mako\f` helper function.
* Removed the following deprecated methods from the `Str` class:
	- `Str::camel2underscored()`
	- `Str::underscored2camel()`
* Renamed the following classes:
	- `mako\http\routing\traits\InputValidationTrait` to `mako\validator\input\http\routing\traits\InputValidationTrait`.
	- `mako\validator\input\HttpInput` to `mako\validator\input\http\Input`.
	- `mako\validator\input\HttpInputInterface` to `mako\validator\input\http\InputInterface`.
	- `mako\http\routing\traits\AuthorizationTrait` to `mako\gatekeeper\authorization\http\routing\traits\AuthorizationTrait`.
* The following class constants have been made protected:
	- mako\application\cli\commands\server\Server::MAX_PORTS_TO_TRY
	- mako\classes\ClassFinder::PHP_FILENAME_PATTERN
	- mako\cli\input\arguments\Argument::NAME_REGEX
	- mako\cli\input\arguments\Argument::ALIAS_REGEX
	- mako\cli\input\arguments\ArgvParser::INT_REGEX
	- mako\cli\input\arguments\ArgvParser::FLOAT_REGEX
	- mako\cli\output\formatter\Formatter::TAG_REGEX
	- mako\cli\output\formatter\Formatter::ESCAPED_TAG_REGEX
	- mako\cli\output\formatter\Formatter::ANSI_SGR_SEQUENCE_REGEX
	- mako\cli\output\helpers\Alert::PADDING
	- mako\cli\output\helpers\Countdown::SLEEP_TIME
	- mako\commander\CommandBus::COMMAND_SUFFIX
	- mako\commander\CommandBus::HANDLER_SUFFIX
	- mako\database\midgard\ORM::PRIMARY_KEY_TYPE_INCREMENTING
	- mako\database\midgard\ORM::PRIMARY_KEY_TYPE_UUID
	- mako\database\midgard\ORM::PRIMARY_KEY_TYPE_CUSTOM
	- mako\database\midgard\ORM::PRIMARY_KEY_TYPE_NONE
	- mako\database\midgard\relations\Relation::EAGER_LOAD_CHUNK_SIZE
	- mako\database\query\compilers\Compiler::JSON_PATH_SEPARATOR
	- mako\error\handlers\web\DevelopmentHandler::SOURCE_PADDING
	- mako\i18n\I18n::PLURALIZATION_TAG_REGEX
	- mako\i18n\I18n::NUMBER_TAG_REGEX
	- mako\redis\Redis::CRLF
	- mako\redis\Redis::CRLF_LENGTH
	- mako\redis\Redis::VERBATIM_PREFIX_LENGTH
	- mako\redis\Redis::END
	- mako\security\crypto\encrypters\Encrypter::DERIVATION_HASH
	- mako\security\crypto\encrypters\Encrypter::DERIVATION_ITERATIONS
	- mako\security\Signer::MAC_LENGTH
	- mako\session\Session::MAX_TOKENS
	- mako\view\compilers\Template::VERBATIM_PLACEHOLDER

#### Improvements

* Various improvements and optimizations.

> Check out the upgrade guide for details on how to upgrade from `8.1.*.`

--------------------------------------------------------

### 8.1.4 <small>(2022-12-07)</small>

#### Bugfixes

* Don't set the Content-Encoding header when sending a chunked data stream.

--------------------------------------------------------

### 8.1.3 <small>(2022-10-13)</small>

#### Bugfixes

* PHP `8.1` compatibility:
	- Creating a migration without a description will no longer fail.

--------------------------------------------------------

### 8.1.2 <small>(2022-10-12)</small>

#### Bugfixes

* Junction tables will now be named correctly even when table names are prefixed by the database name.

--------------------------------------------------------

### 7.3.9, 8.0.6, 8.1.1 <small>(2022-06-12)</small>

#### Bugfixes

* Fixed issue caused by breaking changes in Monolog.

--------------------------------------------------------

### 8.1.0 <small>(2022-04-26)</small>

#### New

* It is now possible to use custom validation rules without registering them first.
* Added `Str::camelToSnake()` method.
* Added `Str::snakeToCamel()` method.
* Added `CamelCasedTrait` ORM trait that enables camel cased interaction with ORM objects.
* The `protect` and `expose` methods of the ORM `ResultSet` class are now chainable.
* Eager loaded relations can now be aliased.
* Route middleware can now be registered using the new `Middleware` attribute (PHP 8.0+).
* Route constraints can now be registered using the new `Constraint` attribute (PHP 8.0+).
* The ORM `$protected` property and `protect` method now supports nested fields.

#### Deprecations

* Deprecated the `Str::camel2underscored` method.
* Deprecated the `Str::underscored2camel` method.

--------------------------------------------------------

### 7.3.8, 8.0.5 <small>(2022-02-19)</small>

#### Bugfixes

* PHP 8.1 compatibility.

--------------------------------------------------------

### 7.3.7, 8.0.4 <small>(2022-02-10)</small>

#### Bugfixes

* Eager loading will now work as expected with `ORM::getOrThrow()` and `Query::getOrThrow()`.

--------------------------------------------------------

### 7.3.6, 8.0.3 <small>(2022-02-08)</small>

#### Bugfixes

* PHP `8.2` compatibility.
* Prevent errors with malformed request paths.

--------------------------------------------------------

### 8.0.2 <small>(2021-12-02)</small>

#### Bugfixes

* Fixed issue with subqueries when using the ORM ([#291](https://github.com/mako-framework/framework/issues/291)).

--------------------------------------------------------

### 6.3.20, 7.0.10, 7.1.5, 7.2.3, 7.3.5, 8.0.1 <small>(2021-11-30)</small>

#### Bugfixes

* PHP `8.1` compatibility.

--------------------------------------------------------

### 8.0.0 <small>(2021-11-30)</small>

The major version bump is due to dropped support for PHP `7.3` and a several breaking changes. Most applications built using Mako `7.3.0` should run on Mako `8.0.0` with just a few simple adjustments.

#### New

* Views can now be rendered by casting them to strings.
* Added `WriterInterface::setStream()` method.
* The query builder now supports enums (PHP 8.1+).
* The ORM can now cast values to enums (PHP 8.1+).
* Added `boolean:false` validation rule.
* Added `boolean:true` validation rule.
* Added `boolean` validation rule.
* Added `enum` validation rule (PHP 8.1+).
* Added `not_empty` validation rule.
* Added `number:float` validation rule.
* Added `number:int` validation rule.
* Added `number:natural_non_zero` validation rule.
* Added `number:natural` validation rule.
* Added `number` validation rule.
* Added `numeric` validation rule.
* Added `string` validation rule.
* Middleware will now be executed even when routing throws `NotFoundException` and `MethodNotAllowed` exceptions.

#### Changes

* The `Str::alternator()` method now returns an `Alternator` instance instead of a closure.
* Removed the deprecated `AdapterManager::instance()` method.
* Removed the deprecated `ConnectionManager::instance()` method.
* Removed the following deprecated methods from the `Connection` class:
	- `Connection::builder()`
	- `Connection::table()`
* Removed the deprecated `ORM::builder()` method.
* Removed the deprecated `Route::namespace()` method.
* Removed support for defining method controller actions as strings.
* Removed the deprecated `AccessControlAllowOrigin` middleware.
* The following validation rules have been renamed:
	- `float` to `numeric:float`
	- `integer` to `numeric:int`
	- `natural_non_zero` to `numeric:natural_non_zero`
	- `natural` to `numeric:natural`
* The following commands have been renamed:
	- `app.generate_preloader` to `app:generate-preloader`
	- `app.generate_secret` to `app:generate-secret`
	- `app.generate-key` to `app:generate-key`
	- `app.routes` to `app:routes`
	- `cache.clear` to `cache:clear`
	- `cache.remove` to `cache:remove`
	- `migrate.create` to `migration:create`
	- `migrate.down` to `migration:down`
	- `migrate.reset` to `migration:reset`
	- `migrate.status` to `migration:status`
	- `migrate.up` to `migration:up`
	- `server` to `app:server`
* The following exceptions have been renamed:
	- `mako\cli\output\formatter\FormatterException` to `mako\cli\output\formatter\exceptions\FormatterException`
	- `mako\config\loaders\LoaderException` to `mako\config\loaders\exceptions\LoaderException`
	- `mako\gatekeeper\authorization\AuthorizerException` to `mako\gatekeeper\authorization\exceptions\AuthorizerException`
	- `mako\http\exceptions\HttpException` to `mako\http\exceptions\HttpStatusException`
	- `mako\i18n\I18nException` to `mako\i18n\exceptions\I18nException`
	- `mako\i18n\loaders\LoaderException` to `mako\i18n\loaders\exceptions\LoaderException`
	- `mako\onion\OnionException` to `mako\onion\exceptions\OnionException`
	- `mako\redis\RedisException` to `mako\redis\exceptions\RedisException`
	- `mako\security\crypto\CryptoException` to `mako\security\crypto\exceptions\CryptoException`
	- `mako\security\password\HasherException` to `mako\security\password\exceptions\HasherException`
	- `mako\validator\ValidationException` to `mako\validator\exceptions\ValidationException`
	- `mako\view\ViewException` to `mako\view\exceptions\ViewException`
* Added `$field` parameter to the `RuleInterface::validate()` method.

#### Improvements

* Various improvements and optimizations.

> Check out the upgrade guide for details on how to upgrade from `7.3.*.`

--------------------------------------------------------

### 6.3.19, 7.0.9, 7.1.4, 7.2.2, 7.3.4 <small>(2021-11-28)</small>

#### Bugfixes

* PHP `8.1` compatibility.

--------------------------------------------------------

### 7.3.3 <small>(2021-11-22)</small>

#### Changes

* The `InputValidation` middleware will now keep access control headers when clearing the response.

--------------------------------------------------------

### 7.3.2 <small>(2021-11-05)</small>

#### Bugfixes

* The `app.routes` command now works with route actions defined as arrays.

--------------------------------------------------------

### 7.3.1 <small>(2021-10-25)</small>

#### New

* Added protected `AccessControl::getAllowedDomains()` method.

--------------------------------------------------------

### 7.3.0 <small>(2021-10-19)</small>

#### New

* Added abstract `AccessControl` middleware.
* Added new and cleaner way of registering class methods as route actions.
* Added `Cookies::clearExcept()` method.
* Added `Headers::clearExcept()` method.
* Added `Response::clearExcept()` method.
* Added `Response::resetExcept()` method.
* It is now possible to define a whitelist of cookies and headers to keep when an exception has been handled.
* Added `Connection::firstOrThrow()` method to the database connection class.
* Added `Query::firstOrThrow()` method to the base query builder class.
* Added `Query::getOrThrow()` method to the ORM query builder class.
* Added `Query::firstOrThrow()` method to the ORM query builder class.
* Added `ORM::getOrThrow()` method.
* The database library will now throw `mako\database\exceptions\DatabaseException` exceptions that extend the previously thrown `RuntimeException` exceptions.
* Added `ConnectionManager::getConnection()` method.
* Added `Connection::getQuery()` method.
* Added `ORM::getQuery()` method.
* Added `FileSystem::copy()` method.
* Added `CacheManager::getInstance()` method.
* Added `CacheManager::getStore()` method.
* Added `CryptoManager::getInstance()` method.
* Added `CryptoManager::getEncrypter()` method.
* Added `Headers::getBearerToken()` method.

#### Deprecations

* Deprecated the `AccessControlAllowOrigin` middleware.
* Deprecated the `Route::namespace()` method.
* Deprecated the `ConnectionManager::connection()` method.
* Deprecated the `Connection::builder()` method.
* Deprecated the `Connection::table()` method.
* Deprecated the `ORM::builder()` method.
* Deprecated `CacheManager::instance()` method.
* Deprecated `CryptoManager::instance()` method.

#### Improvements

* Better autocompletion when calling methods proxied by `__call` methods.

> All deprecated features will be removed in Mako 8.0.

--------------------------------------------------------

### 6.3.18, 7.0.8, 7.1.3, 7.2.1 <small>(2021-10-12)</small>

#### Bugfixes

* PHP `8.1` compatibility.

--------------------------------------------------------

### 7.2.0 <small>(2021-03-02)</small>

#### New

* The default production error handler now has "dark mode" support.
* New and improved development error handler with "dark mode" support.
* Added `setMetadata` and `getMetadata` methods to the `HttpException` class.
	- The `HttpException` metadata array is available in the production error views as `$_metadata_`.
	- The `HttpException` metadata array will also be avaiable in the JSON and XML representation of the errors.
* Template block names can now be surrounded by single quotes for consistency.

#### Changes

* The language cache has been removed as [OPcache](https://www.php.net/manual/en/book.opcache.php) will cache the language files in memory and load them faster than any other cache solution.

--------------------------------------------------------

### 7.0.7, 7.1.2 <small>(2021-01-28)</small>

#### Bugfixes

* The ORM will now throw an exception when attempting to access related records on non-persisted models instead of loading random records.

--------------------------------------------------------

### 6.3.17, 7.0.6, 7.1.1 <small>(2021-01-12)</small>

#### Bugfixes

* Fixed bug that could occur when building "non-clean" URLs in the command line.

--------------------------------------------------------

### 7.1.0 <small>(2020-12-31)</small>

#### New

* It is now possible to register contextual dependencies for class methods in the container.
* Added a HTTP status code helper class.
* Added missing status codes to `Response` class.
* Added a `Retry` helper class that allows you to retry a callable a set number of times.
* Added `Application::getStoragePath()` method.
* Added a `Finder` class.
* Added a `ClassFinder` class.
* Added `app.generate_preloader` command that generates an opcache preloder script for improved production performance (only available on PHP `7.4` and greater).
* It is now possible for reactor commands to automatically register themselves.
* Added `getCommand` method to the `CommandInterface` interface.

#### Changes

* Cloned database connections will now get a new PDO instance and have their query log and transaction nesting level reset.
* The `ClassInspector` class has been moved from the `mako\syringe` namespace to the `mako\classes` namespace.

--------------------------------------------------------

### 6.3.16, 7.0.5 <small>(2020-11-26)</small>

#### Bugfixes

* Fixed error that could occur when restoring GD snapshots on PHP `8.0`.

--------------------------------------------------------

### 6.3.15, 7.0.4 <small>(2020-11-23)</small>

#### Bugfixes

* Connection managers will now close connections before removing configurations when calling the `removeConfiguration` method.

--------------------------------------------------------

### 6.3.14, 7.0.3 <small>(2020-10-26)</small>

#### Bugfixes

* Fixed an issue where the path to the reactor executable would fail. ([#283](https://github.com/mako-framework/framework/pull/283)).

--------------------------------------------------------

### 6.3.13, 7.0.2 <small>(2020-10-22)</small>

#### Bugfixes

* Fixed an issue where the path to the application could prevent the development server from starting ([#282](https://github.com/mako-framework/framework/pull/282)).

--------------------------------------------------------

### 7.0.1 <small>(2020-09-15)</small>

#### Bugfixes

* Fixes an issue where `ORM::toArray()` would fail when a related record is `null` ([#279](https://github.com/mako-framework/framework/issues/279)).

--------------------------------------------------------

### 7.0.0 <small>(2020-09-14)</small>

The major version bump is due to dropped support for PHP `7.2` and a several breaking changes. Most applications built using Mako `6.3.0` should run on Mako `7.0.0` with just a few simple adjustments.

#### New

* Added `Collection::first()` method.
* Added `Collection::last()` method.
* Added support for the `samesite` cookie option (defaults to `Lax`).
* Added `Query::withCountOf()` method to the ORM query builder.
* Added abstract `AccessControlAllowOrigin` middleware.
* Added `Cookies::addRaw()` method.
* Added `Cookies::addRawSigned()` method.
* Added a `InputValidationTrait` for use in a controller context.
* The Redis client now supports Redis 6 ACL as well as the new RESP3 protocol.
* The following "raw" query builder methods now support bound query parameters:
	- `Join::onRaw()`
	- `Join::orOnRaw()`
	- `Query::selectRaw()`
	- `Query::orderByRaw()`
	- `Query::ascendingRaw()`
	- `Query::descendingRaw()`

#### Changes

* The cache `StoreInterface::get()` method will now return `null` instead of `false` when the item does not exist in the cache.
* The following methods in the database library will now return `null` instead of `false` when no matching record is found:
	- `Connection::first()`
	- `Connection::column()`
	- `Query::first()`
	- `Query::column()`
	- `Query::get()`
	- `ORM::get()`
* The following methods in the Gatekeeper library will now return `null` instead of `false` when unable to retrieve data:
	- `GroupRepositoryInterface::getByIdentifier()`
	- `GroupRepository::getById()`
	- `GroupRepository::getByName()`
	- `UserRepositoryInterface::getByIdentifier()`
	- `UserRepository::getByAccessToken()`
	- `UserRepository::getByActionToken()`
	- `UserRepository::getByEmail()`
	- `UserRepository::getById()`
	- `UserRepository::getByUsername()`
* Passing a `Query` instance to the `Subquery` constructor is no longer supported.
* Passing a `Closure` or `Query` instance to represent a subquery to the following methods is no longer supported:
	- `Query::table()`
	- `Query::from()`
	- `Query::into()`
	- `Query::in()`
	- `Query::notIn()`
	- `Query::orIn()`
	- `Query::orNotIn()`
	- `Query::exists()`
	- `Query::orExists()`
	- `Query::notExists()`
	- `Query::orNotExists()`
	- `Query::with()`
	- `Query::withRecursive()`
* Dropped support for `DB2` databases.
* Removed the following deprecated methods from the `UploadedFile` class:
	- `UploadedFile::getName()`
	- `UploadedFile::getReportedType()`
* Removed the following deprecated constants from the `Redirect` class:
	- `Redirect::MULTIPLE_CHOICES`
	- `Redirect::NOT_MODIFIED`
	- `Redirect::USE_PROXY`
* Removed the following deprecated methods from the `Redirect` class:
	- `Redirect::multipleChoices()`
	- `Redirect::notModified()`
	- `Redirect::useProxy()`
* Removed the following deprecated methods from the `ErrorHandler` class:
	- `ErrorHandler::disableLoggingFor()`
* Removed the following deprecated validation rule aliases:
	- `max_filesize`
	- `mimetype`
* Removed the deprecated `commandInformation` property from the `Command` class.
* Removed the following deprecated cache stores:
	- `ZendDisk`
	- `ZendMemory`
* Removed support for the deprecated "empty else" template syntax.
* Class aliases will no longer be registered during the application boot process.
* The Gatekeeper `Adapter::activateUser()` method will now always return a boolean value as described in the documentation.
* Renamed the `InputValidationTrait::validate()` method to `InputValidationTrait::getValidatedInput()`.
* Removed the undocumented recursive configuration file merging.
* Renamed `Validator::validate()` to `Validator::getValidatedInput()`.

#### Improvements

* Various improvements and optimizations.

> Check out the upgrade guide for details on how to upgrade from `6.3.*.`

--------------------------------------------------------

### 6.3.12 <small>(2020-08-19)</small>

#### Bugfixes

* PHP `8.0` compatibility.

--------------------------------------------------------

### 6.3.11 <small>(2020-07-15)</small>

#### Bugfixes

* PHP `8.0` compatibility.

--------------------------------------------------------

### 6.3.10 <small>(2020-07-09)</small>

#### Bugfixes

* PHP `8.0` compatibility.

--------------------------------------------------------

### 6.2.5, 6.3.9 <small>(2020-06-04)</small>

#### Bugfixes

* Fixed issue that occurred when cloning queries that have set operations.
* Query pagination now works with queries that have set operations.

--------------------------------------------------------

### 6.3.8 <small>(2020-01-12)</small>

#### Changes

* `ManyToMany::unlink()` and `ManyToMany::updateLink()` now supports wheres.

--------------------------------------------------------

### 6.3.7 <small>(2019-11-26)</small>

#### Changes

* The error handler will now attempt to log logger exceptions using PHP's system logger.

--------------------------------------------------------

### 6.3.6 <small>(2019-11-12)</small>

#### Changes

* The old input from the `InputValidation` middleware will no longer be cast to an object before being assigned to views.

--------------------------------------------------------

### 6.3.5 <small>(2019-11-07)</small>

#### Changes

* The `ProgressBar::advance()` method will now throw a `LogicException` when trying to advance past 100%.

--------------------------------------------------------

### 6.3.4 <small>(2019-11-04)</small>

#### Changes

* The `$ruleSets` parameter of the `ValidatorFactory` and `Validator` constructors is now optional.

--------------------------------------------------------

### 6.3.3 <small>(2019-10-23)</small>

#### Changes

* Refactored the `InputValidation` middleware and added the `HttpInputInterface` interface.

--------------------------------------------------------

### 6.3.2 <small>(2019-10-21)</small>

#### Bugfixes

* `Request::isSecure()` will no longer fail if `REMOTE_ADDR` isn't set.

--------------------------------------------------------

### 6.3.1 <small>(2019-10-21)</small>

#### Bugfixes

* `Request::getIp()` will no longer fail if `REMOTE_ADDR` isn't set.

--------------------------------------------------------

### 6.3.0 <small>(2019-10-20)</small>

#### New

* Added `TimeImmutable` class.
* Added `Time::copy()` method.
* Added `Time::getImmutable()` method.
* Added `Redis::subscribeTo()` method.
* Added `Redis::subscribeToPattern()` method.
* Added `Redis::monitor()` method.
* Added `UploadedFile::getReportedFilename()` method.
* Added `UploadedFile::getReportedMimeType()` method.
* Added `max_file_size` validation rule.
* Added `mime_type` validation rule.
* Added `max_filename_length` validation rule.
* Added `SecurityHeaders` middleware.
* Added `ContentSecurityPolicy` middleware.
* Added `InputValidation` middleware.
* Added `InputValidationTrait` trait that reduces the need for validation boilerplate.
* Added `FileSystem::getDiskSize()` method.
* Added `FileSystem::getFreeSpaceOnDisk()` method.
* Added `JSON::getStatus()` method.
* Added `JSON::getCharset()` method.
* Added `Redirect::getStatus()` method.
* Added `Stream::getType()` method.
* Added `Stream::getCharset()` method.
* Added `Response::getRequest()` method.

#### Deprecations

* The following methods have been deprecated and will be removed in `7.0`:
	- `UploadedFile::getName()` (replaced by `UploadedFile::getReportedFilename()`)
	- `UploadedFile::getReportedType()` (replaced by `UploadedFile::getReportedMimeType()`)
	- `Redirect::multipleChoices()`
	- `Redirect::notModified()`
	- `Redirect::useProxy()`
* The following validation rules have been deprecated and will be removed in `7.0`:
	- `max_filesize` (replaced by `max_file_size`)
	- `mimetype` (replaced by `mime_type`)

#### Improvements

* Massive speed improvements when sending large values to Redis.
* Reduced number of method calls when hydrating models.

--------------------------------------------------------

### 5.7.8, 6.0.7, 6.1.6, 6.2.4 <small>(2019-09-27)</small>

#### Bugfixes

* The correct field name will now be displayed when using wildcard validation rules.

--------------------------------------------------------

### 5.7.7, 6.0.6, 6.1.5, 6.2.3 <small>(2019-09-09)</small>

#### Bugfixes

* Fixed breaking change introduced in `5.7.6`, `6.0.5`, `6.1.4` and `6.2.2`.

--------------------------------------------------------

### 5.7.6, 6.0.5, 6.1.4, 6.2.2 <small>(2019-09-05)</small>

#### Bugfixes

* Fixed bug that could cause the production error handler to fail when using the view auto assign feature.

--------------------------------------------------------

### 6.2.1 <small>(2019-08-27)</small>

#### Bugfixes

* Fixed breaking change introduced in `6.2.0`.

--------------------------------------------------------

### 6.2.0 <small>(2019-08-26)</small>

#### New

* New and improved command line argument parser.
* Added `Request::isCacheable()` method.
* Added `Request::isIdempotent()` method.
* Added `Response::isCacheable()` method.
* Added `ValidationException::getMessageWithErrors()` method.
* The query builder now supports multiple tables in the `FROM` clause.

#### Changes

* Commands are now required to define their arguments.
* The `Command::$isStrict` property doesn't do anything as all commands are required to define their arguments.
* The `OPTIONS` and `TRACE` request methods are now also considdered safe by the `Request::isSafe()` method.

#### Deprecations

* The `Command::$commandInformation` property is deprecated and will be removed in `7.0`.
* The `application.class_aliases` config key is deprecated and will be removed in `7.0`.
* The `ZendDisk` cache store is deprecated and will be removed in `7.0`.
* The `ZendMemory` cache store is deprecated and will be removed in `7.0`.
* Passing a `Closure` or `Query` instance to represent a subquery to the following methods is deprecated and will stop working in `7.0`:
	- `Query::table()`
	- `Query::from()`
	- `Query::into()`
	- `Query::in()`
	- `Query::notIn()`
	- `Query::orIn()`
	- `Query::orNotIn()`
	- `Query::exists()`
	- `Query::orExists()`
	- `Query::notExists()`
	- `Query::orNotExists()`
	- `Query::with()`
	- `Query::withRecursive()`
* Passing a `Closure`, `Query` or `Subquery` instance to the following methods is deprecated and will stop working in `7.0`:
	- `Query::union()`
	- `Query::unionAll()`
	- `Query::intersect()`
	- `Query::intersectAll()`
	- `Query::except()`
	- `Query::exceptAll()`
* Support for `DB2` databases is deprecated and will be removed in `7.0`.

> Check out the upgrade guide for details on how to upgrade from `6.1.*.`

--------------------------------------------------------

### 5.7.5, 6.0.4, 6.1.3 <small>(2019-08-10)</small>

#### Bugfixes

* Fixed breaking change introduced in `5.7.4`, `6.0.4` and `6.1.2`.

--------------------------------------------------------

### 5.7.4, 6.0.3, 6.1.2 <small>(2019-08-10)</small>

#### Bugfixes

* PHP `7.4` compatibility.

--------------------------------------------------------

### 5.7.3, 6.0.2, 6.1.1 <small>(2019-08-08)</small>

#### Bugfixes

* Package validation rule i18n messages will now work as expected.

--------------------------------------------------------

### 6.1.0 <small>(2019-08-02)</small>

#### New

* The server command will make up to 10 attempts to find an available port if the default one is in use.
* Added `Container::hasInstanceOf()` method.
* It is now possible to send additional arguments to authorization policy methods.
* Added bitonal filter to the image library ([#258](https://github.com/mako-framework/framework/pull/258)).
* Added new collection methods:
	- `Collection::with()`
	- `Collection::without()`
* The following Collection methods are now chainable:
	- `clear`
	- `each`
	- `put`
	- `remove`
	- `resetKeys`
	- `shuffle`
	- `sort`
* Added support for common table expressions to the query builder.
	- `Query::with()`
	- `Query::withRecursive()`
* Added `Query::forCompiler()` method that can be used to add dialect specific SQL to queries.
* Added `Query::selectRaw()` method.
* Added `Query::whereColumn()` method.
* Added query builder date helpers:
	- `Query::whereDate()`
	- `Query::orWhereDate()`
	- `Query::betweenDate()`
	- `Query::orBetweenDate()`
	- `Query::notBetweenDate()`
	- `Query::orNotBetweenDate()`
* MySQL and SQLite query builder queries now support offsets without limits.
* The query builder now supports select queries without a table.
* Added new syntax for default values in templates.
* The production web error handler no longer requires a view factory instance.
* It is now easier to override the storage path of compiled templates and log files using the new `application.storage_path` config key.
* Added `ErrorHandler::dontLog()` method.
* It is now possible to disable logging of specific exceptions types using the new `application.error_handler.dont_log` config key.

#### Deprecations

* The `{{$foo || 'Default}}` and `{{$foo or 'Default}}` template syntax has been deprecated and will be removed in `7.0` use the `{{$foo, default: 'Default'}}` syntax instead.

* The `ErrorHandler::disableLoggingFor()` method has been deprecated and will be removed in `7.0`. Use the new `ErrorHandler::dontLog()` method instead.

> Check out the upgrade guide for details on how to upgrade from `6.0.*.`

--------------------------------------------------------

### 5.7.2, 6.0.1 <small>(2019-05-21)</small>

#### Bugfixes

* Images will now be rotated in the same direction when using ImageMagick and GD.

--------------------------------------------------------

### 6.0.0 <small>(2019-03-30)</small>

The major version bump is due to dropped support for PHP `7.0` and `7.1` and a several breaking changes. Most applications built using Mako `5.7.0` should run on Mako `6.0.0` with just a few simple adjustments.

#### New

* Added `optional` validation rule.
* Added `time_zone` validation rule.
* Added `Validator::validate()` method that returns the validated input on success and throws an `ValidationException` on failure.
* The container will now inject `null` when unable to resolve a nullable or optional class dependency.
* Added `Logger` class that extends the monolog logger with functionality to set global log context parameters (the gatekeeper user id will automatically be added if possible).
* Added the `mako\cli\Environment` class with the following methods:
	- `Environment::getDimensions()`
	- `Environment::getWidth()`
	- `Environment::getHeight()`
	- `Environment::hasAnsiSupport()`
* Added `Output::getEnvironment()` method.
* Added `JSON::setCharset()` method.
* Added `Stream::setType()` method.
* Added `Stream::setCharset()` method.
* Added `scope` method to the ORM query builder.
* Added `UUID::toBinary()` method.
* Added `UUID::toHexadecimal()` method.
* Added `UUID::sequential()` method.
* Added `Output::dump()` method.
* Added authorization to the gatekeeper library.

#### Changes

* Removed the deprecated `FileSystem::mime()` method.
* Removed the deprecated `FileSystem::hash()` method.
* Removed the deprecated `FileSystem::hmac()` method.
* The ORM query builder no longer supports "magic" scope methods. Use the `scope` method instead.
* The `RequestException` class has been renamed to `HttpException`.
* Removed the `Constraint` base class. Constraints should implement the `ConstraintInterface` instead.
* Constraints parameters are now injected through the constructor.
* Removed the `Middleware` base class. Middleware should implement the `MiddlewareInterface` instead.
* Middleware parameters are now injected through the constructor.
* Validator rule parameters are now injected via the constructor.
* Removed the `Output::hasAnsiSupport()` method.
* The `mako\gatekeeper\Authentication` class has been renamed to `mako\gatekeeper\Gatekeeper`.
* Several of the `mako\http\Request` methods have been renamed for consistency:
	- The `Request::contentType()` method has been renamed to `Request::getContentType()`.
	- The `Request::scriptName()` method has been renamed to `Request::getScriptName()`.
	- The `Request::ip()` method has been renamed to `Request::getIp()`.
	- The `Request::basePath()` method has been renamed to `Request::getBasePath()`.
	- The `Request::baseURL()` method has been renamed to `Request::getBaseURL()`.
	- The `Request::path()` method has been renamed to `Request::getPath()`.
	- The `Request::language()` method has been renamed to `Request::getLanguage()`.
	- The `Request::languagePrefix()` method has been renamed to `Request::getLanguagePrefix()`.
	- The `Request::method()` method has been renamed to `Request::getMethod()`.
	- The `Request::realMethod()` method has been renamed to `Request::getRealMethod()`.
	- The `Request::username()` method has been renamed to `Request::getUsername()`.
	- The `Request::password()` method has been renamed to `Request::getPassword()`.
	- The `Request::referer()` method has been renamed to `Request::getReferrer()`.
* Several of the `mako\http\request\Headers` methods have been renamed for consistency:
	- The `Headers::acceptableContentTypes()` method has been renamed to `Headers::getAcceptableContentTypes()`.
	- The `Headers::acceptableLanguages()` method has been renamed to `Headers::getAcceptableLanguages()`.
	- The `Headers::acceptableCharsets()` method has been renamed to `Headers::getAcceptableCharsets()`.
	- The `Headers::acceptableEncodings()` method has been renamed to `Headers::getAcceptableEncodings()`.
* Several of the `mako\http\Response` methods have been renamed for consistency:
	- The `Response::body()` method has been renamed to `Response::setBody()`.
	- The `Response::charset()` method has been renamed to `Response::setCharset()`.
	- The `Response::status()` method has been renamed to `Response::setStatus()`.
	- The `Response::type()` method has been renamed to `Response::setType()`.
	- The `Response::cache()` method has been renamed to `Response::enableCaching()`.
	- The `Response::compress()` method has been renamed to `Response::enableCompression()`.
	- The `JSON::status()` method has been renamed to `JSON::setStatus()`.
	- The `Redirect::status()` method has been renamed to `Redirect::setStatus()`.
* The `ExtendableTrait::extend()` method has been renamed to `ExtendableTrait::addMethod()`.

> Check out the upgrade guide for details on how to upgrade from `5.7.*.`

--------------------------------------------------------

### 5.7.1 <small>(2019-01-05)</small>

#### New

* Added optional `--exit-code` option to `migrate.status` command.

--------------------------------------------------------

### 5.7.0 <small>(2018-12-06)</small>

#### New

* It is now possible to eager load relations on a loaded model using the `ORM::include()` method.
* It is now possible to eager load relations on a result set using the `ResultSet::include()` method.
* Added `ORM::includes()` method that returns `true` if a relation has been loaded and `false` if not.
* Added `PaginationInterface::toArray()` method.
* Added `PaginationInterface::toJSON()` method.
* The `PaginationInterface` interface now extends the `JsonSerializable` interface.
* The query builder now supports basic tuple comparisons.
* It is now possible to provide a list of superglobal keys to blacklist from the Whoops error view
* It is now possible to set raw cookies.
* Added `FileInfo` class that extends `SplFileInfo` with the following methods:
	- `FileInfo::getMimeType()`.
	- `FileInfo::getMimeEncoding()`.
	- `FileInfo::getHash()`.
	- `FileInfo::validateHash()`.
	- `FileInfo::getHmac()`.
	- `FileInfo::validateHmac()`.
* Added `FileSystem::info()` method that returns a `FileInfo` object.
* Added new validation rules:
	- Added `hash` rule.
	- Added `hmac`rule.
	- Added `aspect_ratio` rule.
	- Added `exact_dimensions` rule.
	- Added `max_dimensions` rule.
	- Added `min_dimensions` rule.

#### Changes

* Removed the deprecated `mako\security\Password` class.
* Removed the deprecated `ORM::$exists` property.
* Removed the deprecated `ORM::exists()` method.
* The gatekeeper `forceLogin` method now returns `true` if the login is successful and a status code if not.
* The JSON representation of a result set returned by the `Query::paginate()` method will now be an object where the results are available as `data` and pagination information will be available as `pagination` (`{"data":[...], "pagination":{...}}`).
* An exception will be thrown when trying to set a secure session or gatekeeper cookie over a non-secure connection.
* The URL builder will now separate query string parameters with `&` instead of `&amp;`.
* The URL builder will now encode query string parameters using PHP_QUERY_RFC3986.

#### Deprecations

* Deprecated the `FileSystem::mime()` method.
* Deprecated the `FileSystem::hash()` method.
* Deprecated the `FileSystem::hmac()` method.

#### Improvements

* Various improvements and optimizations.

> Check out the upgrade guide for details on how to upgrade from `5.6.*.`

--------------------------------------------------------

### 5.6.0 <small>(2018-10-15)</small>

#### New

* Added `Request::basePath()` method.
* Added `BelongsToPolymorphic` relation.
* Added `ORM::$isPersisted` property.
* Added `ORM::isPersisted()` method.
* Added `Query::sharedLock()` convenience method.
* It is now possible to use aggregate methods (`count`, `min`, `max`, etc...) in a subquery context.
* Migrations are now executed in a transaction if possible (Postgres, SQLite).
* Added multi database support to migrations.
* Added an option to opt out of atomic `getOrElse` for APCU caching. Use the `atomic_get_or_else` key.
* Added `ConnectionManager::close()` method.
* Added `ConnectionManager::executeAndClose()` method.
* Added `Connection::close()` method (to the database base connection class).
* Added new `json` validation rule.
* Added new `array` validation rule.
* You can now specify which IP version you're validating when using the `ip` validation rule.
* Added `FileSystem::rename()` method.
* It is now possible to set a custom timeout for Redis connections.
* Added new password hashing library:
	- Added new `Bcrypt` hasher class.
	- Added new `Argon2i` hasher class.
	- Added new `Argon2id` hasher class.

#### Changes

* Removed the global `--database` reactor option.

#### Deprecations

* Deprecated the `ORM::$exists` property.
* Deprecated the `ORM::exists()` method.
* Deprecated the `mako\security\Password` class.

#### Improvements

* Various improvements and optimizations.

> Check out the upgrade guide for details on how to upgrade from `5.5.*.`

--------------------------------------------------------

### 5.5.7 <small>(2018-06-14)</small>

#### Improvements

* The `Str::slug()` method no longer strips dashes from the input string.
* Added `hardware`, `software` and `furniture` to the list of irregular words used by `Str::pluralize()`.

--------------------------------------------------------

### 5.5.6 <small>(2018-05-23)</small>

#### Improvements

* Improved handling of invalid i18n keys.

--------------------------------------------------------

### 5.5.5 <small>(2018-05-11)</small>

#### Bugfixes

* Fixed issue where the `unique` rule would fail when used with case-insensitive databases.

--------------------------------------------------------

### 5.5.4 <small>(2018-04-07)</small>

#### Improvements

* You can now use `or` in addition to `||` when printing template variables.
* You can now prefix variable names with a `$` in template capture blocks.

--------------------------------------------------------

### 5.5.3 <small>(2018-03-22)</small>

#### Improvements

* The pagination factory no longer requires the view and http services.

--------------------------------------------------------

### 5.5.2 <small>(2018-03-21)</small>

#### New

* Added `Validator::rule()` helper method.

--------------------------------------------------------

### 5.0.25, 5.1.4, 5.2.12, 5.3.3, 5.4.1, 5.5.1 <small>(2018-03-20)</small>

#### Bugfixes

* Migrations will no longer fail with empty description.

--------------------------------------------------------

### 5.5.0 <small>(2018-03-20)</small>

#### New

* Added `Validator::extend()` method.
* Added `Validator::addRules()` method.
* Added `Validator::addRulesIf()` method.
* Added `ValidatorFactory::extend()` method.
* Added new validation rules:
	- Added `mimetype` rule.
	- Added `max_filesize` rule.
	- Added `is_uploaded` rule.

#### Changes

* Removed `Response` methods that where deprecated in 5.4:
	- Removed the `Response::header()` method.
	- Removed the `Response::hasHeader()` method.
	- Removed the `Response::removeHeader()` method.
	- Removed the `Response::clearHeaders()` method.
	- Removed the `Response::cookie()` method.
	- Removed the `Response::signedCookie()` method.
	- Removed the `Response::deleteCookie()` method.
	- Removed the `Response::hasCookie()` method.
	- Removed the `Response::removeCookie()` method.
	- Removed the `Response::clearCookies()` method.
* Removed `Validator::registerPlugin()` method.
* Removed `ValidatorFactory::registerPlugin()` method.

#### Improvements

* New and improved input validation with support for nested arrays and file validation.

> Check out the upgrade guide for details on how to upgrade from `5.4.*.`

--------------------------------------------------------

### 5.4.0 <small>(2018-03-05)</small>

#### New

* Added `Application::startTime()` method.
* The container now supports replacing previously registered/resolved items:
	- Added `Container::replace()` method.
	- Added `Container::replaceSingleton()` method.
	- Added `Container::replaceInstance()` method.
	- Added `Container::onReplace()` method.
* Added `Request::contentType()` method.
* Added `Response::reset()` method.
* Added `mako\cli\output\Output::hasAnsiSupport()` method.
* Added `mako\cli\output\Output::clearLine()` method.
* Added `mako\cli\output\Output::clearLines()` method.
* Added `mako\cli\output\formatter\Formatter::stripSGR()` method.
* Added `mako\cli\output\formatter\FormatterInterface::stripTags()` method.
* Added `mako\cli\output\helpers\ProgressBar::remove()` method.
* Added `mako\cli\output\helpers\ProgressBar::setPrefix()` method.
	- Added optional `$prefix` parameter to the `Command::progressBar()` method.
* Added optional `$priority` parameter to the `mako\http\routing\Dispatcher::registerMiddleware()` method.

#### Changes

* The `Container::factory()` method is now public.
* The `Request::getBody()` method now returns an instance of `mako\http\request\Body`.
* Removed `Request` methods that where deprecated in 5.3:
	- Removed the `Request::get()` method.
	- Removed the `Request::post()` method.
	- Removed the `Request::put()` method.
	- Removed the `Request::patch()` method.
	- Removed the `Request::delete()` method.
	- Removed the `Request::cookie()` method.
	- Removed the `Request::signedCookie()` method.
	- Removed the `Request::file()` method.
	- Removed the `Request::server()` method.
	- Removed the `Request::has()` method.
	- Removed the `Request::data()` method.
	- Removed the `Request::whitelisted()` method.
	- Removed the `Request::blacklisted()` method.
	- Removed the `Request::header()` method.
	- Removed the `Request::acceptableContentTypes()` method.
	- Removed the `Request::acceptableLanguages()` method.
	- Removed the `Request::acceptableCharsets()` method.
	- Removed the `Request::acceptableEncodings()` method.
* Removed `Response` filters:
	- Removed the `Response::filter()` method.
	- Removed the `Response::getFilters()` method.
	- Removed the `Response::clearFilters()` method.
* The `Response::getHeaders()` method now returns a response header collection.
* The `Response::getCookies()` method now returns a response cookie collection.
* Removed the `mako\cli\output\formatter\Formatter::hasAnsiSupport()` method.
* Removed the `mako\cli\output\formatter\FormatterInterface::strip()` method.
* Arguments are now converted to camel case before being passed to the `execute` method of reactor commands.

#### Deprecations

* Deprecated the `Response::header()` method.
* Deprecated the `Response::hasHeader()` method.
* Deprecated the `Response::removeHeader()` method.
* Deprecated the `Response::clearHeaders()` method.
* Deprecated the `Response::cookie()` method.
* Deprecated the `Response::signedCookie()` method.
* Deprecated the `Response::deleteCookie()` method.
* Deprecated the `Response::hasCookie()` method.
* Deprecated the `Response::removeCookie()` method.
* Deprecated the `Response::clearCookies()` method.

#### Improvements

* Unit tests now run using PHPUnit 6.
* Removed unnecessary function calls in Redis client.
* Various improvements and optimizations.

> Check out the upgrade guide for details on how to upgrade from `5.3.*.`

--------------------------------------------------------

### 5.3.2 <small>(2018-03-01)</small>

#### Improvements

* The `Request::getData()` method will now return the parsed body for POST requests that do not contain form data.

--------------------------------------------------------

### 5.3.1 <small>(2018-01-24)</small>

#### Bugfixes

* The `GD` image processor will no longer fail when using uppercase file extensions when saving.

#### Changes

* The `GD` image processor now uses `imagecopyresampled` instead of `imagecopyresized` when resizing images.

#### Improvements

* Columns with `null` values will no longer be updated unnecessarily when using `ORM::save()`.

--------------------------------------------------------

### 5.3.0 <small>(2018-01-10)</small>

#### New

* Added ```Connection::pairs()``` method.
* Added ```Query::pairs()``` method.
* Added ```Collection::merge()``` method.
* ```Collection::map()``` callables can now accept the item key as a second argument.
* ```Collection::filter()``` callables can now accept the item key as a second argument.
* It is now possible to auto assign variables to views using the ```ViewFactory::autoAssign()``` method.
* JSON responses can now set the response status code.
* It is now possible to capture output in a template using the new `{% capture:name %}...{% endcapture %}` blocks.
* Added `{% nospace %}...{% endnospace %}` blocks to template syntax that will remove all whitespace between HTML tags.
* Added `PaginationInterface::isValidPage()` method.
* Mako is now using Whoops for displaying exception details.
* It is now possible to register route constraints with the router.
* It is now possible to set and update junction attributes.
* Added `Request::getQuery()` method.
* Added `Request::getPost()` method.
* Added `Request::getHeaders()` method.
* Added `Request::getCookies()` method.
* Added `Request::getBody()` method.
* Added `Request::getData()` method.
* Added `Request::getFiles()` method.
* Added `Request::getServer()` method.
* Added `Parameters::whitelisted()` method.
* Added `Parameters::blacklisted()` method.

#### Changes

* Moved the `ContainerAwareTrait` trait to the `mako\syringe\traits` namespace.
* Moved the `ControllerHelperTrait` trait to the `mako\http\routing\traits` namespace.
* Moved the `ConfigurableTrait` trait to the `mako\common\traits` namespace.
* Moved the `ExtendableTrait` trait to the `mako\common\traits` namespace.
* Moved the `FunctionParserTrait` trait to the `mako\common\traits` namespace.
* Moved the `NamespacedFileLoaderTrait` trait to the `mako\common\traits` namespace.
* The `Str::slug()` method now uses `rawurlencode` instead of `urlencode`.
* All HTTP middleware must now implement the `mako\http\routing\middleware\MiddlewareInterface`.
* HTTP middleware is now registered with the route dispatcher.
* The `Route::when()` method has been renamed to `patterns`.
* Renamed the `Request::body()` method to `getRawBody`.
* Renamed the `Request::bodyAsStream` method `getRawBodyAsStream`.

#### Deprecations

* Deprecated the `Request::get()` method.
* Deprecated the `Request::post()` method.
* Deprecated the `Request::put()` method.
* Deprecated the `Request::patch()` method.
* Deprecated the `Request::delete()` method.
* Deprecated the `Request::cookie()` method.
* Deprecated the `Request::signedCookie()` method.
* Deprecated the `Request::file()` method.
* Deprecated the `Request::server()` method.
* Deprecated the `Request::has()` method.
* Deprecated the `Request::data()` method.
* Deprecated the `Request::whitelisted()` method.
* Deprecated the `Request::blacklisted()` method.
* Deprecated the `Request::header()` method.
* Deprecated the `Request::acceptableContentTypes()` method.
* Deprecated the `Request::acceptableLanguages()` method.
* Deprecated the `Request::acceptableCharsets()` method.
* Deprecated the `Request::acceptableEncodings()` method.

> Deprecated methods will be removed in 5.4.0.

> Check out the upgrade guide for details on how to upgrade from `5.2.*.`

--------------------------------------------------------

### 5.2.11 <small>(2017-11-30)</small>

#### Bugfixes

* Fixes issue that prevents accidental login after logout. The issue would occur if the `mako\gatekeeper\adapters\Session::getUser()` method got called after the `mako\gatekeeper\adapters\Session::logout()` method if the user had a "remember me" cookie.

--------------------------------------------------------

### 5.2.10 <small>(2017-11-18)</small>

#### Bugfixes

* The ```Memcache::putIfNotexists()``` and ```Memcached::putIfNotexists()``` methods will now support TTLs longer than 30 days.

--------------------------------------------------------

### 5.2.9 <small>(2017-10-26)</small>

#### Bugfixes

* Errors will now be logged even if the default error handler isn't called.

--------------------------------------------------------

### 5.2.8 <small>(2017-10-13)</small>

#### Bugfixes

* ```ManyToMany::synchronize()``` will no longer execute unnecessary and invalid queries that cause exceptions.

--------------------------------------------------------

### 5.2.7 <small>(2017-10-12)</small>

#### Bugfixes

* Package config overrides will now merge properly with original config.

--------------------------------------------------------

### 5.2.6 <small>(2017-10-11)</small>

#### Bugfixes

* Package config overrides now merges with original config.

--------------------------------------------------------

### 5.2.5 <small>(2017-10-07)</small>

#### New

* Now possible to insert databases rows with only default values.

--------------------------------------------------------

### 5.2.4 <small>(2017-09-21)</small>

#### New

* Added ```ManyToMany::alongWith()``` method.

--------------------------------------------------------

### 5.2.3 <small>(2017-08-22)</small>

#### Bugfixes

* Batch queries will no longer fail when having criteria.

--------------------------------------------------------

### 5.2.2 <small>(2017-08-16)</small>

#### Bugfixes

* Will now automatically unlock locked used accounts when the lock time has expired.

--------------------------------------------------------

### 5.2.1 <small>(2017-06-06)</small>

#### Bugfixes

* Fixed language cache bug that was introduced in 5.2.0.

--------------------------------------------------------

### 5.2.0 <small>(2017-05-08)</small>

#### New

* Added ```putIfNotexists()``` method to all cache adapters.
* The ```apcu```, ```memcached```, ```memory```, ```null``` and ```redis``` cache stores now implement the new ```mako\cache\stores\IncrementDecrementInterface``` interface.
* Added ```Collection::getValues()``` method.
* Added ```Collection::each()``` method.
* Added ```Collection::map()``` method.
* Added ```Collection::filter()``` method.
* It is now possible to pass custom PDO options to a connection.
* It is now possible to format numbers in i18n strings using the ```<number>``` tag.

#### Changes

* The ```Gatekeeper``` library has been rewritten. It is now possible to implement custom authentication adapters.
* The ```Gatekeeper::basicAuth()``` method will now always return a boolean value.
* Headers will now be set with the case that they where defined with.
* The ```CacheManager::instance()``` method now returns a ```mako\cache\stores\StoreInterface``` instance instead of a ```mako\cache\Cache``` instance.

#### Bugfixes

* The reactor ```--env``` flag now works as expected.

#### Improvements

* The ORM will now use fully qualified column names in the relation query criterion.
* Various improvements and optimizations.

> Check out the upgrade guide for details on how to upgrade from ```5.1.*.```

--------------------------------------------------------

### 5.1.3 <small>(2017-02-17)</small>

#### Bugfixes

* Request::getParsed() no longer fails if the content type header contains a character set.

--------------------------------------------------------

### 5.1.2 <small>(2017-01-25)</small>

#### Changes

* The function parser is now less strict when it comes to function names.

--------------------------------------------------------

### 5.1.1 <small>(2017-01-17)</small>

#### Changes

* JSONP responses are now handled by the JSON response builder.

--------------------------------------------------------

### 5.1.0 <small>(2017-01-16)</small>

#### New

* Added a optional ```NullableTrait``` to the ORM.
* Added ```Command::STATUS_SUCCESS``` constant.
* Added ```Command::STATUS_ERROR``` constant.
* Added ```cache.remove``` command.
* Added ```cache.clear``` command.
* Added ```application.base_url``` config key.
* Now possible to set middleware priority.
* The ORM now allows you to configure the foreign key name using the ```$foreignKeyName``` property.

#### Changes

* The response class will no longer auto render views. Views should be rendered in the controller.
* Removed the query convenience trait.
* Removed support for "piped" validation rules.
* New syntax for passing parameters to middleware.
* New syntax for passing parameters to validation rules.

#### Bugfixes

* ORM::getForeignKey() now uses Str::camel2underscored() instead of strtolower().

> Check out the upgrade guide for details on how to upgrade from ```5.0.*.```

--------------------------------------------------------

### 5.0.23 <small>(2017-01-01)</small>

#### Bugfixes

* Query compiler will now properly escape JSON path segments.
* MySQL query compiler will now unquote extracted JSON values.

--------------------------------------------------------

### 5.0.22 <small>(2016-12-28)</small>

#### New

* The query builder now supports set operations.
* Now possible to customize the width of progressbars.

#### Changes

* Deprecated the query convenience trait. It will be removed in Mako 5.1.0.

#### Bugfixes

* The image library will now show an error when trying to open a unsupported image type.

#### Improvements

* Various optimizations.

--------------------------------------------------------

### 5.0.21 <small>(2016-12-15)</small>

#### New

* Now possible to return a status/exit code from reactor commands.

--------------------------------------------------------

### 5.0.20 <small>(2016-12-12)</small>

#### Bugfixes

* Reverted breaking changes to compiled templates that were introduced in 5.0.17.

--------------------------------------------------------

### 5.0.19 <small>(2016-12-10)</small>

#### Bugfixes

* CLI error handler will no longer fail when displaying a generic error message.

--------------------------------------------------------

### 5.0.18 <small>(2016-12-07)</small>

#### New

* Now possible to update JSON values using the unified JSON query syntax.
* Now possible to bind parameters to raw SQL when using the query builder.

#### Improvements

* Various optimizations.

--------------------------------------------------------

### 5.0.17 <small>(2016-12-01)</small>

#### New

* Now possible to access route parameters outside route actions.

#### Bugfixes

* Migration rollback now works as expected.

#### Improvements

* Various optimizations.

--------------------------------------------------------

### 5.0.16 <small>(2016-11-24)</small>

#### Bugfixes

* Don't resolve singletons multiple times when using the container aware trait.

--------------------------------------------------------

### 5.0.15 <small>(2016-11-17)</small>

#### Bugfixes

* Fixed an issue where strict reactor commands would fail when called with a "global" option.

--------------------------------------------------------

### 5.0.14 <small>(2016-11-08)</small>

#### Bugfixes

* Fixed issue with ```Gatekeeper::forceLogin()```.

#### Improvements

* Error handler now supports ```xdebug.overload_var_dump```.

--------------------------------------------------------

### 5.0.13 <small>(2016-11-02)</small>

#### Bugfixes

* ```ORM::toArray()``` will no longer try to convert ```false``` to an array.

--------------------------------------------------------

### 5.0.12 <small>(2016-11-01)</small>

#### Bugfixes

* Corrected the return type of the ```View::assign()``` method.

--------------------------------------------------------

### 5.0.11 <small>(2016-10-14)</small>

#### Bugfixes

* The ```$shouldTouchOnInsert```, ```$shouldTouchOnUpdate``` and ```$shouldTouchOnDelete``` properties of the ```TimestampedTrait``` now work as expected.

#### Improvements

* The redis client now supports dash-separated commands.
* Checking a ORM relation with ```isset()``` will now lazy load it if it hasn't already been loaded.

--------------------------------------------------------

### 5.0.10 <small>(2016-10-11)</small>

#### Bugfixes

* The redis client will no longer assume that it has recieved the data it asked for.

--------------------------------------------------------

### 5.0.9 <small>(2016-10-11)</small>

#### Bugfixes

* The Redis client now reads data in 4096 byte chunks to avoid issues with large values.

--------------------------------------------------------

### 5.0.8 <small>(2016-10-11)</small>

#### Changes

* ```Request::file()``` now returns ```UploadedFile``` objects.

#### Bugfixes

* Redis cache store is now instantiated with the configured class whitelist.

--------------------------------------------------------

### 5.0.7 <small>(2016-10-08)</small>

#### New

* Added ```Connection::yield()``` and ```Query::yield()``` methods that allow you to iterate over result sets using a generator.

--------------------------------------------------------

### 5.0.6 <small>(2016-10-06)</small>

#### Bugfixes

* Fixed  ```Query::first()``` fetch mode bug.

--------------------------------------------------------

### 5.0.5 <small>(2016-10-06)</small>

#### Bugfixes

* Query pagination now works as expected with distinct selections.

#### Improvements

* ```Query::countDistinct()``` now supports an array of columns names.

--------------------------------------------------------

### 5.0.4 <small>(2016-10-05)</small>

#### Changes

* Simplified stack trace for JSON error responses.

--------------------------------------------------------

### 5.0.3 <small>(2016-10-05)</small>

#### Bugfixes

* Query pagination now works as expected with grouping.

--------------------------------------------------------

### 5.0.2 <small>(2016-10-05)</small>

#### Bugfixes

* The output escaper now accepts null values.

--------------------------------------------------------

### 5.0.1 <small>(2016-10-05)</small>

#### Bugfixes

* Fixed validation bug.

--------------------------------------------------------

### 5.0.0 <small>(2016-10-04)</small>

#### New

* The query builder now supports [row-level locking](:base_url:/docs/5.0/databases-sql:query-builder#row_level_locking).
* The query builder now has a [unified syntax for querying JSON fields](:base_url:/docs/5.0/databases-sql:query-builder#JSON_data).
* New and simplified [pagination functionality](:base_url:/docs/5.0/learn-more:pagination#usage_with_the_query_builder) when using the query builder.
* Added ```Query::havingRaw()``` method.
* Added ```Query::orHavingRaw()``` method.
* Added ```Query::columns()``` method.
* Added ```Query::countDistinct()``` method.
* Added support for [transaction savepoints](:base_url:/docs/5.0/databases-sql:basics#transactions:savepoints).
* Added ```Collection::extend()``` method.
* Added cluster support to the Redis client.
* Added IPv6 support to the Redis client.
* Added support for persistent connections to the Redis client.
* Now possible to define verbatim template blocks.
* Now possible to pass extra variables to included templates.
* Custom cache stores can be added using the ```CacheManager::extend()``` method.
* Custom encrypters can be added using the ```CryptoManager::extend()``` method.
* Added IPv4 and IPv6 utilities.
* You can now set a subnet when setting the IP adresses of trusted proxies.
* The character set will automatically be added to RSS and ATOM content-type headers.
* Added support for [contextual](:base_url:/docs/5.0/getting-started:dependency-injection#contextual_injection) dependency injection.
* You now have to whitelist the classes you want the framework to deserialize (cache and session stores).
* Added ```FileSystem::hash()``` method.
* Added ```FileSystem::hmac()``` method.
* Added ```app.generate_key``` command that can be used to generate secure encryption keys.
* Added unordered list CLI output [helper](:base_url:/docs/5.0/command-line:commands#output:helpers).
* Added ordered list CLI output [helper](:base_url:/docs/5.0/command-line:commands#output:helpers).
* Added ```Output::clear()``` [method](:base_url:/docs/5.0/command-line:commands#output:helpers).
* Reactor will now suggest a task or option name if an invalid one is used.
* Added support for [strict](:base_url:/docs/5.0/command-line:commands#basics:arguments-and-options) commands.
* Added FireTrait that makes it easier to [call a command from within a command](:base_url:/docs/5.0/command-line:commands#calling_commands_from_commands).

#### Changes

* ```Query::null()``` has been renamed to ```Query::isNull()```.
* ```Query::orNull()``` has been renamed to ```Query::orIsNull()```.
* ```Query::notNull()``` has been renamed to ```Query::isNotNull()```.
* ```Query::orNotNull()``` has been renamed to ```Query::orIsNotNull()```.
* ```Query::all()``` now returns a [result set](:base_url:/docs/5.0/databases-sql:query-builder#fetching_data) instead of an array.
* ORM read-only functionality is now handled using a trait.
* The ```ORM::isReadOnly()``` method has been removed.
* ORM records will no longer be made read-only when using joins.
* ORM values can now be [casted](:base_url:/5.0/databases-sql:orm#automatic_typecasting:scalars) to intergers using `int` instead of `integer`.
* ORM values can now be [casted](:base_url:/5.0/databases-sql:orm#automatic_typecasting:scalars) to booleans using `bool` instead of `boolean`.
* An exception will be thrown when trying to get a non-existing item from collection.
* The ```HTML::registerTag()``` method has been removed. Use ```HTML::extend()``` instead.
* Routing [middleware](:base_url:/docs/5.0/routing-and-controllers:routing#route_middleware) replaces route filters.
* The ```Routes::methods()``` method has been renamed to ```Routes::register()```.
* The ```Route::setNamespace()``` method has been renamed to ```Route::namespace()```.
* The ```Controller::beforeFilter()``` has been renamed to ```Controller::beforeAction()```.
* The ```Controller::afterFilter()``` has been renamed to ```Controller::afterAction()```.
* Custom view renderers must now be added using the ```ViewFactory::extend()``` method.
* Removed the ```APC``` and ```XCache``` cache stores.
* Removed the ```Response::file()``` method.
* Removed the ```Response::stream()``` method.
* Removed the ```Response::redirect()``` method .
* Removed the ```Response::back()``` method.
* Added a [ControllerHelperTrait](:base_url:/docs/5.0/routing-and-controllers:controllers#controller_helpers) with the following methods: ```fileResponse```, ```streamResponse```, ```redirectResponse```, ```jsonResponse``` and ```jsonpReponse```.
* Removed the MCRYPT encrypter.
* Removed the ```Crypto::encryptAndSign()``` and ```Crypto::validateAndDecrypt()``` methods. All encrypted data is now signed and validated by default.
* Renamed ```FileSystem::includeFile()``` to ```FileSystem::include()```.
* Renamed ```FileSystem::requireFile()``` to ```FileSystem::require()```.
* Renamed ```FileSystem::includeFileOnce()``` to ```FileSystem::includeOnce()```.
* Renamed ```FileSystem::requireFileOnce()``` to ```FileSystem::requireOnce()```.
* Renamed ```FileSystem::isDirectoryEmpty()``` to ```FileSystem::isEmpty()```.
* Renamed ```FileSystem::exists()``` to ```FileSystem::has()```.
* Renamed ```FileSystem::delete()``` to ```FileSystem::remove()```.
* Renamed ```FileSystem::getContents()``` to ```FileSystem::get()```.
* Renamed ```FileSystem::putContents()``` to ```FileSystem::put()```.
* Renamed ```FileSystem::prependContents()``` to ```FileSystem::prepend()```.
* Renamed ```FileSystem::appendContents()``` to ```FileSystem::append()```.
* Renamed ```FileSystem::truncateContents()``` to ```FileSystem::truncate()```.

#### Improvements

* Miscellaneous improvements and optimizations.

> Mako 5.0 is a major version update that contains a few minor breaking changes. Make sure to read the upgrade instructions!

--------------------------------------------------------

### 4.5.14 <small>(2016-08-30)</small>

#### Bugfixes

* Fixed the docblock return type for ```CacheManager::instance()```.

--------------------------------------------------------

### 4.5.13 <small>(2016-08-09)</small>

#### Improvements

* ```Container::call()``` now supports function calls in addition to closure and method calls.

--------------------------------------------------------

### 4.5.12 <small>(2016-08-02)</small>

#### Bugfixes

* ```URLBuilder::toRoute()``` will now allow falsy parameters (0, 0.0, '0').

--------------------------------------------------------

### 4.5.11 <small>(2016-06-29)</small>

#### Bugfixes

* Fixed a leap year related bug in the ```Time``` class.

#### Improvements

* Less restrictive version requirements of third party libraries.

--------------------------------------------------------

### 4.5.10 <small>(2016-02-03)</small>

#### Improvements

* Cache will now throw an exception if the store is unavailable.

--------------------------------------------------------

### 4.5.9 <small>(2015-11-26)</small>

#### Bugfixes

* ETag caching will now work as expected when using mod_deflate with Apache > 2.4.0.

#### Improvements

* Better support for routes containing multibyte characters.

--------------------------------------------------------

### 4.5.8 <small>(2015-11-17)</small>

#### Improvements

* PHP7 compatibility.

--------------------------------------------------------

### 4.5.7 <small>(2015-11-04)</small>

#### Bugfixes

* The query builder can now generate working SQLite queries with an ```IN``` clause where the values come from a subquery.
* The ```before``` and ```after``` validation filters will now work as expected.

#### Improvements

* The query builder now supports joins with nested conditions.

--------------------------------------------------------

### 4.3.5, 4.4.6 <small>(2015-11-04)</small>

#### Bugfixes

* The ```before``` and ```after``` validation filters will now work as expected.

--------------------------------------------------------


### 4.5.6 <small>(2015-09-11)</small>

#### Improvements

* Only include ```pages``` array in pagination data when ```max_page_links``` > 0.

--------------------------------------------------------

### 4.5.5 <small>(2015-07-08)</small>

#### Bugfixes

* Clean URLs should now work as expected when using the local development server.

--------------------------------------------------------

### 4.5.4 <small>(2015-06-17)</small>

#### Bugfixes

* The progress bar will no longer fail when ```0``` is passed as the item count.

#### Improvements

* Better parameter binding for prepared statements.

> This update requires you to change the data type of the ```users.banned``` and ```users.activated``` fields from ```SET``` to ```BOOL``` (or ```TINYINT(1)```).

--------------------------------------------------------

### 4.5.3 <small>(2015-05-07)</small>

#### Changes

* The ```Pagination::paginate()``` method is now public.

--------------------------------------------------------

### 4.5.2 <small>(2015-04-24)</small>

#### Bugfixes

* Eager loading criteria now work as expected when eager loading in chunks.

--------------------------------------------------------

### 4.5.1 <small>(2015-04-20)</small>

#### Bugfixes

* Now possible to eager load more than 1000 unique ids when using SQLite and Oracle ([#151](https://github.com/mako-framework/framework/issues/151)).

--------------------------------------------------------

### 4.5.0 <small>(2015-04-15)</small>

#### New

* Now possible to send multiple headers with the same field-name.
* Added ```Request::getRoute()``` method.
* Added ```Response::hasHeader()``` method.
* Added ```Response::hasCookie()``` method.
* Added ```Response::removeCookie()``` method.
* Added ```Image::getHeight()``` method.
* Added ```Image::getWidth()``` method.
* Added ```Image::getDimensions()``` method.
* Added brute force throttling to the Gatekeeper library.
* Added a command bus library [#138](https://github.com/mako-framework/framework/pull/138).
* New and improved event handler.

#### Changes

* ```Str::slug()``` will now encode non-ascii characters as recommened by [RFC-3986](http://www.rfc-archive.org/getrfc.php?rfc=3986).
* Minor changes in the application and package directory structures.
* Added brute force throttling settings to the ```app/config/gatekeeper.php``` configuration file.
* Added 3 new fields to the gatekeeper users table.

#### Improvements

* Now possible to select a custom set of columns through a many-to-many relation.
* Various optimizations.

> This release comes with a few minor breaking changes. Check out the migration guide [here](:base_url:/docs/4.5/getting-started:upgrading).

--------------------------------------------------------

### 4.4.5 <small>(2015-03-06)</small>

#### Bugfixes

* Fixed bug in ```app.routes``` command.

--------------------------------------------------------

### 4.3.4, 4.4.4 <small>(2015-02-19)</small>

#### Bugfixes

* Fixed language cache issue.

--------------------------------------------------------

### 4.4.3 <small>(2015-02-04)</small>

#### Improvements

* ```Query::column()``` and ```Query::first()``` will now generate a more optimized query.

--------------------------------------------------------

### 4.4.2 <small>(2015-02-03)</small>

#### Improvements

* The command line error handler will now include the error location in the output.

--------------------------------------------------------

### 4.4.1 <small>(2015-02-02)</small>

#### New

* Added ```Output::setFormatter()``` method.
* Added ```Output::isMuted()``` method.

#### Bugfixes

* The redis client will no longer try to authenticate when no password is provided.

#### Improvements

* Controllers no longer need to extend the Mako base controller.
* Global reactor options are now sorted alphabetically.
* You can now separate package booting into ```core```, ```web``` and ```cli```.

> This update requires a [small change](https://github.com/mako-framework/app/blob/master/app/config/application.php#L188) to the ```app/config/application.php``` configuration file.

--------------------------------------------------------

### 4.4.0 <small>(2015-01-26)</small>

#### New

* Brand new reactor command line tool.
* Added optional ```$column``` parameter to the ```Query::column()``` method.
* Added Mako core class.
* Added ```Password::needsRehash()``` method.
* Added ```Request::isSafe()``` method.
* Added ```Session::getToken()``` method.
* Added ```Session::regenerateToken()``` method.
* Added ```Session::validateToken()``` method.
* Added ```token``` validation rule.
* Gatekeeper will automatically rehash passwords if needed.
* Added ```attribute```, ```css```, ```url``` and  ```js``` escaping filters.
* Escape filters are now also available in plain PHP views.

#### Changes

* Moved ```init.php``` file from the framework core to the application.
* Removed the ```MAKO_VERSION``` constant (use ```Mako::VERSION``` instead).
* Removed the ```Password::isLegacyHash()``` method.
* Removed the ```$legacyCheck``` parameter from the ```Password::validate()``` method.
* Renamed ```Session::generateToken()``` method to ```Session::generateOneTimeToken```.
* Renamed ```Session::validateToken()``` method to ```Session::validateOneTimeToken```.
* Renamed ```token``` validation rule to ```one_time_token```.

> This release comes with a few minor breaking changes. Check out the migration guide [here](:base_url:/docs/4.4/getting-started:upgrading).

--------------------------------------------------------

### 4.0.11, 4.1.5, 4.2.3, 4.3.3 <small>(2015-01-19)</small>

#### Bugfixes

* Gatekeeper will use the provided "auth_key" configuration value.

--------------------------------------------------------

### 4.3.2 <small>(2014-12-07)</small>

#### Bugfixes

* Fixed validation bug.

--------------------------------------------------------

### 4.3.1 <small>(2014-12-02)</small>

#### Bugfixes

* Fixed routing bug.

--------------------------------------------------------

### 4.3.0 <small>(2014-11-27)</small>

#### New

* Added ```ViewFactory::exists()``` method.
* Views are now cascading. This means that you can override package views in your application.
* Language files are now cascading. This means that you can override package language files in your application.
* Mako now includes default 403, 404, 405 error views that can easily be overriden.
* The ORM will now also forward non-static calls to the query builder.
* Added ```Connection::table()``` convenience method.
* Added ```Container::call()```  method ([#116](https://github.com/mako-framework/framework/pull/116)).
* Route actions are now executed by the ```Container::call()``` method ([#118](https://github.com/mako-framework/framework/pull/118)).
* Route filters are now executed by the ```Container::call()``` method ([#119](https://github.com/mako-framework/framework/pull/119)).
* Added a session NULL store.

#### Changes

* Moved all http exceptions to the ```mako\http\exceptions``` namespace.
* Renamed the ```PageNotFoundException``` to ```NotFoundException```.
* Controllers, Tasks and Migrations now use the ```ContainerAwareTrait``` trait by default.
* The ```ORM::builder()``` method is now public.
* The ```Route::constraints()``` method has been renamed to ```Route::when()```.

> This release comes with a few minor breaking changes. Check out the migration guide [here](:base_url:/docs/4.3/getting-started:upgrading).

--------------------------------------------------------

### 4.0.10, 4.1.4, 4.2.2 <small>(2014-11-21)</small>

#### Bugfixes

* Fixed query builder bug.

--------------------------------------------------------

### 4.0.9, 4.1.3, 4.2.1 <small>(2014-11-14)</small>

#### Bugfixes

* Fixed MCrypt autoloading issue ([#120](https://github.com/mako-framework/framework/issues/120)).

--------------------------------------------------------

### 4.2.0 <small>(2014-09-26)</small>

#### New

* Added ```Time::formatLocalized``` method.
* Added ```TimeZone``` class.
* Added a Stopwatch class ([#113](https://github.com/mako-framework/framework/pull/113)).
* Added support for nested template extension.
* Added optional migration descriptions.
* Added ```render``` shortcut method to the view factory class.
* It is now possible to configure Gatekeeper to identify users using their username instead of their email.

#### Changes

* The ```Time``` class has been moved to the to ```mako\chrono``` namespace.
* The ```locale``` config option has been removed. You now have to set the appropriate locale for each language instead.
* The ```ViewFactory::create``` method will now return an instance of ```mako\view\View``` instead of an implementation of ```mako\view\renderers\RendererInterface```.
* Moved ```app/routes.php``` to ```app/routing/routes.php```.
* Filters must now be defined in ```app/routing/filters.php```.
* You can now use class filters in addition to closures.
* The ```UrlBuilder::current``` method will now include the current query parameters by default.
* Default Mcrypt encryption mode changed from ECB to CBC.
* Removed the ```app/packages``` directory. Packages will now be installed in the packagist vendor directory.
* Removed the global helper functions. They have been replaced with a trait and a class (NamespacedFileLoaderTrait and ClassInspector).

> This release comes with a few minor breaking changes. Check out the migration guide [here](:base_url:/docs/4.2/getting-started:upgrading).

--------------------------------------------------------

### 4.1.2 <small>(2014-09-05)</small>

#### Bugfixes

* Fixed issue with date casting in the ORM.

--------------------------------------------------------

### 4.0.8, 4.1.1 <small>(2014-09-01)</small>

#### Bugfixes

* Added missing returns in gatekeeper user implementation.

--------------------------------------------------------

### 4.1.0 <small>(2014-08-20)</small>

#### New

* Added sepia filter to the image library.
* Added negate filter to the image library.
* Added pixelate filter to the image library.
* Added brightness adjustment to the image library.
* Added sharpening to the image library.
* Now possible to create and restore temporary snapshots when using the image library.
* Added support for language caching.
* Added Connection::isAlive() method.
* Added Connection::reconnect() method.
* Added Connection::beginTransaction() method.
* Added Connection::commitTransaction() method.
* Added Connection::rollBackTransaction() method.
* Added Connection::getTransactionNestingLevel() method.
* Added Connection::inTransaction() method.
* It is now possible to configure the ORM to automatically typecast values.
* PageNotFoundExceptions now includes the request method and path ([#108](https://github.com/mako-framework/framework/pull/108)).
* Now possible to register custom view renderers without having to implement a custom view factory.
* Added Application::isCommandLine() method.
* Added ErrorHandler::disableLoggingFor() method.

#### Changes

* The logger and errorHandler services are no longer required for an application to work.
* Removed the the ORM::$dateTimeColumms property. Use the new typecast feature instead.
* Selecting specific columns when using the ORM will no longer make the records read-only. Joining however, will do.

> You must also add the ```language_cache``` key to your [application configuration](https://github.com/mako-framework/app/blob/master/app/config/application.php#L61) file.

--------------------------------------------------------

### 4.0.7 <small>(2014-08-18)</small>

#### New

* Now possible to configure the date output format when converting ORM records to array and/or json.

#### Bugfixes

* Escape exception message in debug template.

--------------------------------------------------------

### 4.0.6 <small>(2014-08-5)</small>

#### Improvements

* Improved ORM::toArray() and ORM::toJson methods.

--------------------------------------------------------

### 4.0.5 <small>(2014-07-24)</small>

#### Bugfixes

* Fixed bug in the file based cache store.

--------------------------------------------------------

### 4.0.4 <small>(2014-07-04)</small>

#### Bugfixes

* Image library now uses the correct image quality when saving.
* Image library watermarking now works as expected.

--------------------------------------------------------

### 4.0.3 <small>(2014-07-02)</small>

#### Improvements

* The error handler is no longer loading external JavaScript libraries.

--------------------------------------------------------

### 4.0.2 <small>(2014-07-01)</small>

#### Changes

* Namespaced the helper functions to avoild naming collisions with global functions.

#### Bugfixes

* Added ```mako\get_class_traits()``` helper function to improve detection of trait usage.

--------------------------------------------------------

### 4.0.1 <small>(2014-06-26)</small>

#### Bugfixes

* Fixed bug where User::isMemberOf would return NULL if group id was used instead of group name.

--------------------------------------------------------

### 4.0.0 <small>(2014-06-26)</small>

Mako 4.0.0 is a complete rewrite where the main focus has been on improving testability, extensibility, security and the overall quality of the framework.

Mako 4 also includes a bunch of new features. Here are some of them:

* A new and improved RESTful routing system
* A brand new authentication library
* A smart and easy to use dependecy injection container
* Timestamped and OptimisticLocking traits for the ORM
* An image manipulation library that supports both GD and ImageMagick

[_Check out the documentation for the full list of changes_](:base_url:/docs/4.0).

> Note that this is ```NOT``` a one step upgrade but the API changes have been kept to a minimum so upgrading a project from Mako 3.6.x shouldn't pose too many problems.