(PHP 4, PHP 5, PHP 7)

imagecreatefrompngCria uma nova imagem a partir de um arquivo ou URL


imagecreatefrompng ( string $filename ) : resource

imagecreatefrompng() retorna um identificador de imagem representando a imagem obtida através do nome de arquivo dado.

imagecreatefrompng() retorna uma string vazia em caso de falha. Também mostra uma mensagem de erro, a qual infelizmente aparece como um link quebrado no browser. Para facilitar o debug, o exemplo asseguir irá prodizir um PNG de erro:

Exemplo #1 Exemplo de como manipular um erro durante a criação

function LoadPNG($imgname
$im = @imagecreatefrompng($imgname); /* Attempt to open */
if (!$im) { /* See if it failed */
$im  imagecreatetruecolor(15030); /* Create a blank image */
$bgc imagecolorallocate($im255255255);
$tc  imagecolorallocate($im000);
/* Output an errmsg */
imagestring($im155"Error loading $imgname"$tc);
header("Content-Type: image/png");
$img LoadPNG("bogus.image");

O exemplo acima irá imprimir algo similar à:



Uma URL pode ser utilizada como um nome de arquivo se fopen wrappers estiver ativo. Veja fopen() para mais detalhes em como especificar URLs como nome de arquivo. Veja também the Protocolos e Wrappers suportados para informações sobre que capacidades cada wrapper tem, notas de uso e informações sobre variáveis predefinidas fornecidas.



Caminho para a imagem PNG

Valor Retornado

Retorna um identificador de resource de imagem em sucesso, false em erros.


add a note add a note

User Contributed Notes 7 notes

18 years ago
If you're trying to load a translucent png-24 image but are finding an absence of transparency (like it's black), you need to enable alpha channel AND save the setting. I'm new to GD and it took me almost two hours to figure this out.

= imageCreateFromPng($strImagePath);
imageAlphaBlending($imgPng, true);
imageSaveAlpha($imgPng, true);

/* Output image to browser */
header("Content-type: image/png");
marcos at assl-site dot net
16 years ago
I had the same problem as jboyd1189 at yahoo dot com but I solve d it allocating more memory dynamically.

Usually the memory_limit var on php.ini is set to 8M. Unfortunately, the required amount of memory to manage a PNG image about 1000x1000 could be bigger !

The approach I used to solve the problem is:

1-Calculate the memory required by the image
2-Set the new memory_limit value
3-Create the PNG image and thumbnail
4-Restore the original value

1-The following value works for me:
$required_memory = Round($width * $height * $size['bits']);

Note that for JPEG the requirements are not the same:

2-Use somthing like:
$new_limit=memory_get_usage() + $required_memory;
ini_set("memory_limit", $new_limit);

4-ini_restore ("memory_limit");
sageptr at gmail dot com
1 year ago
Because gd and imagick do not support animated PNG (at this moment), i wrote a simple function to determine if given PNG is APNG or not. It does not validate PNG, only checks whenever "acTL" chunk appears before "IDAT" like the specification says:


function is_apng(string $filename): bool
$f = new \SplFileObject($filename, 'rb');
$header = $f->fread(8);
    if (
$header !== "\x89PNG\r\n\x1A\n") {
    while (!
$f->eof()) {
$bytes $f->fread(4);
        if (
strlen($bytes) < 4) {
$length = unpack('N', $bytes)[1];
$chunkname = $f->fread(4);
        switch (
$chunkname) {
$f->fseek($length + 4, SEEK_CUR);

admin at wdfa dot co dot uk
14 years ago
When using imagecreatepng with alpha blending you will lose the blending.

To over come this use something like the following
imagecopyresampled($dstimage,$srcimage,0,0,0,0, $width,$height,$width,$height);
Where $width and $height are the width and height of the $src image.

This will create a true colour image then copy the png image to this true colour image and retain alpha blending.
7 years ago
The image size (width x height) should not exceed INT_MAX ... It's still thrue on a 64 bits computer.
katalin at knittedforyou dot com
5 years ago
I have this code:

if (exif_imagetype($this->img_name) == IMAGETYPE_PNG) {
                try {
                    $this->image = imagecreatefrompng($this->img_name);
                    Error::log('It is a png: '.$this->img_name);
                } catch (Exception $e) {
                    echo "The image file has some strange charachters. Probably not a png image?";
                    $this->image = '';
                    $this->img_name = '';

And I get this error in the error.log:
PHP Unknown error:  imagecreatefrompng(): gd-png: fatal libpng error: Extra compressed data\n in Unknown on line 0

The file that I try to open is a generated .png image which I can open from gimp and Geeqie.

What is the problem? Could you please help me?
jboyd1189 at yahoo dot com
16 years ago
I was having a terrible time with the imagecreatefrompng function as it was working perfectly for one image and not at all for another.  After many hours of frustration, I discovered that the problem was the image size (number of pixels).  It appears that the maximum number of pixels this function will process is 1,040,000.  So, be sure that the pixel resolution of the image (eg. 1040 x 1000) does not exceed this value.
To Top