getimagesize

(PHP 4, PHP 5, PHP 7, PHP 8)

getimagesize — Отримання розміру зображення

Опис

getimagesize(string $filename, array &$image_info = null): array|false

Функцияgetimagesize() визначить розмір будь-якого заданого, підтримуваного зображення та поверне цей розмір разом із типом файлу та текстовим рядком height/width, яку можна буде використовувати всередині тега HTML IMG, а також поверне відповідний тип вмісту HTTP.

Такжеgetimagesize() може повернути додаткові відомості про зображення через аргумент image_info

Застереження

Функція очікує, що filename є правильним файлом зображення. Якщо буде передано файл, що не містить зображення, він може бути некоректно інтерпретований як зображення і функція завершиться успішно, але масив буде містити безглузді значення.

Не используйтеgetimagesize() для перевірки, що файл є зображенням. Для цього використовуйте модуль Fileinfo

Зауваження: Зверніть увагу на те, що окремі частини JPC та JP2 зображень можуть мати різну глибину кольору. У цьому випадку параметр "bits" буде стояти максимальне значення з усіх виявлених. Також JP2 файли можуть містити кілька кодових потоків JPEG 2000. В такому випадку getimagesize() поверне значення для першого потоку, який буде виявлено функцією в корені файлу.

Зауваження: Інформація про іконки витягується з іконки з найбільшим бітрейтом

Зауваження: Зображення GIF складаються з одного або декількох кадрів, де кожен кадр може займати лише частину зображення. Розмір зображення, що повертається getimagesize(), буде загальним розміром (прочитаним з дескриптора логічного екрану).

Список параметрів

filename

Цей аргумент задає файл, відомості про який витягуватиметься. Це може бути локальний чи віддалений (залежить від конфігурації) файл. Передача даних віддаленого файлу повинна здійснюватися одним із підтримуваних потоків

image_info

Цей необов'язковий аргумент дозволяє отримати деякі розширені відомості з файлу зображення. На даний момент можна отримати різні JPG APP маркери у вигляді асоціативного масиву. Деякі програми використовують ці маркери для вбудовування тексту у зображення. Найчастіше вбудовують » IPTC відомості в APP13 маркер. Для перетворення двійкових даних APP13 маркера на щось легкочитане можна скористатися функцією iptcparse()

Зауваження :

image_info підтримує лише файли JFIF.

Значення, що повертаються

Повертає масив із 7 елементів. Не всі типи зображень містять елементи з каналами (channels) та бітрейтом (bits

Індекси 0 і 1 містять ширину та висоту зображення.

Зауваження :

Деякі формати файлів можуть зберігати кілька зображень або взагалі не містити зображення. В таких випадках getimagesize() не зможе визначити розмір зображення . getimagesize() поверне нулі як значення висоти і ширини.

Индекс 2 содержит одну из констант типа изображенияIMAGETYPE_XXX

Індекс 3 містить рядок зі значеннями ширини та висоти зображення height="yyy" width="xxx"яка може бути використана всередині тега IMG.

mime - Відповідний MIME-тип зображення. Ці відомості використовуються для коректної обробки зображення на основі заголовка Content-type :

Приклад #1getimagesize()** та MIME типи**

Loading...
▶

channels приймає значення 3 для RGB картинок та 4 для CMYK.

bits - Глибина кольору, число біт для кожного кольору.

Для деяких типів зображень наявність значень channelsиbits може збити з пантелику. Наприклад, GIF завжди використовує 3 канали на піксель, але глибину кольору неможливо обчислити для анімованих GIF зображень із загальною таблицею кольорів.

У разі виникнення помилки функція поверне false

Помилки

Якщо доступ до файлу filenameневозможен,getimagesize() викличе помилку рівня E_WARNING. У разі виникнення помилки читання файлу getimagesize() викличе помилку рівня E_NOTICE

список змін

Версия	Опис
8.2.0	Тепер повертає фактичні розміри, біти та канали зображень AVIF; раніше розміри повідомлялися як 0x0, а біти та канали не повідомлялися взагалі.
7.1.0	Додано підтримку WebP.

Приклади

Приклад #2 Приклад використання getimagesize()****

Loading...
▶

Приклад #3 getimagesize (URL)

Loading...
▶

Приклад #4 getimagesize(), що повертає IPTC

Loading...
▶

Примітки

Зауваження :

Ця функція не потребує бібліотеки GD.

Дивіться також

• image_type_to_mime_type() - Отримання Mime-типу для типу зображення, що повертається функціями getimagesize, exif_read_data, exif_thumbnail, exif_imagetype
• exif_imagetype() - Determine the type of an image
• exif_read_data() - Читає заголовки EXIF ​​із файлів зображень
• exif_thumbnail() - Отримує вбудоване прев'ю зображення
• imagesx() - Отримання ширини зображення
• imagesy() - Отримання висоти зображення