size_format() WP 2.3.0

Конвертирует байты в понятный для человека формат: 500 B, 63 KB, 9 MB, 2 GB, 1 TB.

Форматирует размер файла в понятный формат.

Все размеры файлов в PHP хранятся в байтах и получаются в них с помощью filesize() или как-то еще. Но гораздо удобнее читать 1 KB чем 1024 B. size_format() получает количество байтов и изменяет их на количество килобайтов (KB), мегабайтов (MB), гигабайтов (GB) или терабайтов (TB).

Также, нужно помнить, что максимальное число на 32-разрядных системах ограничено и равно 2147483647, тогда как на 64-разрядной системе оно равно 9223372036854775807. Поэтому, когда нужно указать число большее чем PHP может нормально понять, используйте строку - указывайте число в виде строки.

Хуков нет.

Возвращает

Строку|false. Строку или false, если не удалось сконвертировать.

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

size_format( $bytes, $decimals );

$bytes(число/строка) (обязательный)

Число байт, которые нужно сконвертировать. Имейте ввиду что в PHP есть максимальный допустимый размер для чисел и он мал в 32 разрядных системах.

$decimals(число)

Число цифр после запятой.
По умолчанию: 0

Примеры

#1 Демонстрация конвертации байтов

echo size_format( 99 );            //> 99 B
echo size_format( 9999 );          //> 10 KB
echo size_format( '9999' );        //> 10 KB
echo size_format( 9999, 2 );       //> 9,76 KB
echo size_format( 9999999 );       //> 10 MB
echo size_format( 9999999999 );    //> 9 GB
echo size_format( 9999999999999 ); //> 9 TB

Список изменений

Код size_format() size format ^{WP 5.7.2}

<?php
function size_format( $bytes, $decimals = 0 ) {
	$quant = array(
		/* translators: Unit symbol for terabyte. */
		_x( 'TB', 'unit symbol' ) => TB_IN_BYTES,
		/* translators: Unit symbol for gigabyte. */
		_x( 'GB', 'unit symbol' ) => GB_IN_BYTES,
		/* translators: Unit symbol for megabyte. */
		_x( 'MB', 'unit symbol' ) => MB_IN_BYTES,
		/* translators: Unit symbol for kilobyte. */
		_x( 'KB', 'unit symbol' ) => KB_IN_BYTES,
		/* translators: Unit symbol for byte. */
		_x( 'B', 'unit symbol' )  => 1,
	);

	if ( 0 === $bytes ) {
		/* translators: Unit symbol for byte. */
		return number_format_i18n( 0, $decimals ) . ' ' . _x( 'B', 'unit symbol' );
	}

	foreach ( $quant as $unit => $mag ) {
		if ( (float) $bytes >= $mag ) {
			return number_format_i18n( $bytes / $mag, $decimals ) . ' ' . $unit;
		}
	}

	return false;
}

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

Из метки: Данные файлов (files data get info)

Еще из метки: upload download (файловая система file загрузка)

Еще из раздела: Форматирование