[Summary view] [Print] [Text view]

   1  <?php
   2  
   3  declare(strict_types=1);
   4  
   5  namespace Psr\Container;
   6  
   7  /**
   8   * Describes the interface of a container that exposes methods to read its entries.
   9   */
  10  interface ContainerInterface
  11  {
  12      /**
  13       * Finds an entry of the container by its identifier and returns it.
  14       *
  15       * @param string $id Identifier of the entry to look for.
  16       *
  17       * @throws NotFoundExceptionInterface  No entry was found for **this** identifier.
  18       * @throws ContainerExceptionInterface Error while retrieving the entry.
  19       *
  20       * @return mixed Entry.
  21       */
  22      public function get(string $id);
  23  
  24      /**
  25       * Returns true if the container can return an entry for the given identifier.
  26       * Returns false otherwise.
  27       *
  28       * `has($id)` returning true does not mean that `get($id)` will not throw an exception.
  29       * It does however mean that `get($id)` will not throw a `NotFoundExceptionInterface`.
  30       *
  31       * @param string $id Identifier of the entry to look for.
  32       *
  33       * @return bool
  34       */
  35      public function has(string $id);
  36  }