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;
15 * @author Fabien Potencier <fabien@symfony.com>
17 interface FileLocatorInterface
20 * Returns a full path for a given file name.
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
26 * @return string|array The full path to the file or an array of file paths
28 * @throws \InvalidArgumentException When file is not found
30 public function locate($name, $currentPath = null, $first = true);