spatie/mixed-content-scanner

Scan your site for mixed content

Tuesday, May 22, 2018
by Spatie
Repository
3 Watchers
45 Stars
1,397 Installations

PHP
2 Dependents
0 Suggesters
5 Forks
0 Open issues
28 Versions
11 % Grown

The README.md

Scan your site for mixed content

, _(*1)

This package contains a class that can scan your site for mixed content., _(*2)

Here's an example of how you can use it:, _(*3)

use Spatie\MixedContentScanner\MixedContentScanner;

$logger = new MixedContentLogger();

$scanner = new MixedContentScanner($logger);

$scanner->scan('https://example.com');

MixedContentLogger is a class containing methods that get called when mixed content is (not) found., _(*4)

If you don't need a custom implementation but simply want to look for mixed content using a command line tool, take a look at our mixed-content-scanner-cli package., _(*5)

Support us

Learn how to create a package like this one, by watching our premium video course:, _(*6)

, _(*7)

We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products., _(*8)

We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall., _(*9)

Installation

You can install the package via composer:, _(*10)

composer require spatie/mixed-content-scanner

How it works under the hood

When scanning a site, the scanner will crawl everypage. On the retrieve html, these elements and attributes will be checked:, _(*11)

audio: src
embed: src
form: action
link: href
iframe: src
img: src, srcset
object: data
param: value
script: src
source: src, srcset
video: src

If any of those attributes start with http:// the element will be regarded as mixed content., _(*12)

The package does not scan linked .css or .js files, nor does it take inline <script> or <style> and shortlinks into consideration., _(*13)

Usage

use Spatie\MixedContentScanner\MixedContentScanner

$logger = new MixedContentLogger();

$scanner = new MixedContentScanner($logger);

$scanner->scan('https://example.com');

That MixedContentScanner accepts an instance of a class that extends \Spatie\MixedContentScannerMixedContentObserver. You should create such a class yourself. Let's take a look at an example implementation., _(*14)

use Psr\Http\Message\UriInterface;
use Spatie\MixedContentScanner\MixedContent;
use Spatie\MixedContentScanner\MixedContentObserver;

class MyMixedContentLogger extends MixedContentObserver
{
    /**
     * Will be called when mixed content was found.
     * 
     * @param \Spatie\MixedContentScanner\MixedContent $mixedContent
     */
    public function mixedContentFound(MixedContent $mixedContent): void
    {
    }

    /**
     * Will be called when no mixed content was found on the given url.
     * 
     * @param \Psr\Http\Message\UriInterface $crawledUrl
     */
    public function noMixedContentFound(UriInterface $crawledUrl): void
    {
    }

    /**
     * Will be called when the scanner has finished crawling.
     */
    public function finishedCrawling(): void
    {
    }
}

Of course, you should supply a function body to these methods yourself. If you don't need a function just leave it off., _(*15)

The $mixedContent variable the mixedContentFound class accept is an instance of \Spatie\MixedContentScanner\MixedContent which has these three properties:, _(*16)

$elementName: the name of the element that is regarded as mixed content
$mixedContentUrl: the url of the element that is regarded as mixed content. For an image this can be the value of src or srcset for a form this can be the value of action, ...
$foundOnUrl: the url where the mixed content was found

Customizing the requests

The scanner is powered by our homegrown Crawler which on it's turn leverages Guzzle to perform webrequests. You can pass an array of options to the second argument of MixedContentScanner. These options will be passed to the Guzzle Client., _(*17)

Here's an example where ssl verification is being turned off., _(*18)

$scanner = new MixedContentScanner($logger);
$scanner->scan('https://laravel.com', ['verify' => 'false']);

Filtering the crawled urls

By default, the mixed content scanner will crawl all urls of the hostname given. If you want to filter the urls to be crawled, you can pass the scanner a class that extends Spatie\Crawler\CrawlProfile., _(*19)

Here's the content of that class:, _(*20)

namespace Spatie\Crawler;

use Psr\Http\Message\UriInterface;

abstract class CrawlProfile
{
    /**
     * Determine if the given url should be crawled.
     *
     * @param \Psr\Http\Message\UriInterface $url
     *
     * @return bool
     */
    abstract public function shouldCrawl(UriInterface $url): bool;
}

And here's how you can let the scanner use your profile:, _(*21)

use Spatie\MixedContentScanner\MixedContentScanner;

$logger = new MixedContentLogger();

$scanner = new MixedContentScanner($logger);

$scanner->setCrawlProfile(new MyCrawlProfile);

Customizing the crawler

The scanner is powered by our homegrown Crawler. You can call any methods on the crawler before the crawling process starts by calling configureCrawler on a MixedContentScanner., _(*22)

use Spatie\Crawler\Crawler;
use Spatie\MixedContentScanner\MixedContentScanner;

$scanner = (new MixedContentScanner($logger))
    ->configureCrawler(function(Crawler $crawler) {
        $crawler->setConcurrency(1) // now all urls will be crawled one by one 
    });

Changelog

Please see CHANGELOG for more information what has changed recently., _(*23)

Testing

bash composer test, _(*24)

Contributing

Please see CONTRIBUTING for details., _(*25)

Security

If you've found a bug regarding security please mail security@spatie.be instead of using the issue tracker., _(*26)

Postcardware

You're free to use this package, but if it makes it to your production environment we highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using., _(*27)

Our address is: Spatie, Kruikstraat 22, 2018 Antwerp, Belgium., _(*28)

We publish all received postcards on our company website., _(*29)

Credits

The scanner is inspired by mixed-content-scan by Bram Van Damme. Parts of his readme and code were used., _(*30)

License

The MIT License (MIT). Please see License File for more information., _(*31)

The Versions

22/05 2018

dev-master

9999999-dev https://github.com/spatie/mixed-content-scanner

Scan your site for mixed content

library mixed-content-scanner