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

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

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

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

• CodeIgniter: библиотека Ion Auth
• Ion 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>'.

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