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: public function locate($name, $currentPath = null, $first = true);
31: }
32: