Overview
KB
Technical FAQ
PHP Manual
CSS2 Manual
HTML Manual
JS Guide
JS Reference
PhpDock Manual
Nu-Coder Manual
PhpExpress Manual
PHP Joomla
Development
Learn PHP
 
<imagegifimagegrabwindow>
^GD and Image FunctionsLast updated: Mon, 26 Oct 2026

imagegrabscreen

(PHP 5 >= 5.2.2, PHP 7, PHP 8)

imagegrabscreen — Captures the whole screen

Description

function imagegrabscreen(): GdImage|false

Grabs a screenshot of the whole screen.

Note:

This function is only available on Windows.

Parameters

This function has no parameters.

Return Values

Returns an image object on success, false on failure.

Changelog

Version Description
8.0.0 On success, this function returns a GDImage instance now; previously, a resource was returned.

Examples

Example #1 imagegrabscreen() example

This example demonstrates how to take a screenshot of the current screen and save it as a png image.

<?php
$im = imagegrabscreen();
imagepng($im, "myscreenshot.png");
?>

See Also


<imagegifimagegrabwindow>
^GD and Image FunctionsLast updated: Mon, 26 Oct 2026