imagecreatefromstring

Create a new image from the image stream in the string

&reftitle.description; ``GdImage``false```imagecreatefromstring` `string` `data`

`imagecreatefromstring` returns an image identifier representing the image obtained from the given `data`. These types will be automatically detected if your build of PHP supports them: JPEG, PNG, GIF, BMP, WBMP, GD2, and WEBP.

&reftitle.parameters;

`data`

- A string containing the image data.

&reftitle.returnvalues;

An image object will be returned on success. &false; is returned if the image type is unsupported, the data is not in a recognised format, or the image is corrupt and cannot be loaded.

&reftitle.errors;

`imagecreatefromstring` raises an E_WARNING level error, if the data is not in a recognized format.

&reftitle.changelog;

&Version; | &Description;
8.0.0 | On success, this function returns a `GDImage` instance now; previously, a `resource` was returned.
7.3.0 | WEBP is supported now (if supported by the libgd in use).

&reftitle.examples;

### `imagecreatefromstring` example

    <?php
    $data = 'iVBORw0KGgoAAAANSUhEUgAAABwAAAASCAMAAAB/2U7WAAAABl'
           . 'BMVEUAAAD///+l2Z/dAAAASUlEQVR4XqWQUQoAIAxC2/0vXZDr'
           . 'EX4IJTRkb7lobNUStXsB0jIXIAMSsQnWlsV+wULF4Avk9fLq2r'
           . '8a5HSE35Q3eO2XP1A1wQkZSgETvDtKdQAAAABJRU5ErkJggg==';
    $data = base64_decode($data);

    $im = imagecreatefromstring($data);
    if ($im !== false) {
        header('Content-Type: image/png');
        imagepng($im);
        imagedestroy($im);
    }
    else {
        echo 'An error occurred.';
    }
    ?>

&example.outputs.similar; Output of example : imagecreatefromstring()
&reftitle.seealso;

- `imagecreatefromjpeg`
- `imagecreatefrompng`
- `imagecreatefromgif`
- `imagecreatetruecolor`