www.aleph1.co.uk Git - yaffs-website/blob - vendor/psr/container/src/ContainerInterface.php

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