понедельник, 29 ноября 2010 г.

CodeIgniter: библиотека Ion Auth

Ion Auth - это простая и легковесная библиотека авторизации для CodeIgniter, разработанная Беном Эдмундсом.

Огромное преимущество этой системы в том, что она работоспособна практически из "коробки" и требует минимум настроек для своей полноценной работы. Но это не означает, что её нельзя кастомизировать под свои нужды.

Библиотека Ion Auth, является дальнейшим развитием системы Redux Auth для работы с пользователями


Лицензия

Библиотека распространяется под лицензией Apache Licence v 2.0.

Установка

  1. Скачайте свежую версию с http://github.com/benedmunds/CodeIgniter-Ion-Auth/zipball/master
  2. Скопируйте файлы из этого архива в соответствующие папки вашего приложения. Например, скопируйте Ion_auth/config/ion_auth.php в system/application/config/ion_auth.php.
Логин, по умолчанию:
  • Email: admin@admin.com
  • Password: password

Подключение Ion Auth

Подключайте Ion Auth, так же как и любую другую библиотеку.

$this->load->library('ion_auth');

Так же, вы можете загружать Ion Auth через config/autoload.php вашего приложения:

$autoload['libraries'] = array('ion_auth'); 

Параметры конфигурации

Ion Auth экстремально конфигурируемый. Настраиваются следующие параметры:

  • $config['tables']['groups']
  • $config['tables']['users']
  • $config['tables']['meta']
  • $config['site_title']
  • $config['admin_email']
  • $config['default_group']
  • $config['admin_group']
  • $config['join']
  • $config['columns']
  • $config['identity']
  • $config['min_password_length']
  • $config['max_password_length']
  • $config['email_activation']
  • $config['remember_users']
  • $config['user_expire']
  • $config['user_extend_on_login']
  • $config['email_templates']
  • $config['email_activate']
  • $config['email_forgot_password']
  • $config['email_forgot_password_complete']
  • $config['salt_length']
  • $config['store_salt']
  • $config['message_start_delimiter']
  • $config['message_end_delimiter']
  • $config['error_start_delimiter']
  • $config['error_end_delimiter']

Использование файла конфигурации

Для изменения конфигурации просто отредактируйте файл config/ion_auth.php.

Конфигурация

Массив $config содержит следующие параметры:

  • 'tables['groups']' - Имя таблицы групп. По умолчанию 'groups'.
  • 'tables['users']' - Имя таблицы пользователей. По умолчанию 'users'.
  • 'tables['meta']' - Имя таблицы мета-данных. По умолчанию 'meta'.
  • 'site_title' - Название вашего сайта, используется для отправки email. По умолчанию ‘Example.com’.
  • 'admin_email' - E-mail администратора сайта. По умолчанию 'admin@example.com'.
  • 'default_group' - Имя группы для для пользователей. По умолчанию 'members'.
  • 'admin_group' - Имя группы для администраторов. По умолчанию 'admin'.
  • 'join' - Поле для объединение таблиц пользователей и мета-данных. По умолчанию 'user_id'.
  • 'columns' - Поля таблицы мета-данных. По умолчанию 'array('first_name', 'last_name', 'company', 'phone')'.
  • 'identity' - Поле для идентификации пользователей (имя пользователя, e-mail, телефон или любое другое поле с уникальными значениями). Обычно используется 'email' или 'username'. По умолчанию 'email'.
  • 'min_password_length' - Минимальная длинна пароля. По умолчанию '8'.
  • 'max_password_length' - Максимальная длинна пароля. По умолчанию '20'.
  • 'email_activation' - TRUE или FALSE. Параметр указывает - требуется или нет активация аккаунта через e-mail. По умолчанию 'false'.
  • 'remember_users' - TRUE или FALSE. Параметр указывает включать опцию 'запомнить меня', или нет. По умолчанию 'true'.
  • 'user_expire' - Параметр указывает сколько времени в секундах помнить пользователя (время жизни куки). По умолчанию '86500'.
  • 'user_extend_on_login' - TRUE или FALSE. Параметр указывает продлевать время жизни сессии при логине или нет. По умолчанию 'false'.
  • 'email_type' - Тип рассылаемых сообщений 'html' или 'text'. По умолчанию 'html'.
  • 'email_templates' - Путь к каталогу с шаблонами писем. По умолчанию 'auth/email/'.
  • 'email_activate' - Имя файла шаблона письма активации пользователя. По умолчанию 'activate.tpl.php'.
  • 'email_forgot_password' - Имя файла шаблона письма восстановления забытого пароля. По умолчанию 'forgot_password.tpl.php'.
  • 'email_forgot_password_complete' - Имя шаблона письма завершения восстановления забытого пароля. По умолчанию 'new_password.tpl.php'.
  • 'salt_length' - Количество символов salt. По умолчанию '10'.
  • 'store_salt' - TRUE или FALSE. Будет храниться salt в базе данных или нет. По умолчанию 'false'. При включении этой опции в 'true' измениться алгорим шифрования пароля. Пароль по умолчанию (password) необходимо будет изменить на 'fbaa5e216d163a02ae630ab1a43372635dd374c0', с salt по умолчанию. Значение по умолчанию ‘false
  • 'message_start_delimiter' - Начальный разделитель для сообщения. По умолчанию '<p>'.
  • 'message_end_delimiter' - Конечный разделитель сообщения. По умолчанию '</p>'.
  • 'error_start_delimiter' - Начальный разделитель сообщения об ошибке . По умолчанию '<p>'.
  • 'error_end_delimiter' - Конечный разделитель сообщения об ошибке. По умолчанию '</p>'.

Похожие по тематике посты:

Комментариев нет: