balpom/web-link

Advanced interfaces for HTTP links and it's realisation.

v1.1.0 2024-05-24 06:01 UTC

Requires

• php: >=8.1
• psr/link: ^1.1|^2.0
• symfony/web-link: >=6.4

MIT

• Mikhail (Balpom)

• http
• web
• url
• link
• uri
• http2
• psr-13
• psr13
• weblink

README

WebLink component extends LinkInterface and EvolvableLinkInterface from PSR-13 Link definition interfaces

This WebLink component extends PSR-13 Link definition interfaces and added to it additional methods:

interface WebLinkInterface extends LinkInterface
{
    // Returns the HTML tag which contains the link.
    public function getTag(): string;
    
    // For paired tags returns the HTML content between link open and close tags.
    public function getContent(): string;
    
    // Returns the attribute value or null, if attribute not exist.
    public function getAttribute(string $attr): string|int|float|bool|array|null;
}

interface EvolvableWebLinkInterface extends EvolvableLinkInterface, WebLinkInterface
{
    // Returns an instance with the specified tag.
    public function withTag(string $tag): static;

    // Returns an instance with the specified content.
    public function withContent(string $content): static;
}

Trivial realisation of WebLink component based on Symfony WebLink component https://github.com/symfony/web-link/

use Symfony\Component\WebLink\Link;
class WebLink extends Link implements EvolvableWebLinkInterface
{
// ...
}

License

MIT License See LICENSE.MD