96 lines
5.5 KiB
Markdown
96 lines
5.5 KiB
Markdown
# Загрузка классов
|
||
|
||
Kohana использует все преимущества [автозагрузки](http://php.net/manual/language.oop5.autoload.php) в PHP.
|
||
Это позволяет не использовать вызовы [include](http://php.net/include) или [require](http://php.net/require) перед использованием класса. К примеру, когда Вы хотите использовать метод [Cookie::set], Вы всего лишь вызываете:
|
||
|
||
Cookie::set('mycookie', 'any string value');
|
||
|
||
А для получения объекта [Encrypt] просто используйте [Encrypt::instance]:
|
||
|
||
$encrypt = Encrypt::instance();
|
||
|
||
Классы загружаются с помощью метода [Kohana::auto_load], который осуществляет простое преобразование из имени класса в имя файла:
|
||
|
||
1. Классы располагаются в директории `classes/` [файловой системы](about.filesystem)
|
||
2. Все знаки подчеркивания заменяются слэшами
|
||
2. Имена файлов должны быть в нижнем регистре
|
||
|
||
Когда вызывается класс, который еще не был загружен (например `Session_Cookie`), Kohana будет искать файл под именем `classes/session/cookie.php` в файловой системе, с помощью [Kohana::find_file].
|
||
|
||
## Собственные загрузчики
|
||
|
||
Системный загрузчик добавляется в файле `application/bootstrap.php` через вызов [spl_autoload_register](http://php.net/spl_autoload_register):
|
||
|
||
spl_autoload_register(array('Kohana', 'auto_load'));
|
||
|
||
Теперь [Kohana::auto_load] будет пытаться загрузить любой несуществующий класс при его первом использовании.
|
||
|
||
# Прозрачное расширение классов {#class-extension}
|
||
|
||
[Каскадная файловая система](about.filesystem) поддерживает прозрачное расширение классов. Например, класс [Cookie] определен в `SYSPATH/classes/cookie.php` так:
|
||
|
||
class Cookie extends Kohana_Cookie {}
|
||
|
||
Системные классы Kohana, как и многие модули, используют такое определение, так что практически все классы могут быть расширены. Это делается прозрачно для системы, создайте свой класс в `APPPATH/classes/cookie.php` для добавления собственных методов.
|
||
|
||
[!!] **Никогда** не изменяйте файлы дистрибутива Kohana. Всегда вносите изменения в классы, используя расширения, так Вы избавитесь от головной боли при обновлении.
|
||
|
||
К примеру, Вы хотите создать метод, который устанавливает зашифрованную куку с помощью класса [Encrypt]:
|
||
|
||
<?php defined('SYSPATH') or die('No direct script access.');
|
||
|
||
class Cookie extends Kohana_Cookie {
|
||
|
||
/**
|
||
* @var mixed default encryption instance
|
||
*/
|
||
public static $encryption = 'default';
|
||
|
||
/**
|
||
* Sets an encrypted cookie.
|
||
*
|
||
* @uses Cookie::set
|
||
* @uses Encrypt::encode
|
||
*/
|
||
public static function encrypt($name, $value, $expiration = NULL)
|
||
{
|
||
$value = Encrypt::instance(Cookie::$encrpytion)->encode((string) $value);
|
||
|
||
parent::set($name, $value, $expiration);
|
||
}
|
||
|
||
/**
|
||
* Gets an encrypted cookie.
|
||
*
|
||
* @uses Cookie::get
|
||
* @uses Encrypt::decode
|
||
*/
|
||
public static function decrypt($name, $default = NULL)
|
||
{
|
||
if ($value = parent::get($name, NULL))
|
||
{
|
||
$value = Encrypt::instance(Cookie::$encryption)->decode($value);
|
||
}
|
||
|
||
return isset($value) ? $value : $default;
|
||
}
|
||
|
||
} // End Cookie
|
||
|
||
Теперь вызов `Cookie::encrypt('secret', $data)` будет создавать шифрованную куку, которую можно расшифровать так: `$data = Cookie::decrypt('secret')`.
|
||
|
||
## Многоуровневое расширение {#multiple-extensions}
|
||
|
||
Если Вы расширяете классы Kohana в модуле, следует поддерживать прозрачное расширение. Вместо того, чтобы наследовать расширение [Cookie] от [Kohana_Cookie], создайте `MODPATH/mymod/encrypted/cookie.php`:
|
||
|
||
class Encrypted_Cookie extends Kohana_Cookie {
|
||
|
||
// Используйте методы encrypt() and decrypt(), описанные выше
|
||
|
||
}
|
||
|
||
Теперь создайте `MODPATH/mymod/cookie.php`:
|
||
|
||
class Cookie extends Encrypted_Cookie {}
|
||
|
||
Таким образом, пользователи смогут добавлять свои расширения в класс [Cookie], не затрагивая Ваши изменения. Однако, при следующем расширении класса [Cookie] придется наследоваться от `Encrypted_Cookie`, а не от `Kohana_Cookie`. |