# imagewebp

(PHP 5 >= 5.4.0, PHP 7)

imagewebp — 将 WebP 格式的图像输出到浏览器或文件

### 说明

imagewebp ( resource `$image` [, mixed `$to` = `NULL` [, int `$quality` = 80 ]] ) : bool

将 `image` 参数指定的图像以 WebP 格式输出到浏览器或者保存到文件。

### 参数

`image`

  由图象创建函数(例如imagecreatetruecolor())返回的图象资源。

`to`

  文件保存的路径，如果未设置或为 `NULL`，将会直接输出原始图象流。

`quality`

  `quality` 范围从0（最低质量，最小文件体积）到100 （最好质量, 最大文件体积）。

### 返回值

成功时返回 `TRUE`， 或者在失败时返回 `FALSE`。

### 更新日志

版本 | 说明
--- | ---
5.4.0 | 支持把 resource 流作为 `to` 参数传入。

### 范例

Example #1 保存为 WebP 图像文件

    <?php
    // 创建一个空图像并在其上加入一些文字
    $im = imagecreatetruecolor(120, 20);
    $text_color = imagecolorallocate($im, 233, 14, 91);

    imagestring($im, 1, 5, 5,  'WebP with PHP', $text_color);

    // 保存图像
    imagewebp($im, 'php.webp');

    // 释放内存
    imagedestroy($im);
    ?>