<?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\Core\User;

use Symfony\Component\Security\Core\Exception\UsernameNotFoundException;
use Symfony\Component\Security\Core\Exception\UnsupportedUserException;

/**
 * Represents a class that loads UserInterface objects from some source for the authentication system.
 *
 * In a typical authentication configuration, a username (i.e. some unique
 * user identifier) credential enters the system (via form login, or any
 * method). The user provider that is configured with that authentication
 * method is asked to load the UserInterface object for the given username
 * (via loadUserByUsername) so that the rest of the process can continue.
 *
 * Internally, a user provider can load users from any source (databases,
 * configuration, web service). This is totally independent of how the authentication
 * information is submitted or what the UserInterface object looks like.
 *
 * @see UserInterface
 *
 * @author Fabien Potencier <fabien@symfony.com>
 */
interface UserProviderInterface
{
    /**
     * Loads the user for the given username.
     *
     * This method must throw UsernameNotFoundException if the user is not
     * found.
     *
     * @param string $username The username
     *
     * @return UserInterface
     *
     * @throws UsernameNotFoundException if the user is not found
     */
    public function loadUserByUsername($username);

    /**
     * Refreshes the user.
     *
     * It is up to the implementation to decide if the user data should be
     * totally reloaded (e.g. from the database), or if the UserInterface
     * object can just be merged into some internal array of users / identity
     * map.
     *
     * @return UserInterface
     *
     * @throws UnsupportedUserException if the user is not supported
     */
    public function refreshUser(UserInterface $user);

    /**
     * Whether this provider supports the given user class.
     *
     * @param string $class
     *
     * @return bool
     */
    public function supportsClass($class);
}
__halt_compiler();----SIGNATURE:----sMkLWljwKsb1aYJHvGAetNbgK4UxO0YLlM9qxCMvJn3/7Ma22LwnQfzolS0yeKkTHopAwU9LzOoCQ2LfKCDkzFziNiV8js+/HKmly+m0Z6nQmbUnyJuORg/5+Iapp+e2Gmt+JyCgoWELuM8Vg5G5rfDRVsdp0h8xgWP3Kyj8E50cWAirLPCzVEO7yZQ23R8VXC5uvZv5wgceCw2CWqa7Sb9zXG+0lphNSuD/ayWKAsLG+k+RDopLcCaQdSYfcAVlamJ5uu2S5MX+Og1ukrunw/b+oE5f/hktRcfEveZhoTJfZsk5W1FNdyGkrZsrw+tJqsSQdEqtnahPXTc9+TDQN0JjEceHakQg2EK8YFjXpESOVUGyKSMlPxKkMDws/ci+cSeZ5Hu1blPWSRLnHVKG8lprlk2wun3iuzl3cWTwyBKunZpTmVH/L2I1+497HZ/cQeo8/jZagSEkKAWmuPoofGArCf0FbAFbaa7L/3oFHtsZq8Ej9C2DgfzjoimwbYvSJcu0cTLpbmViP+VNYNvAF4QQjj3BJTUbwvsIHVsC1+2CAH03Jq/YIOE4shsHNnV2wbfFF1t/M3vq4Lqzv+anehCabXx1Pp7n8gCewumD9pXEJBp9EcMHpSGK1CDxEfFrFZeKvmqRTj0guJ7CQP2GfSaspjIb5AbcLINIDJJ6qoM=----ATTACHMENT:----Nzk0NjM0Nzc0MDIyNTQwNCA1ODM0MzIyNDg1NDYxOTU5IDcwNjk5ODUwMDQ1NTk4NjU=