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

  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.     public function getHref(): string
  62.     {
  63.         return $this->href;
  64.     }
  66.     public function isTemplated(): bool
  67.     {
  68.         return $this->hrefIsTemplated($this->href);
  69.     }
  71.     public function getRels(): array
  72.     {
  73.         return array_values($this->rel);
  74.     }
  76.     public function getAttributes(): array
  77.     {
  78.         return $this->attributes;
  79.     }
  81.     public function withHref(string|\Stringable $href): static
  82.     {
  83.         $that = clone $this;
  84.         $that->href = $href;
  86.         return $that;
  87.     }
  89.     public function withRel(string $rel): static
  90.     {
  91.         $that = clone $this;
  92.         $that->rel[$rel] = $rel;
  94.         return $that;
  95.     }
  97.     public function withoutRel(string $rel): static
  98.     {
  99.         $that = clone $this;
  100.         unset($that->rel[$rel]);
  102.         return $that;
  103.     }
  105.     public function withAttribute(string $attribute, string|\Stringable|int|float|bool|array $value): static
  106.     {
  107.         $that = clone $this;
  108.         $that->attributes[$attribute] = $value;
  110.         return $that;
  111.     }
  113.     public function withoutAttribute(string $attribute): static
  114.     {
  115.         $that = clone $this;
  116.         unset($that->attributes[$attribute]);
  118.         return $that;
  119.     }
  121.     private function hrefIsTemplated(string $href): bool
  122.     {
  123.         return str_contains($href, '{') || str_contains($href, '}');
  124.     }
  125. }