aki / yii2-wbsite-screenshot
wbsite-screenshot for yii2 web application
Installs: 236
Dependents: 0
Suggesters: 0
Security: 0
Stars: 3
Watchers: 2
Forks: 0
Open Issues: 0
Type:yii2-extension
Requires
- yiisoft/yii2: ~2.0.0
This package is auto-updated.
Last update: 2024-12-13 11:32:04 UTC
README
#Screen
Web site screenshot tool based on PHP and PhantomJS You can use it to take screenshots for testing or monitoring service
Install
Via Composer
php composer.phar require --prefer-dist aki/yii2-wbsite-screenshot:dev-master
or add
"aki/yii2-wbsite-screenshot": "dev-master"
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 writeble 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 constructer or set it later on
use aki\screenshot\ScreenShot; $url = 'https://github.com'; $screenCapture = new ScreenShot($url); // or $screenCapture = new ScreenShot(); $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.