Класс BaseAuthenticate
Базовый класс аутентификации с общими методами и свойствами.
- Cake\Auth\BaseAuthenticate реализует Cake\Event\EventListenerInterface использует Cake\Core\InstanceConfigTrait
Прямые подклассы
Косвенные подклассы
Пространство имен: Cake\Auth
Миксин: \Cake\Core\InstanceConfigTrait
Расположение: Auth/BaseAuthenticate.php
Краткое описание свойств
-
$_defaultConfigprotectedЗначения конфигурации по умолчанию для данного объекта.array -
$_needsPasswordRehashprotectedbooleanТребуется ли перехеширование пароля пользователя, аутентифицированного этим классом, с использованием другого алгоритма.
- Экземпляр хешировщика паролей.
$_passwordHasherprotected - Регистр компонентов, используемый для получения дополнительных компонентов.
$_registryprotected
Унаследованные свойства
Краткое описание методов
- __construct() publicКонструктор
- _findUser() protectedПоиск записи пользователя по имени пользователя и паролю.
- _query() protectedПолучить объект запроса для получения пользователя из базы данных.
- Проверка подлинности пользователя на основе информации запроса.
- getUser() public
Получить пользователя на основе информации в запросе. В основном используется системами аутентификации без состояния, такими как basic и digest auth.
- implementedEvents() publicВозвращает список всех событий, на которые будет подключаться этот класс аутентификации.
- needsPasswordRehash() public
Возвращает значение, указывающее, требуется ли перехеширование пароля, хранящегося в репозитории для вошедшего пользователя, с помощью другого алгоритма.
- passwordHasher() publicВозвращает объект хешировщика паролей
- unauthenticated() public
Обработка попытки доступа без аутентификации. В реализации допустимыми значениями возврата могут быть:
Подробное описание методов
__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|arrayВ случае неудачи — false, в случае успеха — массив данных пользователя.
_query()source protected
_query( string $username )
Получить объект запроса для получения пользователя из базы данных.
Параметры
- строка
$username - Имя пользователя/идентификатор.
Возвращает
Cake\ORM\Queryauthenticate()source abstract public
authenticate( Cake\Http\ServerRequest $request , Cake\Http\Response $response )
Проверка подлинности пользователя на основе информации запроса.
Параметры
-
Cake\Http\ServerRequest$request - Запрос для получения информации об аутентификации.
-
Cake\Http\Response$response - Объект ответа, которому можно добавить заголовки.
Возвращает
mixedВ случае неудачи — false, в случае успеха — массив данных пользователя.
getUser()source public
getUser( Cake\Http\ServerRequest $request )
Получить пользователя на основе информации в запросе. В основном используется системами аутентификации без состояния, такими как basic и digest auth.
Параметры
-
Cake\Http\ServerRequest$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— пользователь, который должен быть выведен из системы.
Возвращает
arrayСписок событий, на которые подключается этот класс. По умолчанию
[].Реализация
Cake\Event\EventListenerInterface::implementedEvents() needsPasswordRehash()source public
needsPasswordRehash( )
Возвращает значение, указывающее, требуется ли перехеширование пароля, хранящегося в репозитории для вошедшего пользователя, с помощью другого алгоритма.
Возвращает
booleanpasswordHasher()source public
passwordHasher( )
Возвращает объект хешировщика паролей
Возвращает
Cake\Auth\AbstractPasswordHasherЭкземпляр хешировщика паролей
Исключения
RuntimeExceptionЕсли класс хешировщика паролей не найден или он не расширяет AbstractPasswordHasher
unauthenticated()source public
unauthenticated( Cake\Http\ServerRequest $request , Cake\Http\Response $response )
Обработка попытки доступа без аутентификации. В реализации допустимыми значениями возврата могут быть:
- Null - Действие не выполняется, AuthComponent должен вернуть соответствующий ответ.
- Cake\Http\Response - Объект ответа, который заставит AuthComponent просто вернуть этот ответ.
Параметры
-
Cake\Http\ServerRequest$request - Объект запроса.
-
Cake\Http\Response$response - Объект ответа.
Используемые методы из Cake\Core\InstanceConfigTrait
_configDelete()source protected
_configDelete( string $key )
Удаляет единственный ключ конфигурации.
Параметры
- строка
$key - Ключ для удаления.
Исключения
Cake\Core\Exception\Exceptionесли происходит попытка перезаписать существующую конфигурацию
_configRead()source protected
_configRead( string|null $key )
Читает значение конфигурации по ключу.
Параметры
- string|null
$key - Ключ для чтения.
Возвращает
mixed_configWrite()source protected
_configWrite( string|array $key , mixed $value , boolean|string $merge false )
Записывает значение конфигурации по ключу.
Параметры
- string|array
$key - Ключ для записи.
- mixed
$value - Значение для записи.
- boolean|string
$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']);
Устарело
3.4.0 Используйте setConfig()/getConfig() вместо этого.Параметры
- string|array|null
$keyнеобязательно null - Ключ для получения/установки, или массив всей конфигурации.
- mixed|null
$valueнеобязательно null - Значение для установки.
- boolean
$mergeнеобязательно true - Рекурсивное слияние или перезапись существующей конфигурации, по умолчанию true.
Возвращает
mixedЗначение конфигурации для чтения, или сам объект при операциях записи.
Исключения
Cake\Core\Exception\ExceptionПри попытке установить недопустимый ключ.
configShallow()source public
configShallow( string|array $key , mixed|null $value null )
Слияние предоставленной конфигурации с существующей конфигурацией. В отличие от config(), которое выполняет рекурсивное слияние для вложенных ключей, этот метод выполняет простое слияние.
Установка определенного значения:
$this->configShallow('key', $value); Установка вложенного значения:
$this->configShallow('some.nested.key', $value); Обновление нескольких параметров конфигурации одновременно:
$this->configShallow(['one' => 'value', 'another' => 'value']);
Параметры
- string|array
$key - Ключ для установки, или массив всей конфигурации.
- mixed|null
$valueнеобязательно null - Значение для установки.
Возвращает
$this
getConfig()source public
getConfig( string|null $key null , mixed $default null )
Возвращает конфигурацию.
Использование
Чтение всей конфигурации:
$this->getConfig();
Чтение определенного значения:
$this->getConfig('key'); Чтение вложенного значения:
$this->getConfig('some.nested.key'); Чтение со значением по умолчанию:
$this->getConfig('some-key', 'default-value'); Параметры
- string|null
$keyнеобязательно null - Ключ для получения, или null для всей конфигурации.
- mixed
$defaultнеобязательно null - Значение по умолчанию, если ключ не найден.
Возвращает
mixedЗначение конфигурации.
setConfig()source public
setConfig( string|array $key , mixed|null $value null , boolean $merge true )
Устанавливает конфигурацию.
Использование
Установка определенного значения:
$this->setConfig('key', $value); Установка вложенного значения:
$this->setConfig('some.nested.key', $value); Обновление нескольких параметров конфигурации одновременно:
$this->setConfig(['one' => 'value', 'another' => 'value']);
Параметры
- string|array
$key - Ключ для установки, или массив всей конфигурации.
- mixed|null
$valueнеобязательно null - Значение для установки.
- boolean
$mergeнеобязательно true - Рекурсивное слияние или перезапись существующей конфигурации, по умолчанию true.
Возвращает
$this
Исключения
Cake\Core\Exception\ExceptionПри попытке установить недопустимый ключ.
Подробное описание свойств
$_defaultConfigsource
protected array
Значения конфигурации по умолчанию для этого объекта.
-
fieldsПоля для идентификации пользователя. -
userModelПсевдоним таблицы пользователей, по умолчанию Users. -
finderМетод поиска для получения записи пользователя. По умолчанию 'all'. Вы можете задать имя метода поиска как строку или массив, где ключ - имя метода поиска, а значение - массив, передаваемый вTable::find()опции. Например: ['finderName' => ['some_finder_option' => 'some_value']] -
passwordHasherКласс хеширования паролей. Может быть строкой, указывающей имя класса, или массивом, содержащимclassNameключ, а все остальные ключи будут переданы как конфигурация в класс. По умолчанию 'Default'. - Опции
scopeиcontainустарели с версии 3.1. Используйте пользовательский метод поиска вместо этого для изменения запроса для получения записи пользователя.
[
'fields' => [
'username' => 'username',
'password' => 'password'
],
'userModel' => 'Users',
'scope' => [],
'finder' => 'all',
'contain' => null,
'passwordHasher' => 'Default'
] $_needsPasswordRehashsource
protected boolean
Требуется ли перехеширование пароля пользователя, авторизованного этим классом, с использованием другого алгоритма.
false
$_registrysource
protected Cake\Controller\ComponentRegistry
Регистр компонентов, используемый для получения других компонентов.
© 2005–2018 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.5/class-Cake.Auth.BaseAuthenticate.html