Web site screenshot tool based on PHP and PhantomJS You can use it to take screenshots for testing or monitoring service
Via Composer
$ composer require microweber/screenIf on any Unix system, you need to make the bin executable chmod +x /path/to/screen/bin/phantomjs
The directory /path/to/screen/jobs must be writable as well.
- FontConfig -
apt-get/yum install fontconfig - FreeType -
apt-get/yum install freetype*
With this library you can make use of PhantomJs to screenshot a website.
Check our demo or read the following instructions.
Creating the object, you can either pass the URL on the constructor or set it later on
use Screen\Capture;
$url = 'https://github.com';
$screenCapture = new Capture($url);
// or
$screenCapture = new Capture();
$screenCapture->setUrl($url);You can also set the browser dimensions
$screenCapture->setWidth(1200);
$screenCapture->setHeight(800);you can set also DOM Element Position (top, left)
$screenCapture->setTop(100);
$screenCapture->setLeft(100);This will output all the page including the content rendered beyond the setted dimensions (e.g.: all the scrollable content), if you want just the content inside those boudaries you need to clip the result
// You also need to set the width and height.
$screenCapture->setClipWidth(1200);
$screenCapture->setClipHeight(800);Some webpages don't have a background color setted to the body, if you want you can set the color using this method
$screenCapture->setBackgroundColor('#ffffff');You can also set the User Agent
$screenCapture->setUserAgentString('Some User Agent String');And the resulted image type
// allowed types are 'jpg' and 'png', default is 'jpg'.
$screenCapture->setImageType(Screen\Image\Types\Png::FORMAT);
// or
$screenCapture->setImageType('png');- If the format is
jpgand the background color is not set, the default value will be#FFFFFF, ifpngthe default background color will be transparent.
And most importantly, save the result
$fileLocation = '/some/dir/test.' . $screen->getImageType()->getFormat();
$screenCapture->save($fileLocation);
// you don't need to set the file extension
$fileLocation = '/some/dir/test';
$screenCapture->save($fileLocation); // Will automatically determine the extension type
echo $screenCapture->getImageLocation(); // --> /some/dir/test.pngYou can also run your own JS scripts or snippets before the screenshot.
For that we have the method includeJs, here are some usage examples:
// Including a remote file
$jQueryUrl = 'https://ajax.googleapis.com/ajax/libs/jquery/3.1.0/jquery.min.js';
$screenCapture->includeJs(new \Screen\Injection\Url($jQUeryUrl));
// Including a local file
$localFilePath = 'path/to/my/script.js';
$screenCapture->includeJs(new \Screen\Injection\LocalPath($localFilePath));
// Using the scripts included on the library
$screen->includeJs(new \Screen\Injection\Scripts\FacebookHideCookiesPolicy());
$screen->includeJs(new \Screen\Injection\Scripts\FacebookHideSignUp());
// Using a js snippet
$screen->includeJs("console.log('This is supa cool!');");Just use this method before calling save(...)
You can set the options that will be passed to the PhantomJS binary.
$screenCapture->setOptions([
'ignore-ssl-errors' => 'yes',
// '--ignore-ssl-errors' => 'yes', // dashes may be omitted
]);Additionally to the basic usage, you can set so extra configurations.
You can change the where the PhantomJS binary file is.
$screenCapture->binPath = '/path/to/bin/dir/';
// This will result in /path/to/bin/dir/phantomjsChange the jobs location
$screenCapture->jobs->setLocation('/path/to/jobs/dir/');
echo $screenCapture->jobs->getLocation(); // -> /path/to/jobs/dir/And set an output base location
$screenCapture->output->setLocation('/path/to/output/dir/');
echo $screenCapture->output->getLocation(); // -> /path/to/output/dir/
// if the output location is setted
$screenCapture->save('file.jpg');
// will save the file to /path/to/output/dir/file.jpgYou can also clean/delete all the generated job files like this:
$screenCapture->jobs->clean();The MIT License (MIT). Please see License File for more information.
Thanks to the PhantomJS (LICENSE) guys for creating their awesome WebKit scripting interface.
This tool was originally created to take screenshots for Microweber