Функция FILE_IS_DISPLAYABLE_IMAGE() в WordPress: проверка изображения для отображения

# Функция FILE_IS_DISPLAYABLE_IMAGE() │ WP 2.5.0

Эта функция проверяет, является ли файл подходящим для отображения на веб-странице.

- **Время выполнения:** 1 раз — 0.000001 сек (скорость света) | 50000 раз — 0.42 сек (очень быстро).
- **PHP версия:** 7.2.16, **WP версия:** 5.1.1.

## Хуки функции

file_is_displayable_image

## Возвращаемые значения

Функция возвращает true или false. Значение true, если файл можно отображать, и false, если нет.

## Использование

Для использования этой функции необходимо передать ей путь к файлу:

```php
file_is_displayable_image( $path );

Параметры

• $path (строка) (обязательный) — Путь к файлу, который нужно проверить.

Примеры

Пример 1: Пров��рка, является ли файл изображением

require_once ABSPATH . 'wp-admin/includes/image.php';

$path     = 'F:serversiteswp-test.ruwp-adminimagesalign-center.png';
$is_image = file_is_displayable_image( $path ); //> true

$path     = 'F:serversiteswp-test.ruwp-admincsscommon.css';
$is_image = file_is_displayable_image( $path ); //> false

if ( $is_image ) {
    echo 'Файл является изображением';
} else {
    echo 'Файл не является изображением';
}

Измените свой собственный пример

Добавьте свои примеры использования функции здесь.

Изменения

С версии 2.5.0 — функция была представлена.

Код функции FILE_IS_DISPLAYABLE_IMAGE()

Функция определяет, можно ли отобразить изображение на веб-странице:

function file_is_displayable_image( $path ) {
    $displayable_image_types = array( IMAGETYPE_GIF, IMAGETYPE_JPEG, IMAGETYPE_PNG, IMAGETYPE_BMP, IMAGETYPE_ICO, IMAGETYPE_WEBP, IMAGETYPE_AVIF );

    $info = wp_getimagesize( $path );
    if ( empty( $info ) ) {
        $result = false;
    } elseif ( ! in_array( $info[2], $displayable_image_types, true ) ) {
        $result = false;
    } else {
        $result = true;
    }

    /**
     * Фильтрует, можно ли отобразить текущее изображение в браузере.
     * 
     * @since 2.5.0
     * 
     * @param bool   $result Может ли изображение отображаться. По умолчанию true.
     * @param string $path   Путь к изображению.
     */
    return apply_filters( 'file_is_displayable_image', $result, $path );
}

Связанные функции

Ниже приведены несколько связанных функций, которые могут быть полезны:

• Получить данные файла: get_file_data()
• Данные плагина: get_plugin_data()
• Форматировать размер: size_format()
• Конвертировать человеко читаемый размер в байты: wp_convert_hr_to_bytes()
• Читать метаданные изображения: wp_read_image_metadata()

Заключение

Функция file_is_displayable_image крайне полезна для проверки, является ли файл изображением. Используйте её, чтобы избежать ошибок при загрузке файлов на ваш сайт WordPress!