Mathew Davies home

Upgrading Kohana 3.0 to 3.1

Last updated on Sunday the 16th of January 2011

Common things to look out for when upgrading from Kohana 3.0 to 3.1

Auth

Hashing is now done with hash_hmac. This will break all your current logins. To upgrade your user passwords, use the old function to check their passwords. If they match, generate a new hash.
The ORM driver has been moved into the ORM module.

Controller

The constructor takes 2 arguments (Request $request, Response $response) over just (Request $request)

Core

Kohana::exception_handler($e) has been moved to Kohana_Exception::handler($e)

ORM

save() and check() now have a Validation argument, make sure you update any child classes to ensure you don’t break strict compatibility.
Rules, filters and labels are now defined in public functions (rules, filters and labels) which return an array.
A DB group is now specified with $_db_group over $_db

Request

$this->request->controller, action, directory are now methods: $this->request->controller(), action(), directory()
A response is set with: $this->response->body('content') over $this->request->response = 'content';
A new set of exceptions has been created to deal with http errors. They range from Http_Exception_400 to Http_Exception_505

Validation

Validate has been split into two classes: Valid and Validation. The former houses all the rules and the latter has the logic for checking, messages, etc …
filter() no longer exists. Either filter manually or use Arr::map if you need to filter on all values.

<?php
// Filtering post values using a lambda function.
Arr::map(function($value)
{
	return trim($value);
},
$_POST);

callback() has gone. Instead, rule()'s 2nd argument can take any valid PHP callback. The 3rd argument is an array containing the arguments to pass to the callback.

<?php $validation->rule('email', array($this, 'email_available'), array(':validation', ':field'));

Callback syntax has changed from array('function' => $params) to array('function', $params).

Changelog

Sun 16 Jan 2011 - Initial version