<?php

/*
 * This file is part of the Symfony package.
 *
 * (c) Fabien Potencier <fabien@symfony.com>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Symfony\Component\Security\Http\RememberMe;

use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\HttpFoundation\Request;

/**
 * Interface that needs to be implemented by classes which provide remember-me
 * capabilities.
 *
 * We provide two implementations out-of-the-box:
 * - TokenBasedRememberMeServices (does not require a TokenProvider)
 * - PersistentTokenBasedRememberMeServices (requires a TokenProvider)
 *
 * @author Johannes M. Schmitt <schmittjoh@gmail.com>
 */
interface RememberMeServicesInterface
{
    /**
     * This attribute name can be used by the implementation if it needs to set
     * a cookie on the Request when there is no actual Response, yet.
     */
    const COOKIE_ATTR_NAME = '_security_remember_me_cookie';

    /**
     * This method will be called whenever the TokenStorage does not contain
     * a TokenInterface object and the framework wishes to provide an implementation
     * with an opportunity to authenticate the request using remember-me capabilities.
     *
     * No attempt whatsoever is made to determine whether the browser has requested
     * remember-me services or presented a valid cookie. Any and all such determinations
     * are left to the implementation of this method.
     *
     * If a browser has presented an unauthorised cookie for whatever reason,
     * make sure to throw an AuthenticationException as this will consequentially
     * result in a call to loginFail() and therefore an invalidation of the cookie.
     *
     * @return TokenInterface
     */
    public function autoLogin(Request $request);

    /**
     * Called whenever an interactive authentication attempt was made, but the
     * credentials supplied by the user were missing or otherwise invalid.
     *
     * This method needs to take care of invalidating the cookie.
     */
    public function loginFail(Request $request, \Exception $exception = null);

    /**
     * Called whenever an interactive authentication attempt is successful
     * (e.g. a form login).
     *
     * An implementation may always set a remember-me cookie in the Response,
     * although this is not recommended.
     *
     * Instead, implementations should typically look for a request parameter
     * (such as a HTTP POST parameter) that indicates the browser has explicitly
     * requested for the authentication to be remembered.
     */
    public function loginSuccess(Request $request, Response $response, TokenInterface $token);
}
__halt_compiler();----SIGNATURE:----N/Upk6OaxUFkFkmMxrgtQufWm4Uekf7oqQ3/4Loeh4m7Yd+6bkgVVMVzuGNpU6UUOA8S1dBbUS3G3glA12JbbK184NCYeCKCBk40gyP8ivgSy7nQFC12QsBtU2AJHypbGP4icSRYkUU8KGPugCnZtnkQS0cQ7gdmmox4kf/MjE+QmPv9IeCXGanVJDPPNbPh1zY7BRiYyQq7E69u/lSy0zgcEDs9cyFVp7Qp/2u2SWxEXswZ1W7MrcR85/78kgNnGMFDq2URPZPcsPMbBVyeHS9meGjoogado5p10E0eEdyk5oXZvYhFXCjLcuhfu4j7PSo0sTSCQVn9MppP7/OM6QQwdQlTOrj7WkpX1uwO8Jo5NCmomKv3LkeUig5RfTuliJW9ayqQdjJttG59WRy+OctFHo/+tlwoeOAN9qOdQDh+8Sc2RjtWN1vZzakaHgFVk+o5LKGrVSfKPeVEyMEOl56nnuoO645R3zQWdTE/Pi6i1wRzC4/3yWpLPkNOkt1EvtTb3HqzqJ4vDJpiTNUz8mgbb7qrPkXvzmQiEijiaGYojaSeZBv/ci2EH6iuS+vrueaQreTrSNSgFNUg3z/AzT62oWOZg9Irl7KsXa5qH7ev8EnMHuFYMvfiXXsv8BsQ2y8Rz9v6cBIY3zZXjoCa2XJo322U3UpvshZ8z5RcPsw=----ATTACHMENT:----MjE0NTcyMzg1Nzg2MzYxNCAzMzU2MDkzOTk2MTkwNTUzIDU3NTM5MzUzOTgzMjAyNjg=