Symfony\Component\HttpKernel\KernelInterface::locateResource
Returns the file path for a given resource.
A Resource can be a file or a directory. The resource name must follow the following pattern: @BundleName/path/to/a/file.something where BundleName is the name of the bundle and the remaining part is the relative path in the bundle. If $dir is passed, and the first segment of the path is Resources, this method will look for a file named: $dir/BundleName/path/without/Resources
Signature
public function locateResource(string
$name,
[string
$dir = null,
[Boolean
$first = true]] )
Parameters
$name
— string- A resource name to locate
$dir
— string- A directory where to look for the resource first
$first
— object- Whether to return the first path or paths for all matching bundles
Returns
- string|array
- The absolute path of the resource or an array if $first is false
Errors/Exceptions
-
InvalidArgumentException
- if the file cannot be found or the name is not valid
-
RuntimeException
- if the name contains invalid/unsafe characters