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 string $href = '';
  43.     /**
  44.      * @var string[]
  45.      */
  46.     private array $rel = [];
  48.     /**
  49.      * @var array<string, string|bool|string[]>
  50.      */
  51.     private array $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.     public function withHref(string|\Stringable $href): static
  97.     {
  98.         $that = clone $this;
  99.         $that->href = $href;
  101.         return $that;
  102.     }
  104.     /**
  105.      * {@inheritdoc}
  106.      */
  107.     public function withRel(string $rel): static
  108.     {
  109.         $that = clone $this;
  110.         $that->rel[$rel] = $rel;
  112.         return $that;
  113.     }
  115.     /**
  116.      * {@inheritdoc}
  117.      */
  118.     public function withoutRel(string $rel): static
  119.     {
  120.         $that = clone $this;
  121.         unset($that->rel[$rel]);
  123.         return $that;
  124.     }
  126.     /**
  127.      * {@inheritdoc}
  128.      */
  129.     public function withAttribute(string $attribute, string|\Stringable|int|float|bool|array $value): static
  130.     {
  131.         $that = clone $this;
  132.         $that->attributes[$attribute] = $value;
  134.         return $that;
  135.     }
  137.     /**
  138.      * {@inheritdoc}
  139.      */
  140.     public function withoutAttribute(string $attribute): static
  141.     {
  142.         $that = clone $this;
  143.         unset($that->attributes[$attribute]);
  145.         return $that;
  146.     }
  148.     private function hrefIsTemplated(string $href): bool
  149.     {
  150.         return str_contains($href, '{') || str_contains($href, '}');
  151.     }
  152. }