CodeIgniter, руководство пользователя к версии 1.6.1


Плагины

Плагины работают практически идентично хелперам. Главное отличие заключается в том, что плагин — это одна функция, в то время как хелпер — это их набор. Хелперы так же считаются частью ядра системы; плагины должны быть работоспособными сразу для нескольких систем.

Плагины необходимо хранить в директории system/plugins, или вы можете создать папку plugins внутри вашей папки application и хранить плагины там. CodeIgniter изначально будет искать их внутри system/application/plugins. Если директория не существует, либо там нет указанного плагина, CI будет искать этот плагин в глобальной директории system/plugins.

Загрузка плагина

Загрузка файла плагина осуществляется очень просто с использованием этой функции:

$this->load->plugin('name');

Где name это название файла с плагином без расширения .php и части «plugin».

Например, чтобы загрузить плагин Captcha, файл которого называется captcha_pi.php, вам надо написать это:

$this->load->plugin('captcha');

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

Замечание: Функция загрузки плагина не возвращает значений, поэтому не стоит пытаться присвоить результат ее выполнения переменной. Пользуйтесь ей как показано.

Загрузка нескольких плагинов

Если вам необходимо загрузить сразу несколько плагинов, то вы можете перечислить их в массиве:

$this->load->plugin( array('plugin1', 'plugin2', 'plugin3') );

Авто-загрузка плагинов

Если вы обнаружите, что вам необходим плагин в глобальном масштабе, то лучше заставить его загрузиться при инициализации системы. Чтобы сделать это, откройте ваш файл application/config/autoload.php и добавьте плагин в массив автозагрузки.

Использование плагина

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