www.aleph1.co.uk Git - yaffs-website/blob - vendor/symfony/config/FileLocatorInterface.php

   1 <?php
   2
   3 /*
   4  * This file is part of the Symfony package.
   5  *
   6  * (c) Fabien Potencier <fabien@symfony.com>
   7  *
   8  * For the full copyright and license information, please view the LICENSE
   9  * file that was distributed with this source code.
  10  */
  11
  12 namespace Symfony\Component\Config;
  13
  14 /**
  15  * @author Fabien Potencier <fabien@symfony.com>
  16  */
  17 interface FileLocatorInterface
  18 {
  19     /**
  20      * Returns a full path for a given file name.
  21      *
  22      * @param string      $name        The file name to locate
  23      * @param string|null $currentPath The current path
  24      * @param bool        $first       Whether to return the first occurrence or an array of filenames
  25      *
  26      * @return string|array The full path to the file or an array of file paths
  27      *
  28      * @throws \InvalidArgumentException When file is not found
  29      */
  30     public function locate($name, $currentPath = null, $first = true);
  31 }