vendor/symfony/web-link/Link.php line 16

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\WebLink;
  14. use Psr\Link\EvolvableLinkInterface;
  16. class Link implements EvolvableLinkInterface
  17. {
  18.     // Relations defined in https://www.w3.org/TR/html5/links.html#links and applicable on link elements
  19.     public const REL_ALTERNATE = 'alternate';
  20.     public const REL_AUTHOR = 'author';
  21.     public const REL_HELP = 'help';
  22.     public const REL_ICON = 'icon';
  23.     public const REL_LICENSE = 'license';
  24.     public const REL_SEARCH = 'search';
  25.     public const REL_STYLESHEET = 'stylesheet';
  26.     public const REL_NEXT = 'next';
  27.     public const REL_PREV = 'prev';
  29.     // Relation defined in https://www.w3.org/TR/preload/
  30.     public const REL_PRELOAD = 'preload';
  32.     // Relations defined in https://www.w3.org/TR/resource-hints/
  33.     public const REL_DNS_PREFETCH = 'dns-prefetch';
  34.     public const REL_PRECONNECT = 'preconnect';
  35.     public const REL_PREFETCH = 'prefetch';
  36.     public const REL_PRERENDER = 'prerender';
  38.     // Extra relations
  39.     public const REL_MERCURE = 'mercure';
  41.     private $href = '';
  43.     /**
  44.      * @var string[]
  45.      */
  46.     private $rel = [];
  48.     /**
  49.      * @var array<string, string|bool|string[]>
  50.      */
  51.     private $attributes = [];
  53.     public function __construct(string $rel = null, string $href = '')
  54.     {
  55.         if (null !== $rel) {
  56.             $this->rel[$rel] = $rel;
  57.         }
  58.         $this->href = $href;
  59.     }
  61.     /**
  62.      * {@inheritdoc}
  63.      */
  64.     public function getHref(): string
  65.     {
  66.         return $this->href;
  67.     }
  69.     /**
  70.      * {@inheritdoc}
  71.      */
  72.     public function isTemplated(): bool
  73.     {
  74.         return $this->hrefIsTemplated($this->href);
  75.     }
  77.     /**
  78.      * {@inheritdoc}
  79.      */
  80.     public function getRels(): array
  81.     {
  82.         return array_values($this->rel);
  83.     }
  85.     /**
  86.      * {@inheritdoc}
  87.      */
  88.     public function getAttributes(): array
  89.     {
  90.         return $this->attributes;
  91.     }
  93.     /**
  94.      * {@inheritdoc}
  95.      *
  96.      * @return static
  97.      */
  98.     public function withHref($href)
  99.     {
  100.         $that = clone $this;
  101.         $that->href = $href;
  103.         return $that;
  104.     }
  106.     /**
  107.      * {@inheritdoc}
  108.      *
  109.      * @return static
  110.      */
  111.     public function withRel($rel)
  112.     {
  113.         $that = clone $this;
  114.         $that->rel[$rel] = $rel;
  116.         return $that;
  117.     }
  119.     /**
  120.      * {@inheritdoc}
  121.      *
  122.      * @return static
  123.      */
  124.     public function withoutRel($rel)
  125.     {
  126.         $that = clone $this;
  127.         unset($that->rel[$rel]);
  129.         return $that;
  130.     }
  132.     /**
  133.      * {@inheritdoc}
  134.      *
  135.      * @param string|\Stringable|int|float|bool|string[] $value
  136.      *
  137.      * @return static
  138.      */
  139.     public function withAttribute($attribute, $value)
  140.     {
  141.         $that = clone $this;
  142.         $that->attributes[$attribute] = $value;
  144.         return $that;
  145.     }
  147.     /**
  148.      * {@inheritdoc}
  149.      *
  150.      * @return static
  151.      */
  152.     public function withoutAttribute($attribute)
  153.     {
  154.         $that = clone $this;
  155.         unset($that->attributes[$attribute]);
  157.         return $that;
  158.     }
  160.     private function hrefIsTemplated(string $href): bool
  161.     {
  162.         return str_contains($href, '{') || str_contains($href, '}');
  163.     }
  164. }