UrlPackage

class UrlPackage extends Package

Package that adds a base URL to asset URLs in addition to a version.

The package allows to use more than one base URLs in which case it randomly chooses one for each asset; it also guarantees that any given path will always use the same base URL to be nice with HTTP caching mechanisms.

When the request context is available, this package can choose the best base URL to use based on the current request scheme:

  • For HTTP request, it chooses between all base URLs;
  • For HTTPs requests, it chooses between HTTPs base URLs and relative protocol URLs or falls back to any base URL if no secure ones are available.

Methods

__construct(string|string[] $baseUrls, VersionStrategyInterface $versionStrategy, ContextInterface $context = null)
string getVersion(string $path)

Returns the asset version for an asset.

from Package
string getUrl(string $path)

Returns an absolute or root-relative public path.

string getBaseUrl(string $path)

Returns the base URL for a path.

Details

__construct(string|string[] $baseUrls, VersionStrategyInterface $versionStrategy, ContextInterface $context = null)

Parameters

string|string[] $baseUrls Base asset URLs
VersionStrategyInterface $versionStrategy
ContextInterface $context

string getVersion(string $path)

Returns the asset version for an asset.

Parameters

string $path A path

Return Value

string The version string

string getUrl(string $path)

Returns an absolute or root-relative public path.

Parameters

string $path A path

Return Value

string The public path

string getBaseUrl(string $path)

Returns the base URL for a path.

Parameters

string $path

Return Value

string The base URL

© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/4.0/Symfony/Component/Asset/UrlPackage.html