# Imagick::pingImageFile

(PECL imagick 2, PECL imagick 3)

Imagick::pingImageFile — Get basic image attributes in a lightweight manner

### 说明

public Imagick::pingImageFile(resource `$filehandle`, string `$fileName` = ?): bool

This method can be used to query image width, height, size, and format without reading the whole image to memory. 此方法在Imagick基于ImageMagick 6.2.9以上版本编译时可用。

### 参数

`filehandle`

  An open filehandle to the image.

`fileName`

  Optional filename for this image.

### 返回值

成功时返回 `true`。

### 示例

示例 #1 Using Imagick::pingImageFile()

Opening a remote location

`<?php
/* fopen a remote location */
$fp = fopen("http://example.com/test.jpg");
/* create new imagick object */
$im = new Imagick();
/* pass the handle to imagick */
$im->pingImageFile($fp);
?>`

### 参见

- Imagick::pingImage() - Fetch basic attributes about the image
- Imagick::pingImageBlob() - Quickly fetch attributes
- Imagick::readImage() - Reads image from filename
- Imagick::readImageBlob() - 从二进制字符串里读取图片
- Imagick::readImageFile() - Reads image from open filehandle

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open