Overview

Namespaces

  • Autarky
    • Config
      • Loaders
    • Console
    • Container
      • Exception
      • Factory
      • Proxy
    • Database
    • Errors
    • Events
    • Files
    • Http
    • Logging
    • Providers
    • Routing
      • Events
    • Testing
    • TwigTemplating
      • Extensions
    • Utils

Classes

  • PartialExtension
  • SessionExtension
  • UrlGenerationExtension
  • Overview
  • Namespace
  • Class

Class UrlGenerationExtension

Extension for url generating functionality in templates.

Parts shamelessly stolen from Symfony 2.

Twig_Extension
Extended by Autarky\TwigTemplating\Extensions\UrlGenerationExtension
Namespace: Autarky\TwigTemplating\Extensions
Located at Extensions/UrlGenerationExtension.php
Methods summary
public
# __construct( Autarky\Routing\UrlGenerator $urlGenerator )

Constructor.

Constructor.

Parameters

$urlGenerator
public
# getFunctions( )
public string
# getUrl( string $name, array $parameters = array(), boolean $relative = false )

Implementation of the url(route) twig function.

Implementation of the url(route) twig function.

Parameters

$name
Route name
$parameters
Route parameters
$relative
Whether to generate an absolute or relative URL.

Returns

string
public [type]
# getAsset( string $path, boolean $relative = false )

Implementation of the asset(path) twig function.

Implementation of the asset(path) twig function.

Parameters

$path
Path to the asset, relative to the webroot or asset root.
$relative
Whether to generate an absolute or relative URL.

Returns

[type]
[description]
public array
# isUrlGenerationSafe( Twig_Node $argsNode )

Determines at compile time whether the generated URL will be safe and thus saving the unneeded automatic escaping for performance reasons.

Determines at compile time whether the generated URL will be safe and thus saving the unneeded automatic escaping for performance reasons.

The URL generation process percent encodes non-alphanumeric characters. So there is no risk that malicious/invalid characters are part of the URL. The only character within an URL that must be escaped in html is the ampersand ("&") which separates query params. So we cannot mark the URL generation as always safe, but only when we are sure there won't be multiple query params. This is the case when there are none or only one constant parameter given. E.g. we know beforehand this will be safe: - path('route') - path('route', {'param': 'value'}) But the following may not: - path('route', var) - path('route', {'param': ['val1', 'val2'] }) // a sub-array - path('route', {'param1': 'value1', 'param2': 'value2'}) If param1 and param2 reference placeholder in the route, it would still be safe. But we don't know.

Parameters

$argsNode
The arguments of the path/url function

Returns

array
An array with the contexts the URL is safe

Author

Fabien Potencier fabien@symfony.com
public
# getName( )
Properties summary
protected Autarky\Routing\UrlGenerator $urlGenerator
#
Autarky Framework API documentation generated by ApiGen