Изучаем Web » db

Ko3: знаете ли вы? Часть 2

biakaveron — Wed, 11 Nov 2009 07:24:26 +0000

Продолжаю публиковать полезные (надеюсь) приемы в Ko3.

Мучаетесь с роутингом? Непонятно, будет ли отрабатывать новый маршрут? Вам в помощь метод matches($uri) класса Route. Он принимает на входе тестируемый URI, а возвращает либо FALSE (если адрес не проходит через условия маршрута), либо массив с найденными параметрами (controller, action и прочие).
Есть разница между $this->request->uri() и $this->request->route->uri(). Оба они используют текущий маршрут, но в первом случае по умолчанию будут использованы текущие параметры запроса (контроллер и экшен), а вот во втором – те, что были указаны в методе default() при добавлении маршрута. Таким образом, первый вариант удобен для минимальной корректировки текущего URL (смена id или другого дополнительного аргумента), а второй – для модификации адреса в рамках целого маршрута.
Если в вашем контроллере добавлены методы before() и after(), не забывайте вызывать в них parent::before() и parent::after(), соответственно в начале и конце метода. Особенно это касается контроллеров-потомков Controller_Template, т.к. в них указанные методы используются для инициализации и вывода основного шаблона $this->template.
Хотите, чтобы все генерируемые внешние ссылки открывались в новом окне? Используйте свойство HTML::$windowed_urls. После установки его значения в TRUE все внешние ссылки (т.е. абсолютные ссылки, с явно указанным протоколом, например HTTP://) будет сгенерированы с атрибутом target='_blank'. Например:
// выводим ссылки на дружественные блоги HTML::$windowed_urls = TRUE; foreach($links as $title => $link) echo HTML::anchor($link, $title)." "; // меняем значение обратно, может пригодиться HTML::$windowed_urls = FALSE;

Замечу, что установка атрибута target не очень приветствуется, т.к. поведение таких ссылок непредсказуемо для пользователя.
Очень часто вместо унылых дат вида “15.10.2009″ показывают, сколько времени прошло (так сделано на оф. форуме Kohana, к примеру). Можно вычислять их вручную, а можно использовать “неточный” метод date::fuzzy_span($timestamp). Он смотрит разницу между текущим временем и переданным в $timestamp (в формате UNIX timestamp, т.к. количество прошедших секунд), и на основании этого выдает фразу типа “меньше суток назад” или “только что”. Даже есть поддержка будущего (“менее, чем через сутки” или “через пару минут”). Конечно, возвращается строчка на английском, для которой придется делать перевод и выводить результат через __(). Полный перечень возможных значений можно подсмотреть в исходном коде данного метода (не забудьте, что к строке добавляется префикс ‘in ‘ или суффикс ‘ ago‘, в зависимости от того, наступило событие или еще нет).
Метод DB::query($type, $sql) предполагает передачу типа запроса (например ‘select‘) первым параметром. Пусть Вас не смущает наличие констант DB::SELECT, DB::INSERT, DB::UPDATE и DB::DELETE – использовать можно любое значение, даже NULL.

Ko3: знаете ли вы? Часть 1

biakaveron — Wed, 07 Oct 2009 07:47:37 +0000

Иногда в голове мелькает мысль, “а ведь это неочевидно/полезно/любопытно“, но целый пост на эту тему писать бессмысленно. Поэтому буду периодически публиковать такие вот “выхлопы” с накопившимися заметками. Ниже – первая пачка из данной серии.

“Ленивая загрузка” в ORM позволяет делать дополнительную фильтрацию после обращения к “множественным” свойствам модели. Например, так мы отфильтруем неподтвержденные комментарии к записи в блоге, а также отберем только второй десяток из них:
$comments = ORM::factory('blog', 1)->comments ->where('is_confirmed', '=', 1) ->limit(10) ->offset(10) ->find_all();
На все это уйдет только один запрос, т.к. он теперь формируется только после явного вызова find_all().
Так как библиотеки Input теперь нет, очищать данные от XSS придется самостоятельно (Security::xss_clean() вам в руки, можно добавить как фильтр в Validate). Автоматически Ko3 лишь убирает лишние слэши (т.е. можем не думать о magic_quote_qpc) и все переводы строк приводит к единому виду (“\n“). Если надо обратиться к глобальной переменной, но есть сомнения в ее существовании, можно использовать метод arr::get(), он поддерживает установку значения по умолчанию. Например, так: arr::get($_POST, 'text', '');
Список подключенных модулей может быть откорректирован в любой точке приложения. Метод Kohana::modules($modules) заново подключит все модули, указанные в массиве $modules. При этом ранее подключенные модули будут отброшены. Если вызвать метод без параметров, он вернет текущий список активных модулей. Таким образом, можно на лету подключить модуль X:
Kohana::modules(arr::merge(Kohana::modules(), array('x' => MODPATH.'x'))). Пути для автозагрузки классов будут заново просчитаны, так что можно добиться изменения порядка активации модулей в списке (это играет роль при работе каскадной файловой системы Kohana).

Насчет возможной двойной отработки файлов init.php не волнуйтесь – они подгружаются через require_once(). Тем не менее, сама по себе функция довольно затратная, не стоит ее вызывать бездумно.
Можно кэшировать отдельные участки страницы с помощью класса Fragment:
if ( ! Fragment::load('some_page', 100)) { echo View::factory('some_page_view'); Fragment::save(); }

В данном случае мы проверяем наличие кэшированной версии по ключу ‘some_page‘, устанавливая срок актуальности (lifetime) в 100 секунд. Если фрагмент не найден, надо его отобразить и сразу добавить в кэш (метод Fragment::save()). Если же в кэше есть нужный нам кусок страницы, он отобразится автоматически. По умолчанию lifetime ставится на 30 секунд. Ах да, кэш – файловый, пока что нет библиотеки Cache а-ля Kohana v2.3.4.
Запросы на добавление записей (INSERT) возвращают массив (последний_сгенерированный_id, количество_вставленных_записей), а для редактирования (UPDATE) и удаления (DELETE) – только количество измененных/удаленных записей.