[函数]imagepng函数—用法及示例

适用PHP版本(PHP 4, PHP 5, PHP 7, PHP 8)

说明

imagepng(
    GdImage $image,
    resource|string|null $file = null,
    int $quality = -1,
    int $filters = -1
): bool

从指定 image 输出或保存 PNG 图像。

参数
image
由图象创建函数(例如imagecreatetruecolor())返回的 GdImage 对象。

file
文件保存的路径或者已打开的流资源（此方法返回后自动关闭该流资源），如果未设置或为 null，将会直接输出原始图象流。

注意:

如果未使用 quality 和 filters 参数，则 null 无效。

quality
压缩级别：从 0（不压缩）到 9。 默认值（-1）使用 zlib 压缩默认值。 有关详细信息，请参阅 » zlib 手册。

filters
允许减小 PNG 文件的大小。它是位掩码字段，可以设置为任意 PNG_FILTER_XXX 常量的组合。PNG_NO_FILTER 或 PNG_ALL_FILTERS 也可分别用于禁用或激活所有过滤器。 默认值（-1）禁用过滤。

警告
系统 libgd 忽略 filters 参数。

返回值
成功时返回 true， 或者在失败时返回 false。

警告
如果 libgd 输出图像失败，函数会返回 true。

更新日志

版本	说明
8.0.0	image 现在需要 GdImage 实例；之前需要有效的 gd resource。

示例

<?php
$im = imagecreatefrompng("test.png");

header('Content-Type: image/png');

imagepng($im);
imagedestroy($im);
?>