vendor/symfony/asset/Packages.php line 105

Open in your IDE?
  1. <?php
  3. /*
  4.  * This file is part of the Symfony package.
  5.  *
  6.  * (c) Fabien Potencier <fabien@symfony.com>
  7.  *
  8.  * For the full copyright and license information, please view the LICENSE
  9.  * file that was distributed with this source code.
  10.  */
  12. namespace Symfony\Component\Asset;
  14. use Symfony\Component\Asset\Exception\InvalidArgumentException;
  15. use Symfony\Component\Asset\Exception\LogicException;
  17. /**
  18.  * Helps manage asset URLs.
  19.  *
  20.  * @author Fabien Potencier <fabien@symfony.com>
  21.  * @author Kris Wallsmith <kris@symfony.com>
  22.  */
  23. class Packages
  24. {
  25.     private $defaultPackage;
  26.     private $packages = [];
  28.     /**
  29.      * @param PackageInterface[] $packages Additional packages indexed by name
  30.      */
  31.     public function __construct(PackageInterface $defaultPackage = null, array $packages = [])
  32.     {
  33.         $this->defaultPackage = $defaultPackage;
  35.         foreach ($packages as $name => $package) {
  36.             $this->addPackage($name, $package);
  37.         }
  38.     }
  40.     public function setDefaultPackage(PackageInterface $defaultPackage)
  41.     {
  42.         $this->defaultPackage = $defaultPackage;
  43.     }
  45.     /**
  46.      * Adds a  package.
  47.      *
  48.      * @param string $name The package name
  49.      */
  50.     public function addPackage($name, PackageInterface $package)
  51.     {
  52.         $this->packages[$name] = $package;
  53.     }
  55.     /**
  56.      * Returns an asset package.
  57.      *
  58.      * @param string $name The name of the package or null for the default package
  59.      *
  60.      * @return PackageInterface An asset package
  61.      *
  62.      * @throws InvalidArgumentException If there is no package by that name
  63.      * @throws LogicException           If no default package is defined
  64.      */
  65.     public function getPackage($name = null)
  66.     {
  67.         if (null === $name) {
  68.             if (null === $this->defaultPackage) {
  69.                 throw new LogicException('There is no default asset package, configure one first.');
  70.             }
  72.             return $this->defaultPackage;
  73.         }
  75.         if (!isset($this->packages[$name])) {
  76.             throw new InvalidArgumentException(sprintf('There is no "%s" asset package.', $name));
  77.         }
  79.         return $this->packages[$name];
  80.     }
  82.     /**
  83.      * Gets the version to add to public URL.
  84.      *
  85.      * @param string $path        A public path
  86.      * @param string $packageName A package name
  87.      *
  88.      * @return string The current version
  89.      */
  90.     public function getVersion($path, $packageName = null)
  91.     {
  92.         return $this->getPackage($packageName)->getVersion($path);
  93.     }
  95.     /**
  96.      * Returns the public path.
  97.      *
  98.      * Absolute paths (i.e. http://...) are returned unmodified.
  99.      *
  100.      * @param string $path        A public path
  101.      * @param string $packageName The name of the asset package to use
  102.      *
  103.      * @return string A public path which takes into account the base path and URL path
  104.      */
  105.     public function getUrl($path, $packageName = null)
  106.     {
  107.         return $this->getPackage($packageName)->getUrl($path);
  108.     }
  109. }