Класс FormAuthenticate
Адаптер аутентификации для AuthComponent. Предоставляет возможность аутентификации с помощью данных POST. Может быть использован путём конфигурации AuthComponent для его использования через конфигурацию AuthComponent::$authenticate.
$this->Auth->authenticate = [
'Form' => [
'finder' => ['auth' => ['some_finder_option' => 'some_value']]
]
] При конфигурации FormAuthenticate вы можете передать конфигурацию, в которой указываются поля, модель и дополнительные условия. Подробнее см. FormAuthenticate::$_config.
- Cake\Auth\BaseAuthenticate implements Cake\Event\EventListenerInterface uses Cake\Core\InstanceConfigTrait
-
Cake\Auth\FormAuthenticate
См.: \Cake\Controller\Component\AuthComponent::$authenticate
Расположение: Auth/FormAuthenticate.php
Наследуемые свойства
Краткое описание методов
- _checkFields() protectedПроверяет поля на наличие.
- authenticate() public
Проверяет подлинность пользователя, содержащегося в запросе. Будет использовать
config.userModel, иconfig.fieldsдля поиска данных POST, которые используются для поиска совпадающей записи вconfig.userModel. Вернёт false, если данных POST нет, отсутствует имя пользователя или пароль, или не выполнены условия доступа.
Подробное описание методов
_checkFields()source protected
_checkFields( Cake\Network\Request $request , array $fields )
Проверяет поля на наличие.
Параметры
-
Cake\Network\Request$request - Запрос, содержащий информацию для входа.
- массив
$fields - Поля для проверки.
Возвращает
booleanFalse, если поля не предоставлены. True, если поля существуют.
authenticate()source public
authenticate( Cake\Network\Request $request , Cake\Network\Response $response )
Проверяет подлинность пользователя, содержащегося в запросе. Будет использовать config.userModel, и config.fields для поиска данных POST, которые используются для поиска совпадающей записи в config.userModel. Вернёт false, если данных POST нет, отсутствует имя пользователя или пароль, или не выполнены условия доступа.
Параметры
-
Cake\Network\Request$request - Запрос, содержащий информацию для входа.
-
Cake\Network\Response$response - Неиспользуемый объект ответа.
Возвращает
mixedFalse при ошибке входа. Массив данных пользователя при успехе.
Методы, унаследованные от Cake\Auth\BaseAuthenticate
__construct()source public
__construct( Cake\Controller\ComponentRegistry $registry , array $config [] )
Конструктор
Параметры
-
Cake\Controller\ComponentRegistry$registry - Регистр компонента, используемый в этом запросе.
- массив
$configнеобязательно [] - Массив конфигурации для использования.
_findUser()source protected
_findUser( string $username , string|null $password null )
Поиск записи пользователя с использованием предоставленного имени пользователя и пароля.
Пароли на вход будут хешироваться, даже если пользователь не существует. Это помогает снизить вероятность атак, пытающихся найти действительные имена пользователей.
Параметры
- строка
$username - Имя пользователя/идентификатор.
- строка|null
$passwordнеобязательно null Пароль, если не указан, проверка пароля пропускается, и возвращаются результаты поиска.
Возвращает
boolean|массивВ случае неудачи — false, в случае успеха — массив данных пользователя.
_query()source protected
_query( string $username )
Получение объекта запроса для извлечения пользователя из базы данных.
Параметры
- строка
$username - Имя пользователя/идентификатор.
Возвращает
Cake\ORM\QuerygetUser()source public
getUser( Cake\Network\Request $request )
Получение пользователя на основе информации в запросе. В основном используется в бессостоятельных системах аутентификации, таких как basic и digest аутентификация.
Параметры
-
Cake\Network\Request$request - Объект запроса.
Возвращает
mixedВ случае неудачи — false, в случае успеха — массив информации о пользователе
implementedEvents()source public
implementedEvents( )
Возвращает список всех событий, за которыми этот класс аутентификации будет следить.
Класс аутентификации может следить за следующими событиями, генерируемыми AuthComponent:
Auth.afterIdentify- Срабатывает после того, как пользователь был идентифицирован с помощью одного из настроенных классов аутентификации. Функция обратного вызова должна иметь сигнатуру типаafterIdentify(Event $event, array $user)когда$userявляется идентифицированной записью пользователя.Auth.logout- Срабатывает при вызове AuthComponent::logout(). Функция обратного вызова должна иметь сигнатуру типаlogout(Event $event, array $user)где$userявляется пользователем, который будет выведен из системы.
Возвращает
массивСписок событий, за которыми следит этот класс. По умолчанию
[].Реализация
Cake\Event\EventListenerInterface::implementedEvents() needsPasswordRehash()source public
needsPasswordRehash( )
Возвращает, требуется ли повторное хеширование пароля, хранящегося в репозитории для вошедшего пользователя, с помощью другого алгоритма
Возвращает
booleanpasswordHasher()source public
passwordHasher( )
Возвращает объект хеширования паролей
Возвращает
Cake\Auth\AbstractPasswordHasherЭкземпляр хешера паролей
Исключения
RuntimeExceptionЕсли класс хешера паролей не найден или он не расширяет AbstractPasswordHasher
unauthenticated()source public
unauthenticated( Cake\Network\Request $request , Cake\Network\Response $response )
Обработка неудачной попытки аутентификации. В реализации допустимыми возвращаемыми значениями являются:
- Null — Никаких действий не выполнено, AuthComponent должен вернуть соответствующий ответ.
- Cake\Network\Response — Объект ответа, который заставит AuthComponent просто вернуть этот ответ.
Параметры
-
Cake\Network\Request$request - Объект запроса.
-
Cake\Network\Response$response - Объект ответа.
Методы, используемые из Cake\Core\InstanceConfigTrait
_configDelete()source protected
_configDelete( string $key )
Удаление отдельного ключа конфигурации
Параметры
- строка
$key - Ключ для удаления.
Исключения
Cake\Core\Exception\ExceptionЕсли попытка перезаписи существующей конфигурации
_configRead()source protected
_configRead( string|null $key )
Чтение переменной конфигурации
Параметры
- строка|null
$key - Ключ для чтения.
Возвращает
mixed_configWrite()source protected
_configWrite( string|array $key , mixed $value , boolean|string $merge false )
Запись переменной конфигурации
Параметры
- строка|массив
$key - Ключ для записи.
- смешанное
$value - Значение для записи.
- boolean|строка
$mergeнеобязательно false True для рекурсивного объединения, 'shallow' для простого объединения, false для перезаписи, по умолчанию — false.
Исключения
Cake\Core\Exception\ExceptionЕсли попытка перезаписи существующей конфигурации
config()source public
config( string|array|null $key null , mixed|null $value null , boolean $merge true )
Использование
Чтение всего конфига:
$this->config();
Чтение определённого значения:
$this->config('key'); Чтение вложенного значения:
$this->config('some.nested.key'); Установка определённого значения:
$this->config('key', $value); Установка вложенного значения:
$this->config('some.nested.key', $value); Обновление нескольких параметров конфига одновременно:
$this->config(['one' => 'value', 'another' => 'value']);
Параметры
- строка|массив|null
$keyнеобязательно null - Ключ для получения/установки или полный массив конфигов.
- смешанный|null
$valueнеобязательно null - Значение для установки.
- булево
$mergeнеобязательно true - Флаг рекурсивного слияния или перезаписи существующего конфига, по умолчанию true.
Возвращает
mixedЗначение конфига, которое читается, или сам объект при операциях записи.
Выбрасывает
Cake\Core\Exception\ExceptionПри попытке установить неверный ключ.
configShallow()source public
configShallow( string|array $key , mixed|null $value null )
Слияние предоставленного конфига с существующим конфигом. В отличие от config() , который выполняет рекурсивное слияние для вложенных ключей, этот метод выполняет простое слияние.
Установка определённого значения:
$this->config('key', $value); Установка вложенного значения:
$this->config('some.nested.key', $value); Обновление нескольких параметров конфига одновременно:
$this->config(['one' => 'value', 'another' => 'value']);
Параметры
- строка|массив
$key - Ключ для установки или полный массив конфигов.
- смешанный|null
$valueнеобязательно null - Значение для установки.
Возвращает
$this Объект сам по себе.
© 2005–2017 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/3.3/class-Cake.Auth.FormAuthenticate.html