捕获和转换Web的工具

捕获网站截图或将HTML转换为图像PHP API

使用以下功能创建完美的网站图像截图或将HTML直接转换为图像 GrabzIt的PHP API。 但是,在开始之前,请记住 URLToImage, HTMLToImage or FileToImage 方法 Save or SaveTo 必须调用方法来创建图像。

基本选项

只需一个参数即可截取网页或 转换HTML intoa图片 如以下示例所示。

$grabzIt->URLToImage("https://www.tesla.com");
//Then call the Save or SaveTo method
$grabzIt->HTMLToImage("<html><body><h1>Hello World!</h1></body></html>");
//Then call the Save or SaveTo method
$grabzIt->FileToImage("example.html");
//Then call the Save or SaveTo method

图像格式

GrabzIt的PHP API可以创建多种格式的图像,包括JPG,PNG,WEBP,BMP(8位,16位,24位或32位)和TIFF。 图像的默认格式是JPG。 但是,在这些情况下,对于某些应用程序而言,JPG图像的质量可能不够好,建议对图像截图使用PNG格式,因为它可以在质量和文件大小之间取得良好的平衡。 以下示例显示了使用PNG格式创建的图像。

$grabzIt = new \GrabzIt\GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");

$options = new \GrabzIt\GrabzItImageOptions();
$options->setFormat("png");

$grabzIt->URLToImage("https://www.tesla.com", $options);
//Then call the Save or SaveTo method
$grabzIt->SaveTo("result.png");
$grabzIt = new \GrabzIt\GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");

$options = new \GrabzIt\GrabzItImageOptions();
$options->setFormat("png");

$grabzIt->HTMLToImage("<html><body><h1>Hello World!</h1></body></html>", $options);
//Then call the Save or SaveTo method
$grabzIt->SaveTo("result.png");
$grabzIt = new \GrabzIt\GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");
            
$options = new \GrabzIt\GrabzItImageOptions();
$options->setFormat("png");

$grabzIt->FileToImage("example.html", $options);
//Then call the Save or SaveTo method
$grabzIt->SaveTo("result.png");

浏览器大小

浏览器大小是指在大多数情况下不需要捕获屏幕快照时将使用的浏览器窗口的大小,因为对于所有大多数任务而言,默认浏览器大小就足够了。 要设置浏览器大小,只需将一个值传递给 setBrowserWidth setBrowserHeight 的方法 GrabzItImageOptions 类。

更改图像大小

更改图像的大小很容易,但要做到不扭曲图像就更难了。 为了简化整个过程,我们建议您使用 简单的图像尺寸计算器.

如果要将图像的宽度和高度增加到大于浏览器的宽度和高度(默认为1024 x 728像素),则浏览器的宽度和高度也必须增加以匹配。

自订识别码

您可以将自定义标识符传递给 图片 方法,如下所示,然后将该值返回到您的GrabzIt PHP处理程序。 例如,该自定义标识符可以是数据库标识符,从而允许将屏幕截图或图像与特定的数据库记录相关联。

$grabzIt = new \GrabzIt\GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");

$options = new \GrabzIt\GrabzItImageOptions();
$options->setCustomId(123456);

$grabzIt->URLToImage("https://www.tesla.com", $options);
//Then call the Save method
$grabzIt->Save("http://www.example.com/handler.php");
$grabzIt = new \GrabzIt\GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");

$options = new \GrabzIt\GrabzItImageOptions();
$options->setCustomId(123456);

$grabzIt->HTMLToImage("<html><body><h1>Hello World!</h1></body></html>", $options);
//Then call the Save method
$grabzIt->Save("http://www.example.com/handler.php");
$grabzIt = new \GrabzIt\GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");

$options = new \GrabzIt\GrabzItImageOptions();
$options->setCustomId(123456);

$grabzIt->FileToImage("example.html", $options);
//Then call the Save method
$grabzIt->Save("http://www.example.com/handler.php");

全长截图

GrabzIt允许您截取整个网页的完整屏幕截图,以执行此操作,您需要将-1传递给 setBrowserHeight 方法。 为了确保图片与浏览器大小匹配,请将-1传递给 setHeight setWidth 方法。

