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 mixed   $name        The file name to locate

    23      * @param string  $currentPath The current path

    24      * @param Boolean $first       Whether to return the first occurrence or an array of filenames

    25      *

    26      * @return string|array The full path to the file|An array of file paths

    27      *

    28      * @throws \InvalidArgumentException When file is not found

    29      */

    30     function locate($name, $currentPath = null, $first = true);

    31 }