Параметр upload_max_filesize в PHP определяет максимальный размер файла, который пользователь может загрузить на сервер через веб-форму. При загрузке больших файлов нередко возникает ошибка, связанная с превышением установленного лимита. Для корректной работы сайтов, интернет-магазинов, CMS и веб-приложений часто требуется увеличить это значение.
Что такое upload_max_filesize
Параметр upload_max_filesize является директивой конфигурации PHP, которая ограничивает размер загружаемых файлов.
Например:
- upload_max_filesize = 2M — максимальный размер 2 МБ.
- upload_max_filesize = 64M — максимальный размер 64 МБ.
- upload_max_filesize = 256M — максимальный размер 256 МБ.
Если размер файла превышает установленное значение, загрузка будет отклонена сервером.
Проверка текущего лимита
Перед изменением настроек рекомендуется узнать текущее значение параметра.
Для этого можно создать файл phpinfo.php со следующим содержимым:
<?php phpinfo(); ?>
После открытия файла в браузере необходимо найти строку upload_max_filesize.
Изменение через php.ini
Самый распространенный способ увеличить размер загрузки файлов — изменить настройки в файле php.ini.
Найдите следующие параметры:
upload_max_filesize = 2M post_max_size = 8M
Измените значения на необходимые:
upload_max_filesize = 128M post_max_size = 128M
После сохранения изменений потребуется перезапустить веб-сервер.
Настройка post_max_size
Параметр post_max_size должен быть не меньше upload_max_filesize. Он определяет максимальный объем данных, отправляемых методом POST.
Например:
upload_max_filesize = 128M post_max_size = 128M
Если post_max_size меньше размера файла, загрузка также завершится ошибкой.
Изменение через .htaccess
На серверах Apache можно изменить настройки через файл .htaccess.
php_value upload_max_filesize 128M php_value post_max_size 128M php_value max_execution_time 300 php_value max_input_time 300
После сохранения файла изменения обычно вступают в силу автоматически.
Настройка через пользовательский php.ini
На некоторых виртуальных хостингах разрешается использовать локальный файл php.ini внутри сайта.
Добавьте в него следующие строки:
upload_max_filesize = 128M post_max_size = 128M memory_limit = 256M
После изменения настроек может потребоваться несколько минут для их применения.
Изменение через .user.ini
Многие современные хостинги поддерживают файл .user.ini.
upload_max_filesize = 128M post_max_size = 128M memory_limit = 256M
Этот способ часто используется на серверах с PHP-FPM.
Настройка через панель хостинга
Большинство хостинг-провайдеров позволяют изменять параметры PHP через панель управления.
Обычно необходимо:
- Войти в панель управления.
- Открыть раздел PHP.
- Перейти к настройкам интерпретатора.
- Изменить upload_max_filesize.
- Сохранить изменения.
Этот способ считается наиболее простым для начинающих пользователей.
Дополнительные параметры PHP
Для загрузки крупных файлов часто требуется изменить и другие настройки.
- memory_limit.
- max_execution_time.
- max_input_time.
- max_file_uploads.
- post_max_size.
Недостаточные значения этих параметров могут препятствовать загрузке больших файлов даже после увеличения upload_max_filesize.
Настройка для WordPress
В WordPress ошибка маленького лимита загрузки встречается достаточно часто при установке тем, плагинов и резервных копий.
После изменения настроек PHP рекомендуется проверить лимиты в разделе «Здоровье сайта» или на странице загрузки медиафайлов.
Распространенные ошибки
- Изменен только upload_max_filesize.
- Не увеличен параметр post_max_size.
- Сервер не был перезапущен.
- Настройки изменены не в том файле php.ini.
- Хостинг запрещает изменение параметров вручную.
Если изменения не применяются, следует уточнить способ настройки PHP у хостинг-провайдера.
Заключение
Увеличение upload_max_filesize в PHP позволяет загружать на сервер более крупные файлы и устранять ошибки при работе с сайтами и веб-приложениями. Чаще всего настройка выполняется через php.ini, .htaccess, .user.ini или панель управления хостингом. Для корректной работы важно также увеличить параметры post_max_size, memory_limit и время выполнения скриптов.
