[Summary view] [Print] [Text view]

   1  <?php
   2  
   3  namespace OAuth\Common\Storage;
   4  
   5  use OAuth\Common\Token\TokenInterface;
   6  use OAuth\Common\Storage\Exception\TokenNotFoundException;
   7  
   8  /**
   9   * All token storage providers must implement this interface.
  10   */
  11  interface TokenStorageInterface
  12  {
  13      /**
  14       * @param string $service
  15       *
  16       * @return TokenInterface
  17       *
  18       * @throws TokenNotFoundException
  19       */
  20      public function retrieveAccessToken($service);
  21  
  22      /**
  23       * @param string         $service
  24       * @param TokenInterface $token
  25       *
  26       * @return TokenStorageInterface
  27       */
  28      public function storeAccessToken($service, TokenInterface $token);
  29  
  30      /**
  31       * @param string $service
  32       *
  33       * @return bool
  34       */
  35      public function hasAccessToken($service);
  36  
  37      /**
  38       * Delete the users token. Aka, log out.
  39       *
  40       * @param string $service
  41       *
  42       * @return TokenStorageInterface
  43       */
  44      public function clearToken($service);
  45  
  46      /**
  47       * Delete *ALL* user tokens. Use with care. Most of the time you will likely
  48       * want to use clearToken() instead.
  49       *
  50       * @return TokenStorageInterface
  51       */
  52      public function clearAllTokens();
  53  }