RememberMeServicesInterface
интерфейс RememberMeServicesInterface
Интерфейс, который необходимо реализовать классам, предоставляющим возможности сохранения состояния входа в систему.
Мы предоставляем две реализации из коробки: - TokenBasedRememberMeServices (не требует TokenProvider) - PersistentTokenBasedRememberMeServices (требует TokenProvider)
Постоянные значения
| COOKIE_ATTR_NAME | Это имя атрибута может быть использовано реализацией, если ей необходимо установить cookie в запросе, когда фактического ответа еще нет. |
Методы
| TokenInterface | autoLogin(Request $request) Этот метод вызывается всякий раз, когда объект TokenStorage не содержит объект TokenInterface, и фреймворк хочет предоставить реализации возможность аутентификации запроса с помощью возможностей сохранения состояния входа. | |
| loginFail(Request $request) Вызывается всякий раз, когда была предпринята попытка интерактивной аутентификации, но предоставленные пользователем данные отсутствовали или были неверными. | ||
| loginSuccess(Request $request, Response $response, TokenInterface $token) Вызывается всякий раз, когда попытка интерактивной аутентификации завершается успешно (например, при входе в систему через форму). |
Подробности
TokenInterface autoLogin(Request $request)
Этот метод вызывается всякий раз, когда объект TokenStorage не содержит объект TokenInterface, и фреймворк хочет предоставить реализации возможность аутентификации запроса с помощью возможностей сохранения состояния входа.
Никаких попыток определить, запросил ли браузер службы сохранения состояния входа или представил ли действительный cookie, не делается. Все такие определения оставляются на усмотрение реализации этого метода.
Если браузер представил несанкционированный cookie по какой-либо причине, убедитесь, что выброшено исключение AuthenticationException, так как это приведет к вызову loginFail() и, следовательно, к аннулированию cookie.
Параметры
| Request | $request |
Возвращаемое значение
| TokenInterface |
loginFail(Request $request)
Вызывается всякий раз, когда была предпринята попытка интерактивной аутентификации, но предоставленные пользователем данные отсутствовали или были неверными.
Этот метод должен позаботиться об аннулировании cookie.
Параметры
| Request | $request |
loginSuccess(Request $request, Response $response, TokenInterface $token)
Вызывается всякий раз, когда попытка интерактивной аутентификации завершается успешно (например, при входе в систему через форму).
Реализация может всегда устанавливать cookie сохранения состояния входа в систему в Response, хотя это не рекомендуется.
Вместо этого, реализации обычно ищут параметр запроса (например, параметр HTTP POST), который указывает, что браузер явно запросил запомнить аутентификацию.
Параметры
| Request | $request | |
| Response | $response | |
| TokenInterface | $token |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.2/Symfony/Component/Security/Http/RememberMe/RememberMeServicesInterface.html