KernelInterface::locateResource()

string|array locateResource(string $name, string $dir = null, bool $first = true)

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

before looking in the bundle resource folder.

string	$name	A resource name to locate
string	$dir	A directory where to look for the resource first
bool	$first	Whether to return the first path or paths for all matching bundles

string|array

The absolute path of the resource or an array if $first is false

InvalidArgumentException	if the file cannot be found or the name is not valid
RuntimeException	if the name contains invalid/unsafe characters

Links:

doc_Symfony

2016-10-28 06:22:12

Comments