$grabzIt = new \GrabzIt\GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");

$options = new \GrabzIt\GrabzItImageOptions();
$options->setBrowserHeight(-1);
$options->setWidth(-1);
$options->setHeight(-1);

$grabzIt->URLToImage("https://www.tesla.com", $options);
//Then call the Save or SaveTo method
$grabzIt->SaveTo("result.jpg");
$grabzIt = new \GrabzIt\GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");

$options = new \GrabzIt\GrabzItImageOptions();
$options->setBrowserHeight(-1);
$options->setWidth(-1);
$options->setHeight(-1);

$grabzIt->HTMLToImage("<html><body><h1>Hello World!</h1></body></html>", $options);
//Then call the Save or SaveTo method
$grabzIt->SaveTo("result.jpg");
$grabzIt = new \GrabzIt\GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");

$options = new \GrabzIt\GrabzItImageOptions();
$options->setBrowserHeight(-1);
$options->setWidth(-1);
$options->setHeight(-1);

$grabzIt->FileToImage("example.html", $options);
//Then call the Save or SaveTo method
$grabzIt->SaveTo("result.jpg");

您也可以返回未裁剪的屏幕截图,但是请注意,这会创建较大的图像。 为此,将-1传递给 setHeightsetWidth 方法。 传递-1的任何尺寸都不会被裁剪。

$grabzIt = new \GrabzIt\GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");

$options = new \GrabzIt\GrabzItImageOptions();
$options->setWidth(-1);
$options->setHeight(-1);

$grabzIt->URLToImage("https://www.tesla.com", $options);
//Then call the Save or SaveTo method
$grabzIt->SaveTo("result.jpg");
$grabzIt = new \GrabzIt\GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");

$options = new \GrabzIt\GrabzItImageOptions();
$options->setWidth(-1);
$options->setHeight(-1);

$grabzIt->HTMLToImage("<html><body><h1>Hello World!</h1></body></html>", $options);
//Then call the Save or SaveTo method
$grabzIt->SaveTo("result.jpg");
$grabzIt = new \GrabzIt\GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");

$options = new \GrabzIt\GrabzItImageOptions();
$options->setWidth(-1);
$options->setHeight(-1);

$grabzIt->FileToImage("example.html", $options);
//Then call the Save or SaveTo method
$grabzIt->SaveTo("result.jpg");
请注意,浏览器没有全长!

使用这些特殊值意味着您可以创建一个截图,该截图是整个网页的完整版本!

截取页面元素的屏幕截图

GrabzIt允许您截取HTML元素的屏幕截图,例如 div or span 标记并捕获其所有内容。 为此,必须将要截屏的HTML元素的ID或类指定为 CSS选择器.

...
<div id="features">
	<img src="http://www.example.com/peace.jpg"/><h3>World Peace Announced</h3>
</div>
...

对于下面的示例,我们将选择id为“ features”的div,并将其输出为250 x 250px JPEG图像。

$grabzIt = new \GrabzIt\GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");

// The 250 parameters indicates that image should be sized to 250 x 250 px
$options = new \GrabzIt\GrabzItImageOptions();
$options->setWidth(250);
$options->setHeight(250);
$options->setFormat("jpg");
$options->setTargetElement("#features");

$grabzIt->URLToImage("http://www.bbc.co.uk/news", $options);
//Then call the Save or SaveTo method
$grabzIt->SaveTo("result.jpg");

下一个示例获取“功能” div的另一个屏幕截图,但是这次输出的JPEG图像恰好是div的大小。

$grabzIt = new \GrabzIt\GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");

// The -1 indicates that image should not be cropped
$options = new \GrabzIt\GrabzItImageOptions();
$options->setWidth(-1);
$options->setHeight(-1);
$options->setBrowserHeight(-1);
$options->setFormat("jpg");
$options->setTargetElement("#features");

$grabzIt->URLToImage("http://www.bbc.co.uk/news", $options);
//Then call the Save or SaveTo method
$grabzIt->SaveTo("result.jpg");