balpom/links-extractor

Extract all links from string in extended PSR-13 format.

v1.1.2 2024-05-29 14:57 UTC

Requires

• php: >=8.1
• balpom/web-link: ^1.1
• psr/link: ^1.1|^2.0
• sabberworm/php-css-parser: >=8.5.1

MIT

• Mikhail (Balpom)

• http
• css
• parser
• url
• response
• html
• parsing
• link
• uri
• extract
• extractor
• href
• src
• psr-7
• psr7
• http2
• psr-13
• psr13

README

Extract all links from string and provide it in extended PSR-13 format.

This extractor extract all HTTP links from given string (or PSR-7 Response object) and provide it in Balpom\WebLink\EvolvableWebLinkInterface format (which extends Psr\Link\EvolvableLinkInterface (https://www.php-fig.org/psr/psr-13/) format) as collection in Psr\Link\LinkProviderInterface format (see also https://www.php-fig.org/psr/psr-13/).

Requirements

• PHP >= 8.1

Installation

Using composer (recommended)

composer require balpom/links-extractor

How to use

There are two extractor realisation in this package: Balpom\LinksExtractor\SimpleExtractor and Balpom\LinksExtractor\Extractor

SimpleExtractor usage samples:

$css = 'div.cls1{background-image:url(/image-file-1.jpg);}
span.cls2{background-image:url(/image-file-2.png);}';

$extractor = new SimpleExtractor($css, 'text/css');
$linksProvider = $extractor->extract();
print_r($linksProvider->getLinks());

$html = '<a href="/page.html">ABC</a><a href="/page.html">XYZ</a>
<img src="/image-file-3.gif"><div>Else one <img src="/image-file-3.gif"></div>';

$extractor = new SimpleExtractor($html, 'text/html');
$linksProvider = $extractor->extract();
print_r($linksProvider->getLinks());

Extractor works also as a SimpleExtractor, but takes as a constructor argument an Psr\Http\Message\ResponseInterface object (https://www.php-fig.org/psr/psr-7/), not a string.

License

MIT License See LICENSE.MD