HTML::Mason::Resolver::File - Component path resolver for file-based components
my $resolver = HTML::Mason::Resolver::File->new( comp_root => '/var/www/mason' ); my $info = $resolver->get_info('/some/comp.html'); my $comp_root = $resolver->comp_root;
This HTML::Mason::Resolver subclass is used when components are stored on the filesystem, which is the norm for most Mason-based applications.
new method takes a single mandatory parameter,
The component root marks the top of your component hierarchy and defines how component paths are translated into real file paths. For example, if your component root is /usr/local/httpd/docs, a component path of /products/index.html translates to the file /usr/local/httpd/docs/products/index.html.
This parameter may be either a scalar or an array reference. If it is a scalar, it should be a filesystem path indicating the component root. If it is an array reference, it should be of the following form:
[ [ key1 => '/path/to/root' ], [ key2 => '/path/to/other/root' ] ]
The "keys" for each path must be unique names and their "values" must be filesystem paths. These paths will be searched in the provided order whenever a component path must be resolved to a filesystem path.
This method returns the component root, which will either be a scalar or an array reference, as documented here.