vendor/symfony/asset/Packages.php line 58

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