wp_max_upload_size() │ WP 2.5.0

Получает максимальный размер файла (в байтах), который разрешен к загрузке в WordPress.

По умолчанию максимальный размер берется из настроек PHP. Обычно эти настройки находятся в файле php.ini.

Функциюя возьмет минимальное значение одной из опций: upload_max_filesize или post_max_size. Например, при следующих значениях опций вес файла при загрузке не должен превышать 10 MB:

[PHP]
upload_max_filesize = 10M
post_max_size = 100M

Если размер файла превышает максимально-допустимый размер, то мы получим такую ошибку при попытке загрузить файл:

ВНИМАНИЕ: в nginx есть аналогичная post_max_size опция client_max_body_size, которая может быть определена для контекста http, server.

Если в ней установлено какое-то значение и оно меньше чем значение post_max_size в PHP. То nginx не пропустит запрос и до работы PHP дело даже не дойдет.

Поэтому, если у вас что-то не работает. Проверьте, установлена ли эта опция в nginx. Укажите в этой опции ноль: client_max_body_size 0;, чтобы отключить проверку размера тела запроса, и тогда актуальными останутся только настройки PHP.

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

add_filter( 'upload_size_limit', 'upload_size_limit_filter' );

Таким образом для мультисайта, мы можем ограничить максимальный размер загружаемого файла из админ-панели (эти данные хранятся в опции get_site_option( 'fileupload_maxk' ):

Работает на основе: wp_convert_hr_to_bytes()

1 раз — 0.0000138 сек (очень быстро) | 50000 раз — 0.05 сек (скорость света)

Хуки из функции

upload_size_limit

Возвращает

int. Максимально допустимый размер файла для загрузки в Байтах.

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

wp_max_upload_size();

Примеры

#1 Ограничение размера файла для своей формы

Допустим у нас есть такая форма, где мы добавили максимально разрешенный размер файла в атрибут data-maxfsize:

<form>
  <input id="file-input" type="file" data-maxfsize="<?= (int) wp_max_upload_size() ?>" />
  <p id="file-result"></p>
  <input id="file-submit" type="submit" disabled />
</form>

Теперь, мы можешь использовать такой JS скрипт, чтобы проверить файл на его размер:

const fileInput = document.getElementById('file-input')
const fileResult = document.getElementById('file-result')
const fileSubmit = document.getElementById('file-submit')

const maxFileSize = parseInt( fileInput.dataset['maxfsize'] )

fileInput.addEventListener( 'change', function(){  

	if( fileInput.files.length > 0 ){
		const fileSize = fileInput.files.item(0).size

		if( maxFileSize >= fileSize ){
			fileSubmit.disabled = false
		}
		else{
			fileResult.innerHTML = `Please select a file less than ${ Math.floor( maxFileSize / (1024 * 1024) ) } MB.`
		}
	}

} );

#2 Ограничим максимальный размер файла который можно загрузить

Допустим, наш сервер позволяет загружать файлы размером 300 MB. Нам это нужно для других скриптов, но в WordPress мы хотим чтобы менеджеры не могли загружать файлы больше 10 MB.

Чтобы этого добиться, мы можем использовать фильтр upload_size_limit:

add_filter( 'upload_size_limit', static fn() => MB_IN_BYTES * 10 );

#3 Что возвращает фукнция

var_dump( wp_max_upload_size() ); //> int(10485760)

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

С версии 2.5.0

Введена.

Код `wp_max_upload_size() wp max upload size` ^{WP 6.3.1}

wp-includes/media.php

function wp_max_upload_size() {
	$u_bytes = wp_convert_hr_to_bytes( ini_get( 'upload_max_filesize' ) );
	$p_bytes = wp_convert_hr_to_bytes( ini_get( 'post_max_size' ) );

	/**
	 * Filters the maximum upload size allowed in php.ini.
	 *
	 * @since 2.5.0
	 *
	 * @param int $size    Max upload size limit in bytes.
	 * @param int $u_bytes Maximum upload filesize in bytes.
	 * @param int $p_bytes Maximum size of POST data in bytes.
	 */
	return apply_filters( 'upload_size_limit', min( $u_bytes, $p_bytes ), $u_bytes, $p_bytes );
}