Описание тега gdlib
Вступление
PHP не ограничивается созданием только вывода HTML. Его также можно использовать для создания и управления файлами изображений в различных форматах изображений, включая GIF, PNG, JPEG, WBMP и XPM. Еще удобнее то, что PHP может выводить потоки изображений прямо в браузер. Чтобы это работало, вам необходимо скомпилировать PHP с библиотекой функций изображений GD. GD и PHP могут также потребовать другие библиотеки, в зависимости от того, с какими форматами изображений вы хотите работать.
Вы можете использовать функции изображений в PHP, чтобы получить размер изображений JPEG, GIF, PNG, SWF, TIFF и JPEG2000.
С расширением exif вы можете работать с информацией, хранящейся в заголовках изображений JPEG и TIFF. Таким образом вы можете читать метаданные, созданные цифровыми камерами. Функции exif не требуют библиотеки GD.
Требования
Если у вас есть библиотека GD (доступная по адресу " https://libgd.github.io/), вы также сможете создавать изображения и управлять ими.
Формат изображений, которыми вы можете манипулировать, зависит от версии GD, которую вы устанавливаете, и любых других библиотек, которые могут потребоваться GD для доступа к этим форматам изображений. Версии GD до gd-1.6 поддерживают изображения в формате GIF и не поддерживают PNG, в то время как версии выше gd-1.6 и ниже gd-2.0.28 поддерживают PNG, а не GIF. Поддержка GIF была повторно включена в gd-2.0.28.
Установка
Чтобы включить поддержку GD, настройте PHP --with-gd[=DIR], где DIR - это базовый установочный каталог GD. Чтобы использовать рекомендованную версию библиотеки GD (которая впервые была включена в PHP 4.3.0), используйте параметр конфигурации --with-gd. Библиотека GD требует для компиляции libpng и libjpeg.
В Windows вы включите GD2 DLL php_gd2.dll в качестве расширения в php.ini. DLL-библиотека GD1 php_gd.dll была удалена в PHP 4.3.2. Также обратите внимание, что предпочтительные функции изображений с истинным цветом, такие как imagecreatetruecolor(), требуют GD2.
Расширьте возможности GD для обработки большего количества форматов изображений, указав переключатель конфигурации --with-XXXX в строке конфигурации PHP.
Конфигурация среды выполнения
На поведение этих функций влияют настройки в php.ini.
Дополнительные сведения и определения режимов PHP_INI_* см. В разделе " Где могут быть установлены параметры конфигурации".
Вот краткое объяснение директив конфигурации.
gd.jpeg_ignore_warning bool
Игнорировать предупреждения, созданные jpeg2wbmp() и imagecreatefromjpeg ().
См. Также директивы конфигурации exif.
Предупреждение: функции изображения очень интенсивно используют память. Обязательно установите memory_limit достаточно высоким.
Типы ресурсов
Это расширение определяет два типа ресурсов: идентификатор изображения и идентификатор шрифта.
Предопределенные константы
Приведенные ниже константы определены этим расширением и будут доступны только в том случае, если расширение либо скомпилировано в PHP, либо динамически загружено во время выполнения.
- GD_VERSION (строка) - Версия PHP для GD была скомпилирована. (Доступно с PHP 5.2.4)
- GD_MAJOR_VERSION (integer) - основная версия PHP GD была скомпилирована. (Доступно с PHP 5.2.4)
- GD_MINOR_VERSION (целое число) - минорная версия GD, с которой скомпилировался PHP. (Доступно с PHP 5.2.4)
- GD_RELEASE_VERSION (целое число) - версия выпуска GD, с которой компилировался PHP. (Доступно с PHP 5.2.4)
- GD_EXTRA_VERSION (строка) - "Дополнительная" версия GD (beta/rc..) PHP была скомпилирована. (Доступно с PHP 5.2.4)
- GD_BUNDLED (целое число) - когда используется связанная версия GD, это 1, в противном случае устанавливается значение 0.
- IMG_GIF (целое число) - используется в качестве возвращаемого значения функцией imagetypes ()
- IMG_JPG (целое число) - используется в качестве возвращаемого значения функцией imagetypes ()
- IMG_JPEG (целое число) - используется в качестве возвращаемого значения функцией imagetypes () (эта константа имеет то же значение, что и IMG_JPG)
- IMG_PNG (целое число) - используется в качестве возвращаемого значения функцией imagetypes ()
- IMG_WBMP (целое число) - используется в качестве возвращаемого значения функцией imagetypes ()
- IMG_XPM (целое число) - используется в качестве возвращаемого значения функцией imagetypes ()
- IMG_COLOR_TILED (integer) - специальный параметр цвета, который можно использовать вместо цвета, выделенного с помощью imagecolorallocate () или imagecolorallocatealpha ()
- IMG_COLOR_STYLED (integer) - специальный параметр цвета, который можно использовать вместо цвета, выделенного с помощью imagecolorallocate () или imagecolorallocatealpha ()
- IMG_COLOR_BRUSHED (integer) - специальный параметр цвета, который можно использовать вместо цвета, выделенного с помощью imagecolorallocate () или imagecolorallocatealpha ()
- IMG_COLOR_STYLEDBRUSHED (целое число) - специальный параметр цвета, который можно использовать вместо цвета, выделенного с помощью imagecolorallocate () или imagecolorallocatealpha ()
- IMG_COLOR_TRANSPARENT (integer) - специальный параметр цвета, который можно использовать вместо цвета, выделенного с помощью imagecolorallocate () или imagecolorallocatealpha ()
- IMG_ARC_ROUNDED (целое число) - константа стиля, используемая функцией imagefilledarc () (эта константа имеет то же значение, что и IMG_ARC_PIE)
- IMG_ARC_PIE (целое число) - константа стиля, используемая функцией imagefilledarc ().
- IMG_ARC_CHORD (integer) - константа стиля, используемая функцией imagefilledarc ().
- IMG_ARC_NOFILL (целое число) - константа стиля, используемая функцией imagefilledarc ().
- IMG_ARC_EDGED (integer) - константа стиля, используемая функцией imagefilledarc ().
- IMG_GD2_RAW (integer) - константа типа, используемая функцией imagegd2().
- IMG_GD2_COMPRESSED (целое число) - константа типа, используемая функцией imagegd2().
- IMG_EFFECT_REPLACE (integer) - эффект альфа-смешивания, используемый функцией imagelayereffect ().
- IMG_EFFECT_ALPHABLEND (целое число) - эффект альфа-смешивания, используемый функцией imagelayereffect ().
- IMG_EFFECT_NORMAL (integer) - эффект альфа-смешивания, используемый функцией imagelayereffect ().
- IMG_EFFECT_OVERLAY (integer) - эффект альфа-смешивания, используемый функцией imagelayereffect ().
- IMG_FILTER_NEGATE (integer) - специальный фильтр GD, используемый функцией imagefilter ().
- IMG_FILTER_GRAYSCALE (integer) - специальный фильтр GD, используемый функцией imagefilter ().
- IMG_FILTER_BRIGHTNESS (integer) - специальный фильтр GD, используемый функцией imagefilter ().
- IMG_FILTER_CONTRAST (integer) - специальный фильтр GD, используемый функцией imagefilter ().
- IMG_FILTER_COLORIZE (integer) - специальный фильтр GD, используемый функцией imagefilter ().
- IMG_FILTER_EDGEDETECT (integer) - специальный фильтр GD, используемый функцией imagefilter ().
- IMG_FILTER_GAUSSIAN_BLUR (integer) - специальный фильтр GD, используемый функцией imagefilter ().
- IMG_FILTER_SELECTIVE_BLUR (integer) - специальный фильтр GD, используемый функцией imagefilter ().
- IMG_FILTER_EMBOSS (integer) - специальный фильтр GD, используемый функцией imagefilter ().
- IMG_FILTER_MEAN_REMOVAL (integer) - специальный фильтр GD, используемый функцией imagefilter ().
- IMG_FILTER_SMOOTH (integer) - специальный фильтр GD, используемый функцией imagefilter ().
- IMG_FILTER_PIXELATE (integer) - специальный фильтр GD, используемый функцией imagefilter (). (Доступно с PHP 5.3.0)
- IMAGETYPE_GIF (целое число) - константа типа изображения, используемая функциями image_type_to_mime_type () и image_type_to_extension().
- IMAGETYPE_JPEG (целое число) - константа типа изображения, используемая функциями image_type_to_mime_type () и image_type_to_extension().
- IMAGETYPE_JPEG2000 (целое число) - константа типа изображения, используемая функциями image_type_to_mime_type () и image_type_to_extension().
- IMAGETYPE_PNG (целое число) - Константа типа изображения, используемая функциями image_type_to_mime_type () и image_type_to_extension().
- IMAGETYPE_SWF (целое число) - константа типа изображения, используемая функциями image_type_to_mime_type () и image_type_to_extension().
- IMAGETYPE_PSD (целое число) - константа типа изображения, используемая функциями image_type_to_mime_type () и image_type_to_extension().
- IMAGETYPE_BMP (целое число) - константа типа изображения, используемая функциями image_type_to_mime_type () и image_type_to_extension().
- IMAGETYPE_WBMP (целое число) - константа типа изображения, используемая функциями image_type_to_mime_type () и image_type_to_extension().
- IMAGETYPE_XBM (целое число) - константа типа изображения, используемая функциями image_type_to_mime_type () и image_type_to_extension().
- IMAGETYPE_TIFF_II (целое число) - константа типа изображения, используемая функциями image_type_to_mime_type () и image_type_to_extension().
- IMAGETYPE_TIFF_MM (integer) - Константа типа изображения, используемая функциями image_type_to_mime_type () и image_type_to_extension().
- IMAGETYPE_IFF (целое число) - константа типа изображения, используемая функциями image_type_to_mime_type () и image_type_to_extension().
- IMAGETYPE_JB2 (целое число) - константа типа изображения, используемая функциями image_type_to_mime_type () и image_type_to_extension().
- IMAGETYPE_JPC (целое число) - константа типа изображения, используемая функциями image_type_to_mime_type () и image_type_to_extension().
- IMAGETYPE_JP2 (целое число) - константа типа изображения, используемая функциями image_type_to_mime_type () и image_type_to_extension().
- IMAGETYPE_JPX (целое число) - константа типа изображения, используемая функциями image_type_to_mime_type () и image_type_to_extension().
- IMAGETYPE_SWC (целое число) - константа типа изображения, используемая функциями image_type_to_mime_type () и image_type_to_extension().
- IMAGETYPE_ICO (integer) - константа типа изображения, используемая функциями image_type_to_mime_type () и image_type_to_extension(). (Доступно с PHP 5.3.0)
- PNG_NO_FILTER (integer) - специальный фильтр PNG, используемый функцией imagepng ().
- PNG_FILTER_NONE (integer) - специальный фильтр PNG, используемый функцией imagepng ().
- PNG_FILTER_SUB (integer) - специальный фильтр PNG, используемый функцией imagepng ().
- PNG_FILTER_UP (integer) - специальный фильтр PNG, используемый функцией imagepng ().
- PNG_FILTER_AVG (integer) - специальный фильтр PNG, используемый функцией imagepng ().
- PNG_FILTER_PAETH (integer) - специальный фильтр PNG, используемый функцией imagepng ().
- PNG_ALL_FILTERS (integer) - специальный фильтр PNG, используемый функцией imagepng ().