vendor/symfony/asset/Packages.php line 31

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, iterable $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.     public function addPackage(string $name, PackageInterface $package)
  46.     {
  47.         $this->packages[$name] = $package;
  48.     }
  50.     /**
  51.      * Returns an asset package.
  52.      *
  53.      * @param string $name The name of the package or null for the default package
  54.      *
  55.      * @return PackageInterface
  56.      *
  57.      * @throws InvalidArgumentException If there is no package by that name
  58.      * @throws LogicException           If no default package is defined
  59.      */
  60.     public function getPackage(?string $name = null)
  61.     {
  62.         if (null === $name) {
  63.             if (null === $this->defaultPackage) {
  64.                 throw new LogicException('There is no default asset package, configure one first.');
  65.             }
  67.             return $this->defaultPackage;
  68.         }
  70.         if (!isset($this->packages[$name])) {
  71.             throw new InvalidArgumentException(sprintf('There is no "%s" asset package.', $name));
  72.         }
  74.         return $this->packages[$name];
  75.     }
  77.     /**
  78.      * Gets the version to add to public URL.
  79.      *
  80.      * @param string $path        A public path
  81.      * @param string $packageName A package name
  82.      *
  83.      * @return string
  84.      */
  85.     public function getVersion(string $path, ?string $packageName = null)
  86.     {
  87.         return $this->getPackage($packageName)->getVersion($path);
  88.     }
  90.     /**
  91.      * Returns the public path.
  92.      *
  93.      * Absolute paths (i.e. http://...) are returned unmodified.
  94.      *
  95.      * @param string $path        A public path
  96.      * @param string $packageName The name of the asset package to use
  97.      *
  98.      * @return string A public path which takes into account the base path and URL path
  99.      */
  100.     public function getUrl(string $path, ?string $packageName = null)
  101.     {
  102.         return $this->getPackage($packageName)->getUrl($path);
  103.     }
  104. }