microweber / screen
A PHP Class to interact with PhantomJs and capture screenshot of a webpage
Requires
- php: >=5.3
Requires (Dev)
- symfony/var-dumper: ~3.0
This package is auto-updated.
Last update: 2024-12-14 20:33:31 UTC
README
Web site screenshot tool based on PHP and PhantomJS You can use it to take screenshots for testing or monitoring service
Install
Via Composer
$ composer require microweber/screen
If 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.
Linux requirements
- FontConfig -
apt-get/yum install fontconfig
- FreeType -
apt-get/yum install freetype*
Usage
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
jpg
and the background color is not set, the default value will be#FFFFFF
, ifpng
the 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.png
Injection your own JS into the web page
You 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(...)
Passing options to PhantomJS
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 ]);
Other configurations
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/phantomjs
Change 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.jpg
You can also clean/delete all the generated job files like this:
$screenCapture->jobs->clean();
License
The MIT License (MIT). Please see License File for more information.
Credits
Thanks to the PhantomJS (LICENSE) guys for creating their awesome WebKit scripting interface.
This tool was originally created to take screenshots for Microweber