4 * This file is part of the Symfony package.
6 * (c) Fabien Potencier <fabien@symfony.com>
8 * For the full copyright and license information, please view the LICENSE
9 * file that was distributed with this source code.
12 namespace Symfony\Component\Config;
14 use Symfony\Component\Config\Exception\FileLocatorFileNotFoundException;
17 * @author Fabien Potencier <fabien@symfony.com>
19 interface FileLocatorInterface
22 * Returns a full path for a given file name.
24 * @param string $name The file name to locate
25 * @param string|null $currentPath The current path
26 * @param bool $first Whether to return the first occurrence or an array of filenames
28 * @return string|array The full path to the file or an array of file paths
30 * @throws \InvalidArgumentException If $name is empty
31 * @throws FileLocatorFileNotFoundException If a file is not found
33 public function locate($name, $currentPath = null, $first = true);