WP_CONVERT_HR_TO_BYTES() в WordPress: преобразование короткого значения байтов

## WP_CONVERT_HR_TO_BYTES() │ WP 2.3.0

Функция WP_CONVERT_HR_TO_BYTES() преобразует короткое значение байтов в целочисленное значение байтов. 

### Используется в:

Эта функция используется в функции wp_max_upload_size().

### Особенности:

- **Возвращаемое значение**: Целое число, представляющее количество байтов.
- **Хуки**: Не имеет хуков.

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

Функция возвращает целое число, которое соответствует значению в байтах.

### Пример использования

Функция принимает строку, которая представляет значение в байтах (может быть сокращенной или обычной):

```php
wp_convert_hr_to_bytes( $value );

• $value (строка): обязательный параметр, значение в байтах (может быть в сокращенном формате, например "1Mb" или в обычном).

Примеры

Вот несколько примеров, как работает эта функция:

wp_convert_hr_to_bytes('1Mb');       // Возвращает: 1048576
wp_convert_hr_to_bytes('1mb');       // Возвращает: 1048576
wp_convert_hr_to_bytes('1mB');       // Возвращает: 1048576
wp_convert_hr_to_bytes('1 Mb');      // Возвращает: 1048576
wp_convert_hr_to_bytes('1,9 Mb');    // Возвращает: 1048576
wp_convert_hr_to_bytes('1.9 Mb');    // Возвращает: 1048576
wp_convert_hr_to_bytes('15 Mb');     // Возвращает: 15728640

Изменения в версии

• С 2.3.0: функция была введена.
• С 4.6.0: была перемещена из media.php в load.php.

Код функции

Вот код самой функции:

function wp_convert_hr_to_bytes( $value ) {
$value = strtolower( trim( $value ) );
$bytes = (int) $value;

if ( str_contains( $value, 'g' ) ) {
    $bytes *= GB_IN_BYTES;
} elseif ( str_contains( $value, 'm' ) ) {
    $bytes *= MB_IN_BYTES;
} elseif ( str_contains( $value, 'k' ) ) {
    $bytes *= KB_IN_BYTES;
}

// Учитываем большие значения (числа с плавающей запятой), которые превышают максимальный размер целого числа.
return min( $bytes, PHP_INT_MAX );

}

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

Существуют и другие функции, которые могут быть полезны в связке с wp_convert_hr_to_bytes():

• Работа с файлами:

  • file_is_displayable_image()
  • get_file_data()
  • get_plugin_data()
  • size_format()
  • wp_read_image_metadata()

• Загрузка и скачивание:

  • download_url()
  • media_handle_sideload()
  • media_handle_upload()
  • media_sideload_image()
  • wp_check_filetype()
  • wp_get_upload_dir() и другие.

• Форматирование:

  • absint()
  • add_magic_quotes()
  • balanceTags()
  • strip_fragment_from_url() и другие.

Эти функции помогут вам лучше управлять файлами и работой с загрузками в WordPress.