URI builder (Extbase)¶
The URI builder offers a convenient way to create links in an Extbase context.
Usage in an Extbase controller¶
The URI builder is available as a property in a controller class which extends the ActionController class.
Example:
<?php
declare(strict_types=1);
namespace MyVendor\MyExtension\Controller\MyController;
use Psr\Http\Message\ResponseInterface;
use TYPO3\CMS\Extbase\Mvc\Controller\ActionController;
final class MyController extends ActionController
{
public function myAction(): ResponseInterface
{
$url = $this->uriBuilder
->reset()
->setTargetPageUid(42)
->uriFor(
'anotherAction',
[
'myRecord' => 21,
],
'MyController',
'myextension',
'myplugin'
);
// do something with $url
}
}
Have a look into the API for the available methods of the URI builder.
Attention
As the URI builder holds state, you have to call reset() before
creating a URL.
Usage in another context¶
The \TYPO3\CMS\Extbase\Mvc\Web\Routing\UriBuilder class can be injected
via constructor in a class:
<?php
declare(strict_types=1);
namespace MyVendor\MyExtension\MyClass;
use TYPO3\CMS\Extbase\Mvc\Web\Routing\UriBuilder;
final class MyClass
{
private UriBuilder $uriBuilder;
public function __construct(UriBuilder $uriBuilder)
{
$this->uriBuilder = $uriBuilder;
}
public function doSomething()
{
$url = $this->uriBuilder
->reset()
->setTargetPageUid(42)
->uriFor(
'myAction',
[
'myRecord' => 21,
],
'MyController',
'myextension',
'myplugin'
);
// do something with $url
}
}
API¶
- class TYPO3\CMS\Extbase\Mvc\Web\Routing\UriBuilder¶
An URI Builder
- setArguments(array $arguments)¶
Additional query parameters.
If you want to "prefix" arguments, you can pass in multidimensional arrays: array('prefix1' => array('foo' => 'bar')) gets "&prefix1[foo]=bar"
- Parameters
$arguments (
array) -- the arguments
- Return type
- Returns
the current UriBuilder to allow method chaining
- setSection(string $section)¶
If specified, adds a given HTML anchor to the URI (#...)
- Parameters
$section (
string) -- the section
- Return type
- Returns
the current UriBuilder to allow method chaining
- setFormat(string $format)¶
Specifies the format of the target (e.g. "html" or "xml")
- Parameters
$format (
string) -- the format
- Return type
- Returns
the current UriBuilder to allow method chaining
- setCreateAbsoluteUri(bool $createAbsoluteUri)¶
If set, the URI is prepended with the current base URI. Defaults to FALSE.
- Parameters
$createAbsoluteUri (
bool) -- the createAbsoluteUri
- Return type
- Returns
the current UriBuilder to allow method chaining
- setAbsoluteUriScheme(string $absoluteUriScheme)¶
Sets the scheme that should be used for absolute URIs in FE mode
- Parameters
$absoluteUriScheme (
string) -- the scheme to be used for absolute URIs
- Return type
- Returns
the current UriBuilder to allow method chaining
- setLanguage(string $language)¶
Enforces a URI / link to a page to a specific language (or use "current")
- Parameters
$language (
string) -- the language
- Return type
- getLanguage()¶
- Return type
string
- setAddQueryString(bool $addQueryString)¶
If set, the current query parameters will be merged with $this->arguments. Defaults to FALSE.
- Parameters
$addQueryString (
bool) -- the addQueryString
- Return type
- Returns
the current UriBuilder to allow method chaining
- setArgumentsToBeExcludedFromQueryString(array $argumentsToBeExcludedFromQueryString)¶
A list of arguments to be excluded from the query parameters Only active if addQueryString is set
- Parameters
$argumentsToBeExcludedFromQueryString (
array) -- the argumentsToBeExcludedFromQueryString
- Return type
- Returns
the current UriBuilder to allow method chaining
- setArgumentPrefix(string $argumentPrefix)¶
Specifies the prefix to be used for all arguments.
- Parameters
$argumentPrefix (
string) -- the argumentPrefix
- Return type
- Returns
the current UriBuilder to allow method chaining
- setLinkAccessRestrictedPages(bool $linkAccessRestrictedPages)¶
If set, URIs for pages without access permissions will be created
- Parameters
$linkAccessRestrictedPages (
bool) -- the linkAccessRestrictedPages
- Return type
- Returns
the current UriBuilder to allow method chaining
- setTargetPageUid(int $targetPageUid)¶
Uid of the target page
- Parameters
$targetPageUid (
int) -- the targetPageUid
- Return type
- Returns
the current UriBuilder to allow method chaining
- setTargetPageType(int $targetPageType)¶
Sets the page type of the target URI. Defaults to 0
- Parameters
$targetPageType (
int) -- the targetPageType
- Return type
- Returns
the current UriBuilder to allow method chaining
- setNoCache(bool $noCache)¶
by default FALSE; if TRUE, &no_cache=1 will be appended to the URI
- Parameters
$noCache (
bool) -- the noCache
- Return type
- Returns
the current UriBuilder to allow method chaining
- reset()¶
Resets all UriBuilder options to their default value
- Return type
- Returns
the current UriBuilder to allow method chaining
- uriFor(string $actionName = NULL, array $controllerArguments = NULL, string $controllerName = NULL, string $extensionName = NULL, string $pluginName = NULL)¶
Creates an URI used for linking to an Extbase action.
Works in Frontend and Backend mode of TYPO3.
- Parameters
$actionName (
string) -- Name of the action to be called, default: NULL$controllerArguments (
array) -- Additional query parameters. Will be "namespaced" and merged with $this->arguments., default: NULL$controllerName (
string) -- Name of the target controller. If not set, current ControllerName is used., default: NULL$extensionName (
string) -- Name of the target extension, without underscores. If not set, current ExtensionName is used., default: NULL$pluginName (
string) -- Name of the target plugin. If not set, current PluginName is used., default: NULL
- Return type
string- Returns
the rendered URI
- build()¶
Builds the URI Depending on the current context this calls buildBackendUri() or buildFrontendUri()
- Return type
string- Returns
The URI