Upgrading

• Cache
• Commands
• Crypto
• Database
  • Connection
  • ORM
• Error handling
• Routing
  • Access Control middleware
• Validation
  • Custom rules
  • Renamed rules

This guide takes you through the steps needed to migrate from Mako 7.3.x to 8.0.x.

Mako 8.0 drops support for PHP version 7.3 and requires PHP version 7.4 or higher so make sure that your environment is up to date.

Cache

The deprecated CacheManager::instance() method has been removed. Use the CacheManager::getInstance() or CacheManager::getStore() methods instead.

// Before

$cache = $this->cache->instance();

// Now

$cache = $this->cache->getInstance();

// Or

$cache = $this->cache->getStore();

Commands

The following reactor commands have been renamed:

Crypto

The deprecated CryptoManager::instance() method has been removed. Use the CryptoManager::getInstance() or CryptoManager::getEncrypter() methods instead.

// Before

$cache = $this->crypto->instance();

// Now

$cache = $this->crypto->getInstance();

// Or

$cache = $this->crypto->getEncrypter();

Database

Connection

The deprecated Connection::builder() method has been removed. Use the Connection::getQuery() method instead.

// Before

$query = $connection->builder();

// Now

$query = $connection->getQuery();

The deprecated Connection::table() method has been removed. It does not have direct replacement.

// Before

$query = $connection->table('foobar');

// Now

$query = $connection->getQuery()->table('foobar');

ORM

The deprecated ORM::builder() method has been removed. Use the ORM::getQuery() method instead.

// Before

$query = (new ORM)->builder();

// Now

$query = (new ORM)->getQuery();

Error handling

The mako\http\exceptions\HttpException exception has been renamed to mako\http\exceptions\HttpStatusException. Make sure to update your list of ignored exceptions in the application.php configuration file.

Routing

The deprecated Route::namespace() has been removed along with the deprecated namespace route group option. Route class method actions should now be registered as arrays instead of strings.

<?php

// Before

$routes->group(['namespace' => 'app\controllers'], function($routes)
{
    $routes->get('/', 'Index::welcome');
});

<?php

// Now

use app\controllers\Index;

$routes->get('/', [Index::class, 'welcome']);

Access Control middleware

The deprecated AccessControlAllowOrigin middleware has been removed and replaced by the new and improved AccessControl middleware.

Validation

Custom rules

The RuleInterface::validate() method now has 3 parameters instead of 2.

// Before

public function validate($value, array $input): bool;

// Now

public function validate($value, string $field, array $input): bool;

Renamed rules

The following input validation rules have been renamed: