scope()

Signature

scope() — returns struct

Available in: mapper Category: Routing

Description

Set any number of parameters to be inherited by mappers called within this matcher’s block. For example, set a package or URL path to be used by all child routes.

Parameters

Name	Type	Required	Default	Description
name	string	no	—	Name to prepend to child route names for use when building links, forms, and other URLs.
path	string	no	—	Path to prefix to all child routes.
package	string	no	—	Package namespace to append to controllers.
controller	string	no	—	Controller to use for routes.
shallow	boolean	no	—	Turn on shallow resources to eliminate routing added before this one.
shallowPath	string	no	—	Shallow path prefix.
shallowName	string	no	—	Shallow name prefix.
constraints	struct	no	—	Variable patterns to use for matching.
$call	string	no	scope

Examples

<cfscript>

mapper()
    // All routes inside will use the `freeForAll` controller.
    .scope(controller="freeForAll")
        .get(name="bananas", action="bananas")
        .root(action="index")
    .end()

    // All routes's controllers inside will be inside the `public` package/subfolder.
    .scope(package="public")
        .resource(name="search", only="show,create")
    .end()

    // All routes inside will be prepended with a URL path of `phones/`.
    .scope(path="phones")
        .get(name="newest", to="phones##newest")
        .get(name="sortOfNew", to="phones##sortOfNew")
    .end()
.end();

</cfscript>