Upgrading from 4.4.3 to 4.4.4

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

Mandatory File Changes
- Error Files
Breaking Changes
- Validation with Dot Array Syntax
- Validation rules matches and differs
Breaking Enhancements
Project Files
- Content Changes
- All Changes

Mandatory File Changes 

Error Files 

Update the following files to show correct error messages:

app/Views/errors/cli/error_exception.php
app/Views/errors/html/error_exception.php

Breaking Changes 

Validation with Dot Array Syntax 

If you are using dot array syntax in validation rules, a bug where * would validate data in incorrect dimensions has been fixed.

In previous versions, the rule key contacts.*.name captured data with any level like contacts.*.name, contacts.*.*.name, contacts.*.*.*.name, etc., incorrectly.

The following code explains details:

use Config\Services;

$validation = Services::validation();

$data = [
    'contacts' => [
        'name' => 'Joe Smith',
        'just' => [
            'friends' => [
                ['name' => 'SATO Taro'],
                ['name' => 'Li Ming'],
                ['name' => 'Heinz Müller'],
            ],
        ],
    ],
];

$validation->setRules(
    ['contacts.*.name' => 'required|max_length[8]']
);

$validation->run($data); // false

d($validation->getErrors());
/*
 Before: Captured `contacts.*.*.*.name` incorrectly.
 [
   contacts.just.friends.0.name => "The contacts.*.name field cannot exceed 8 characters in length.",
   contacts.just.friends.2.name => "The contacts.*.name field cannot exceed 8 characters in length.",
 ]

 After: Captures no data for `contacts.*.name`.
 [
   contacts.*.name => string (38) "The contacts.*.name field is required.",
 ]
*/

If you have code that depends on the bug, fix the the rule key.

Validation rules matches and differs 

Because bugs have been fixed in the case where matches and differs in the Strict and Traditional rules validate data of non-string types, if you are using these rules and validate non-string data, the validation results might be changed (fixed).

Note that Traditional Rules should not be used to validate data that is not a string.

Breaking Enhancements 

Project Files 

Some files in the project space (root, app, public, writable) received updates. Due to these files being outside of the system scope they will not be changed without your intervention.

There are some third-party CodeIgniter modules available to assist with merging changes to the project space: Explore on Packagist.

Content Changes 

The following files received significant changes (including deprecations or visual adjustments) and it is recommended that you merge the updated versions with your application:

Config

@TODO

All Changes 

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

@TODO