среда, 9 февраля 2011 г.

Kohana 3.1: Руководство по обновлению и миграции

Изменения в классе Request

Класс Request был разделён на два класс Request и Response. Для установки ответа вы использовали:

$this->request->response = 'foo';

Оно было изменено на:

$this->response->body('foo');

Некоторые свойста существовавшие в классе Request были преобразованы в методы класса:

Request::$controller -> Request::controller()
Request::$action -> Request::action()
Request::$directory -> Request::directory()
Request::$uri -> Request::uri()

Request::instance() был заменен на Request::current() и Request::initial(). Обычно вы будете использовать Request::current(), но если вы уверены что хотите оригинальный запрос (когда запущен HMVC), используйте Request::initial()


Изменения в классе Validation

Класс проверки был улучшен для включения поддержки "контекста", из-за этого изменился API. Кроме того класс был разделён: ядро логики проверки теперь отделено от встроенных правил проверки. Новый класс ядра называется Validation, а правила расположены в классе Valid.


Проверка контекста

Класс проверки теперь содержит поддержку "контекста". Это позволило объединить методы rule() и callback(), и в теперь это просто метод rule() который может использоваться в обоих случаях.

Старый вариант использования:

rule('password', 'matches', array('repeat_password'))

Новый вариант использования:

rule('password', 'matches', array(':validation', 'password', 'repeat_password'))

Третий параметр содержит все параметры которые должны пройти проверку правилом. Если взглянуть на Valid::matches(), то увидим:

public static function matches($array, $field, $match)

:validation первый параметр, 'password' - второй (поле которое мы хотим проверить) и 'repeat_password' это третье (которое мы хотим сравнить)

:validation это специальная переменная "контекста" которая указывает классу Validation о замене текущего класса проверки. Таким образом правила matches() не отличаются от callback() в работе, но более мощные. Есть и другие контекстные переменные:

:validation - Объект проверки

:field - Имя поля (rule('username', 'min_length', array(':field', 4)))

:value - Значение поля

Можно использовать любую php функцию, если она возвращает логическое значение.


Куки salt

Класс Cookie вызывает исключение, если salt не установлена, по умолчанию salt не установлена. Вы должны убедиться, что установили salt в файле инициализации (bootstrap.php):

Cookie::$salt = 'foobar';

Или определить расширение класса Cookie в вашем приложении:

class Cookie extends Kohana_Cookie
{
    public static $salt = 'foobar';
}

Изменение конструктора контроллера

Если по какой-то причине вы хотите изменить свой конструктор контроллера, он изменился на:

public function __construct(Request $request, Response $response)

Изменения index.php и bootstrap.php

Основным изменением стало удаление запроса из bootstrap.php и перенос его в index.php. Это позволит использовать один файл инициализации для выполнения тестирования. Причина изменения в том, что инициализации выполняет только установку среды, она не должна запускать её.


Обработка 404

Теперь Kohana имеет встроенную поддержку исключения для 404 и других кодов статуса HTTP. Если вы использовали ReflectionException для обнаружения 404, то сейчас должны использовать Http_Exception_404. Подробности обработка ошибок

Kohana 3.1

Вышел новый релиз фреймворка Kohana 3.1. Вместе со сменой версии произошли изменения API, поэтому необходимо провести миграцию приложений на новый API, если вы хотите использовать его для существующих приложений.

  1. Скачать
  2. Изменения
  3. Руководство пользователя

Также следует отметить, что этот релиз означает начало конца поддержки 3.0.x. В течении 6 месяцев в 3.0.x не будет исправлений ошибок и новых релизов. Когда выйдет 3.2.0 (летом 2011), 3.0.x больше не будет поддерживаться, 3.1.x будет поддерживаться в течении одного года, после этого релиза (выход 3.3.0 будет означать конец поддержки 3.1.x)

Кроме того, есть руководство по обновлению/миграции включающее в себя большую часть информации, возможно некоторые не существенные детали там отсутствуют.

суббота, 5 февраля 2011 г.

Kohana 3: Работа с моделью

Мы уже более-менее разобрались с двумя компонентами архитектуры MVC, остался третий M - Model (Модель).

Модель - это PHP класс предназначенный для работы с информацией предоставленной или запрошенной контроллером. Например у вас есть гостевая книга, контроллер передаёт запрос в модель на получение последних десяти записей, модель возвращает эти записи контроллеру, который может передать эти данные в отображение. Контроллер так же может посылать новые записи в модель, обновлять или удалять существующие.

Проще говоря, модель занимается обработкой и управлением данными.