1. class
  2. Symfony
  3. \
  4. Component
  5. \
  6. Asset
  7. \
  8. UrlPackage

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)

No description

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.

ContextInterface
getContext()

No description

from Package
VersionStrategyInterface
getVersionStrategy()

No description

from Package
isAbsoluteUrl($url)

No description

from Package
string
getBaseUrl(string $path)

Returns the base URL for a path.

int
chooseBaseUrl(string $path)

Determines which base URL to use for the given 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

protected ContextInterface getContext()

Return Value

ContextInterface

protected VersionStrategyInterface getVersionStrategy()

Return Value

VersionStrategyInterface

protected isAbsoluteUrl($url)

Parameters

$url

string getBaseUrl(string $path)

Returns the base URL for a path.

Parameters

string $path

Return Value

string The base URL

protected int chooseBaseUrl(string $path)

Determines which base URL to use for the given path.

Override this method to change the default distribution strategy. This method should always return the same base URL index for a given path.

Parameters

string $path

Return Value

int The base URL index for the given path