README

Extensible Image Extractor to find all Image tags in a string. The library uses the symfony DomCrawler as base of extraction.

You can add multiple Extractors to find img tags or video tags to f.e resolve youtube thumbs. (or try the Video Preview Image Extractor)
You can add own XPath expressions to ImageXPathExtractor.
You can define custom & additional Extractors.
You can add multiple Filter to filter the found Images.
You can define custom Filter.
You can resolve relative image pathes with a FixRelativePathFilter.

As extractor a ImageXPathExtractor gets shipped, which fetches all img tags.

These filters are provided:

a StrPosFilter which filters images that contain one of the given filter strings.
a FixRelativePathFilter that adds a basePath to all relative image paths.

Install

Via Composer

{
    "require": {
        "ivoba/image-extractor": "dev-master"
    }
}

Usage

$extractorList = [new ImageXPathExtractor()];
$filter = [new StrPosFilter(['flattr-badge', 'feedburner.com']];
$imageExtractor = new ImageExtractor($extractorList, $filter);
$images = $imageExtractor->extract(file_get_contents($file));

A factory method for the default ImageExtractor with a default ImageXPathExtractor is provided:

    $imageCreator = ImageExtractor::create();

Testing

$ phpunit

Contributing

Please see CONTRIBUTING for details.

Credits

Ivo Bathke(https://github.com/ivoba)

License

The MIT License (MIT). Please see License File for more information.

ivoba / image-extractor

Maintainers

Details