92 lines
5.0 KiB
Markdown
92 lines
5.0 KiB
Markdown
# Общие настройки
|
||
|
||
[!!] TODO: описание преимуществ статических свойств конфигурации
|
||
|
||
## Настройки ядра
|
||
|
||
Первой задачей конфигурирования новой установки Kohana является изменение параметров [Kohana::init] в `application/bootstrap.php`. Вот эти параметры:
|
||
|
||
`boolean` errors
|
||
: Использование встроенного обработчика ошибок и исключений. (По-умолчанию: `TRUE`) Установите в `FALSE`, чтобы отменить перехват ошибок и исключений фреймворком.
|
||
|
||
`boolean` profile
|
||
: Использовать возможности встроенного бенчмаркинга. (По-умолчанию: `TRUE`) Установите в `FALSE`, чтобы отменить профилирование. Для увеличения производительности на стадии production данный параметр рекомендуется отключать.
|
||
|
||
`boolean` caching
|
||
: Кэширование информации о расположении файлов между запросами. (По-умолчанию: `FALSE`) Установите в `TRUE`, чтобы включить кэширование значений абсолютных путей исполняемых файлов. Это значительно ускоряет [Кохана::find_file] и может иногда оказать серьезное влияние на производительность. Используйте на этапе production или для тестирования.
|
||
|
||
`string` charset
|
||
: Кодировка, используемая во всех операциях ввода-вывода. (По-умолчанию: `"utf-8"`) Должна поддерживаться как [htmlspecialchars](http://php.net/htmlspecialchars), так и [iconv](http://php.net/iconv).
|
||
|
||
`string` base_url
|
||
: Базовый URL для приложения. (По-умолчанию: `"/"`) Может быть как абсолютным, так и относительным URL. Например, "http://example.com/kohana/" или просто "/kohana/": подходят оба варианта.
|
||
|
||
`string` index_file
|
||
: Имя PHP файла, который запускает приложение (фронтенд). (По-умолчанию: `"index.php"`) Установите в `FALSE`, если намереваетесь использовать URL rewriting.
|
||
|
||
`string` cache_dir
|
||
: Директория для хранения файлового кэша. (По-умолчанию: `"application/cache"`) Директория должна быть **доступна для записи**.
|
||
|
||
## Настройки Cookie
|
||
|
||
Перед запуском production-версии сайта следует установить значения некоторых статических свойств [Cookie] класса.
|
||
|
||
`string` salt
|
||
: Уникальная строка salt-значения, которая используется для работы [cookies](security.cookies)
|
||
|
||
`integer` expiration
|
||
: По-умолчанию: время жизни cookies в секундах
|
||
|
||
`string` path
|
||
: URL, ограничивающий доступ к cookies
|
||
|
||
`string` domain
|
||
: Домен, ограничивающий доступ к cookies
|
||
|
||
`boolean` secure
|
||
: Позволить использовать cookies только по протоколу HTTPS
|
||
|
||
`boolean` httponly
|
||
: Позволить использовать cookies только по протоколу HTTP (также закрывается доступ через Javascript)
|
||
|
||
# Конфигурационные файлы
|
||
|
||
Настройки хранятся в виде PHP файлов примерно такого вида:
|
||
|
||
~~~
|
||
<?php defined('SYSPATH') or die('No direct script access.');
|
||
|
||
return array(
|
||
'setting' => 'value',
|
||
'options' => array(
|
||
'foo' => 'bar',
|
||
),
|
||
);
|
||
~~~
|
||
|
||
Если конфигурационный файл был назван `myconf.php`, то для доступа к нему можно использовать следующий код:
|
||
|
||
~~~
|
||
$config = Kohana::config('myconf');
|
||
$options = $config['options'];
|
||
~~~
|
||
|
||
[Kohana::config] позволяет так же использовать "пути с точкой" для доступа к отдельным ключам конфигурационного массива.
|
||
|
||
Для получения массива "options":
|
||
|
||
~~~
|
||
$options = Kohana::config('myconf.options');
|
||
~~~
|
||
|
||
Для получения значения ключа "foo" массива "options":
|
||
|
||
~~~
|
||
$foo = Kohana::config('myconf.options.foo');
|
||
~~~
|
||
|
||
Вы можете работать с настроечными массивами как с объектами, если это будет удобнее:
|
||
|
||
~~~
|
||
$options = Kohana::config('myconf')->options;
|
||
~~~ |