Где лежит php.ini и как изменить настройки PHP
Команда php --ini показывает, где лежит php.ini для терминала. Для сайта откройте защищенную страницу с phpinfo() через браузер и найдите строку Loaded Configuration File. Эти пути могут различаться: командная строка и веб-сервер запускают разные обработчики PHP. После правки перезапустите нужный сервис и проверьте значение именно через сайт.
- Где находится загруженный php.ini
- Где лежит php.ini в Ubuntu и Debian
- Где находится php.ini в Windows и macOS
- php.ini в Docker и на виртуальном хостинге
- Как изменить параметр и применить изменения
- Функция ini_set() в PHP и другие способы переопределить настройки
- Ключевые директивы php.ini
- Директивы, которых больше нет в PHP 7 и 8
- Ошибки при правке php.ini
Где находится загруженный php.ini
PHP читает конфигурацию при запуске своего обработчика. Поэтому сначала определите, какой процесс выполняет ваш код.
Найдите конфигурацию командной строки
Откройте терминал на сервере и выполните команду:
php --iniВ выводе найдите следующие строки:
Configuration File (php.ini) Path– каталог поиска основного файла.Loaded Configuration File– основной файл, который PHP действительно загрузил.Scan for additional .ini files in– каталог дополнительных конфигураций.Additional .ini files parsed– список прочитанных дополнительных файлов.
Если Loaded Configuration File содержит (none), основной файл не загружен. PHP при этом работает со встроенными значениями и дополнительными настройками.
В Linux и macOS путь можно вывести отдельной строкой:
php -i | grep "Loaded Configuration"Команда php -v покажет версию выбранного интерпретатора.
Если установлено несколько версий, команда php обращается только к одной.
Узнайте путь для сайта через phpinfo()
Вывод phpinfo() раскрывает пути, версии компонентов и настройки окружения. Подготовьте защиту до размещения диагностического файла на сервере.
Для временной страницы используйте отдельный случайный пароль и HTTPS.
- Сгенерируйте пароль локально командой
php -r "echo bin2hex(random_bytes(24)), PHP_EOL;". Сохраните полученную строку для входа. - Создайте на своем компьютере файл
php-config-check.phpс кодом из примера. - Вставьте сгенерированную строку между кавычками в
$password = '';. Не используйте пароль администратора сайта. - Загрузите готовый файл в каталог сайта. Откройте его через HTTPS по адресу своего домена с окончанием
/php-config-check.php. - Введите пароль в форму. После отправки появится таблица конфигурации PHP.
<?php
header('Cache-Control: no-store');
// Вставьте случайный пароль до загрузки файла на сервер.
$password = '';
if ($password === '') {
http_response_code(503);
exit('Сначала задайте пароль в файле');
}
$provided = $_POST['password'] ?? '';
if (!is_string($provided) || !hash_equals($password, $provided)) {
header('Content-Type: text/html; charset=utf-8');
echo '<form method="post">';
echo '<label>Пароль: <input type="password" name="password"></label>';
echo '<button type="submit">Открыть диагностику</button>';
echo '</form>';
exit;
}
phpinfo(INFO_GENERAL | INFO_CONFIGURATION);Откройте страницу в приватном окне без ввода пароля. Она должна показывать только форму, без таблицы PHP. Неверный пароль также оставляет посетителя на форме.
Пустой пароль в файле блокирует вывод диагностики.
После входа найдите Loaded Configuration File и Server API. Строка Scan this dir for additional .ini files покажет каталог дополнительных настроек. Подробный разбор вывода есть в статье об изменении конфигурации через php.ini и phpinfo().
После диагностики удалите файл с сервера.
Отличайте CLI от PHP-FPM и модуля Apache
SAPI – интерфейс, через который окружение запускает PHP. От него зависят загрузка конфигурации и доступные способы переопределения параметров.
| Обработчик | Как выполняется код | Как проверить конфигурацию |
|---|---|---|
CLI, значение cli | Команда в терминале, задача планировщика | php --ini |
PHP-FPM, значение fpm-fcgi | Отдельные процессы принимают запросы от веб-сервера | phpinfo() через браузер |
Модуль Apache, значение apache2handler | Apache выполняет PHP внутри своих процессов | phpinfo() через браузер |
Apache также может передавать запросы в PHP-FPM.
Само название веб-сервера еще не определяет используемый конфиг.
Дополнительные файлы обычно находятся в каталоге conf.d. PHP читает их после основного php.ini, в алфавитном порядке. Поздняя запись может переопределить значение из основного файла.
Где лежит php.ini в Ubuntu и Debian
В пакетной установке Ubuntu и Debian конфиги разделены по версиям и SAPI. На одном сервере могут одновременно работать несколько наборов настроек.
| Задача | Обычный путь пакетной установки |
|---|---|
| Командная строка | /etc/php/<версия>/cli/php.ini |
| Сайт через PHP-FPM | /etc/php/<версия>/fpm/php.ini |
| Сайт через модуль Apache | /etc/php/<версия>/apache2/php.ini |
| Дополнительные настройки | /etc/php/<версия>/<SAPI>/conf.d/ |
Часть <версия> обозначает номер ветки установленного PHP. Возьмите его из вывода сайта, если настраиваете веб-приложение. Версия CLI может с ней не совпадать.
Чтобы найти существующие файлы и сервисы FPM, выполните:
find /etc/php -name php.ini -print
systemctl list-unit-files 'php*-fpm.service'Первая команда перечислит найденные конфиги, вторая – службы FPM.
Сопоставьте путь из браузера с установленными службами.
Каталог conf.d часто содержит ссылки на настройки расширений. Не удаляйте их ради изменения одного лимита. Отредактируйте нужную директиву и проверьте итоговое значение через сайт.
Где находится php.ini в Windows и macOS
Расположение php.ini зависит от способа установки PHP. Команда php --ini надежнее поиска файла по всему диску.
Windows с отдельной установкой PHP
В архиве PHP для Windows находятся шаблоны php.ini-development и php.ini-production.
- Откройте каталог, куда вы распаковали PHP, например
C:\php. - Скопируйте
php.ini-productionв файлphp.iniэтого каталога. Для локальной разработки можно взять шаблонphp.ini-development. - Выполните
C:\php\php.exe --iniв командной строке. ВLoaded Configuration Fileдолжен появиться созданный файл.
Включите показ расширений файлов в Проводнике. Иначе редактор может сохранить конфиг под именем php.ini.txt.
Веб-сервер способен задавать собственный каталог конфигурации.
Поэтому путь для сайта дополнительно проверьте через защищенную страницу phpinfo() в браузере.
XAMPP
При стандартной установке XAMPP в Windows файл находится по адресу C:\xampp\php\php.ini. Если вы выбрали другой каталог установки, начало пути изменится.
После сохранения остановите и снова запустите Apache в панели XAMPP. Затем обновите диагностическую страницу сайта и проверьте измененную директиву.
macOS с Homebrew
Homebrew размещает конфигурацию внутри собственного префикса установки. Путь зависит также от установленной ветки PHP.
command -v php
php -v
php --ini
brew services listПервая команда покажет выбранный исполняемый файл. Последняя перечислит сервисы Homebrew. Для службы с именем php примените brew services restart php. Для версионной формулы подставьте ее имя из списка.
Если сайт обслуживает другой PHP, ориентируйтесь на его phpinfo().
php.ini в Docker и на виртуальном хостинге
Контейнеры и виртуальный хостинг тоже используют конфигурацию PHP. Однако способ сохранения изменений у них отличается от обычного сервера.
Официальный образ PHP в Docker
В официальном образе PHP каталог конфигурации – /usr/local/etc/php/. Шаблоны лежат там же, но активный php.ini изначально отсутствует. Дополнительные настройки PHP читает из /usr/local/etc/php/conf.d/. Исходники образа доступны в официальном репозитории docker-library/php.
Добавьте создание основного конфига в Dockerfile вашего приложения:
FROM php:fpm
RUN cp "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini"
COPY uploads.ini /usr/local/etc/php/conf.d/zz-uploads.iniСоздайте рядом файл uploads.ini с настройками загрузки:
file_uploads = On
upload_max_filesize = 64M
post_max_size = 80MДля проекта с сервисом Compose по имени php выполните:
docker compose up -d --build php
docker compose exec php php --ini
docker compose exec php php -vВ списке прочитанных файлов должен появиться zz-uploads.ini. Подставьте вместо php имя своего сервиса из compose.yaml. Значение для веб-запроса проверьте через защищенный диагностический скрипт сайта.
Тег php:fpm выбирает образ без фиксации номера ветки. Для воспроизводимого развертывания закрепляйте протестированный тег или digest.
Правка внутри работающего контейнера потеряется после его пересоздания.
Виртуальный хостинг
На виртуальном хостинге главный php.ini обычно недоступен пользователю. Панель может разрешать изменение отдельных параметров для выбранного сайта.
Откройте настройки PHP нужного домена и найдите поля upload_max_filesize и post_max_size. Для файла до 64 МБ задайте соответственно 64M и 80M. Если таких полей нет, попробуйте .user.ini при CGI/FastCGI.
Результат проверьте через ini_get() в браузере.
Если значение осталось прежним, причиной может быть административный запрет переопределения. Параметры, закрепленные через php_admin_value, пользовательский скрипт изменить не сможет.
Как изменить параметр и применить изменения
Сохранение php.ini не обновляет настройки уже запущенных процессов. CLI перечитывает файл при следующем запуске команды. PHP-FPM и модуль Apache требуют перезапуска соответствующего сервиса.
Подготовьте рабочую конфигурацию
Перед изменением сохраните копию загруженного файла:
- Определите загруженный файл через браузер, если меняете настройки сайта.
- Скопируйте файл в резервную копию, например
php.ini.bak. - Откройте оригинал в текстовом редакторе с правами записи.
- Найдите нужную директиву и замените ее значение. Не создавайте вторую активную строку с тем же параметром.
- Сохраните файл в текстовом формате под исходным именем.
Точка с запятой ; начинает комментарий. Закомментированная директива не устанавливает значение. Логические переключатели удобно записывать как On и Off.
Лимиты памяти и размера тела запроса принимают суффиксы M и G. Запись 64M означает 64 × 1024 × 1024 байта. Не добавляйте к числу пробел и буквы «МБ».
Для сайта с загрузкой одного файла до 64 МБ подойдет такой фрагмент:
; Размер одного загружаемого файла
file_uploads = On
upload_max_filesize = 64M
; Все тело POST, включая остальные поля формы
post_max_size = 80M
; Пример лимитов: подберите под приложение
memory_limit = 256M
max_execution_time = 30
; Ошибки записываются в журнал, но скрыты от посетителя
error_reporting = E_ALL
display_errors = Off
display_startup_errors = Off
log_errors = On
error_log = "/var/log/php/site-error.log"
date.timezone = "UTC"
short_open_tag = OffПуть журнала в примере предназначен для Linux. Заранее создайте каталог вне публичной папки сайта. Разрешите запись пользователю процессов PHP, сохранив ограниченный доступ остальных пользователей. Для Windows задайте существующий путь, например C:/logs/php/site-error.log.
Лимит post_max_size относится ко всему запросу.
Несколько файлов по 64 МБ потребуют большего общего лимита. Веб-сервер, прокси и приложение также могут ограничивать размер загрузки.
Перезапустите обработчик PHP
В Ubuntu и Debian найдите точное имя FPM-службы:
systemctl list-unit-files 'php*-fpm.service'Возьмите службу той версии, которую показывает сайт. Подставьте ее имя вместо ИМЯ_СЛУЖБЫ:
sudo systemctl restart ИМЯ_СЛУЖБЫ
systemctl status ИМЯ_СЛУЖБЫ --no-pagerДля пакетной установки имя имеет вид php<версия>-fpm. После успешного запуска статус содержит active (running).
Если сайт использует модуль Apache, перезапустите Apache:
sudo systemctl restart apache2
systemctl status apache2 --no-pagerПерезапуск Apache не обновляет конфигурацию отдельного PHP-FPM.
Перезапуск Nginx тоже не заставляет FPM перечитать php.ini.
Проверьте значения и запись ошибок
Используйте файл php-config-check.php с проверкой пароля из примера с phpinfo(). Подготовьте его локально, сохранив весь код защиты. Замените только последнюю строку phpinfo(INFO_GENERAL | INFO_CONFIGURATION); следующим фрагментом:
header('Content-Type: text/plain; charset=utf-8');
echo 'SAPI: ', PHP_SAPI, PHP_EOL;
echo 'PHP: ', PHP_VERSION, PHP_EOL;
echo 'php.ini: ', php_ini_loaded_file() ?: '(none)', PHP_EOL;
echo 'Additional ini: ', php_ini_scanned_files() ?: '(none)', PHP_EOL;
foreach (['upload_max_filesize', 'post_max_size', 'display_errors',
'log_errors', 'error_log'] as $name) {
echo $name, ' = ', ini_get($name), PHP_EOL;
}
error_log('PHP configuration check');Загрузите защищенный файл на сайт и откройте его через HTTPS. Убедитесь в приватном окне, что без пароля видна только форма. Затем войдите с заданным паролем и прочитайте значения.
Для примера ожидаются 64M и 80M у лимитов загрузки. Выключенный логический параметр ini_get() может показать пустой строкой или нулем.
В настроенном журнале должна появиться запись PHP configuration check. Если записи нет, проверьте путь и права пользователя PHP.
После проверки удалите диагностический файл с сервера.
Для отката восстановите резервную копию php.ini и перезапустите тот же сервис. Если перезапуск завершился ошибкой, посмотрите сообщения через journalctl -u ИМЯ_СЛУЖБЫ -n 50 --no-pager.
Функция ini_set() в PHP и другие способы переопределить настройки
Главный php.ini задает исходную конфигурацию обработчика. Отдельные параметры можно переопределять для запроса или каталога. Возможность изменения зависит от режима конкретной директивы.
ini_set() и ini_get() в PHP
Функция ini_set() в PHP меняет разрешенный параметр на время выполнения скрипта. После завершения запроса изменение исчезает.
<?php
header('Content-Type: text/plain; charset=utf-8');
$before = ini_get('memory_limit');
$previous = ini_set('memory_limit', '256M');
if ($previous === false) {
echo 'Изменить memory_limit не удалось', PHP_EOL;
} else {
echo 'До: ', $before, PHP_EOL;
echo 'После: ', ini_get('memory_limit'), PHP_EOL;
ini_restore('memory_limit');
}ini_set() возвращает прежнее значение или false при неудаче. Используйте строгое сравнение === false: прежнее значение тоже бывает пустой строкой.
upload_max_filesize нельзя увеличить таким вызовом.
PHP разбирает загрузку до запуска пользовательского скрипта. Кроме того, директива имеет режим PHP_INI_PERDIR, запрещающий изменение через ini_set().
.user.ini для CGI и FastCGI
Файл .user.ini задает настройки для каталога при CGI/FastCGI, включая PHP-FPM. CLI и модуль Apache его не обрабатывают.
- Создайте файл
.user.iniв публичном корне сайта. - Запишите в него разрешенные параметры в обычном INI-синтаксисе.
upload_max_filesize = 64M
post_max_size = 80M
display_errors = Off
log_errors = OnPHP ищет такие файлы от каталога запрошенного скрипта до корня документов сайта. Настройка user_ini.filename задает имя файла; пустое значение отключает механизм.
Директива user_ini.cache_ttl определяет интервал перечитывания в секундах. Выведите ее через ini_get('user_ini.cache_ttl') и дождитесь этого интервала. Затем повторите запрос к защищенному диагностическому скрипту в том же каталоге.
Чтобы отменить изменение, удалите соответствующие строки из .user.ini. Учитывайте тот же интервал кеширования. Закройте веб-доступ к этому файлу средствами сервера.
php_value и php_flag в .htaccess
Директивы php_value и php_flag работают с модулем PHP для Apache. Проверьте Server API: нужен Apache 2.0 Handler.
При PHP-FPM эти строки могут вызвать ошибку HTTP 500.
Сохраните копию .htaccess перед изменением.
php_value upload_max_filesize 64M
php_value post_max_size 80M
php_flag display_errors Off
php_flag log_errors OnДобавьте строки в .htaccess каталога сайта и повторите веб-запрос. Apache должен разрешать такие переопределения своей настройкой AllowOverride. Если сайт вернул HTTP 500, восстановите копию файла. Для FPM используйте .user.ini или основной конфиг.
Какие директивы можно менять где
Режимы перечислены в документации по изменяемости настроек. Режим каждой директивы указан в списке параметров php.ini.
| Режим | Где разрешено менять | Пример |
|---|---|---|
PHP_INI_ALL | php.ini, разрешенные настройки сервера и каталога, ini_set() | memory_limit, display_errors |
PHP_INI_PERDIR | php.ini, конфигурация сервера, .user.ini, разрешенный .htaccess при mod_php | upload_max_filesize, post_max_size |
PHP_INI_SYSTEM | php.ini и допустимые административные настройки сервера; пользовательские файлы и ini_set() не подходят | file_uploads |
PHP_INI_USER | Пользовательский уровень, включая ini_set() и .user.ini при CGI/FastCGI, а также php.ini | Режим для директив с разрешенным пользовательским изменением |
Режим не отменяет специальных ограничений самой директивы. Например, open_basedir при выполнении можно только ужесточить. Административные настройки FPM также могут блокировать пользовательские переопределения.
Ключевые директивы php.ini
Значение по умолчанию и настройка установленного сервера могут различаться. Шаблоны production, пакеты ОС и дополнительные файлы задают собственные значения. В таблице указаны базовые значения PHP; исключения отмечены отдельно.
| Директива | За что отвечает | Значение по умолчанию | Рекомендация для production | Режим изменения |
|---|---|---|---|---|
memory_limit | Память, выделяемая скрипту | 128M | Задайте конечный лимит под приложение; учитывайте число процессов | ALL |
max_execution_time | Ограничение времени выполнения скрипта | 30 секунд; для CLI – 0 | Ограничьте веб-запросы; длительные задачи перенесите в фон | ALL |
max_input_time | Время разбора входных данных | -1: используется max_execution_time | Подберите под обработку ожидаемых запросов | PERDIR |
upload_max_filesize | Размер одного загружаемого файла | 2M | 64M для сценария из примера | PERDIR |
post_max_size | Размер всего тела POST | 8M | 80M для одного файла до 64 МБ | PERDIR |
file_uploads | Прием файлов через HTTP | On | Включайте, только если приложение принимает файлы | SYSTEM |
display_errors | Показ ошибок в ответе пользователю | On | Off | ALL |
log_errors | Запись ошибок в журнал | Off | On | ALL |
error_log | Назначение журнала ошибок | Не задан; используется журнал обработчика | Доступный для записи путь вне публичного каталога | ALL |
error_reporting | Уровни регистрируемых ошибок | E_ALL в PHP 8 | E_ALL вместе с выключенным display_errors | ALL |
date.timezone | Часовой пояс функций даты | UTC | Явно задайте пояс приложения | ALL |
short_open_tag | Обработка короткого тега <? | On; зависит от сборки, шаблоны могут отключать | Off; используйте <?php. Тег <?= работает независимо | PERDIR |
disable_functions | Запрет перечисленных внутренних функций | Пустой список | Отключайте только функции, которые приложение не использует | SYSTEM; задавайте в php.ini |
open_basedir | Ограничение доступных PHP путей файловой системы | Ограничение не задано | Учитывайте временные файлы, сессии и зависимости; не заменяет изоляцию ОС | ALL; при выполнении только ужесточение |
session.save_handler | Способ хранения сессий | files | Выберите хранилище под архитектуру приложения | ALL; меняйте до запуска сессии |
session.save_path | Путь или параметры хранилища сессий | Пустая строка; файловый обработчик использует системный временный каталог | Для files задайте закрытый каталог с правом записи PHP | ALL; меняйте до запуска сессии |
opcache.enable | Кеширование скомпилированного PHP-кода | 1 при подключенном OPcache | Включите для веб-приложения | ALL; через ini_set() можно отключить, но нельзя включить |
opcache.memory_consumption | Общая память кеша OPcache, в мегабайтах | 128 при подключенном OPcache | Подберите по заполнению кеша и числу скриптов | SYSTEM |
Обозначения ALL, PERDIR и SYSTEM соответствуют константам PHP_INI_*.
Наличие строк OPcache в файле само по себе не подключает расширение.
Не увеличивайте memory_limit без учета доступной памяти сервера. Несколько параллельных процессов расходуют память одновременно. А max_execution_time не заменяет тайм-ауты веб-сервера и FPM.
Директивы, которых больше нет в PHP 7 и 8
Если переносите старый конфиг, удалите строки следующих групп. Современный PHP не возвращает прежнее поведение при их включении.
safe_mode*– механизм удален в PHP 5.4. Ограничивайте права пользователем ОС, отдельными пулами FPM и изоляцией процессов.register_globals– удалена в PHP 5.4. Читайте входные данные явно через$_GET,$_POST,$_COOKIEи другие суперглобальные массивы.magic_quotes_*– механизм удален в PHP 5.4. Для SQL используйте подготовленные запросы PDO или mysqli. Для вывода в HTML применяйте контекстное экранирование, напримерhtmlspecialchars().mysql.*– настройки старого расширения ext/mysql, удаленного в PHP 7.0. Переведите подключение на PDO MySQL или mysqli.
Не заменяйте подготовленные запросы вызовом addslashes(). Эта функция не обеспечивает корректную защиту SQL-запросов.
Ошибки при правке php.ini
Если значение не изменилось, проверьте источник настройки и обработчик запроса. Повторное редактирование случайного php.ini только усложнит диагностику.
| Симптом | Причина | Что сделать |
|---|---|---|
| Терминал показывает новый лимит, сайт – старый | Изменен конфиг CLI | Получите Loaded Configuration File через браузер и измените конфиг сайта |
| Файл сохранен, но значение осталось прежним | Рабочие процессы не перечитали настройки | Перезапустите FPM или Apache в зависимости от SAPI |
| Основной конфиг содержит нужное значение, сайт показывает другое | Параметр переопределен в дополнительном файле, пуле FPM или каталоге | Сравните Local Value и Master Value в phpinfo(), изучите список дополнительных файлов |
| Крупная форма приходит без файлов и полей | Размер POST превысил post_max_size | Поднимите общий лимит выше размера файла с учетом остальных полей |
ini_set() возвращает false | Директива запрещает изменение во время выполнения либо закреплена администратором | Проверьте режим; измените php.ini, разрешенный файл каталога или административную настройку |
| Посетитель видит пути и трассировку ошибки | Включен display_errors | Выключите вывод, включите журнал и проверьте запись тестового сообщения |
После правки .htaccess сайт возвращает HTTP 500 | Нет mod_php или запрещены соответствующие переопределения | Восстановите файл; при FPM используйте .user.ini |
Для одной операции внутри скрипта подойдет разрешенный вызов ini_set(). Для каталога при FPM используйте .user.ini. Общие лимиты и системные параметры задавайте в загруженном php.ini или административной конфигурации.
Сохраняйте рядом с резервной копией путь конфига и имя сервиса. Эти две записи помогут откатить именно настройки сайта, не затронув другой обработчик.
Популярное за неделю
- Как создать сайт самому в 2026: 4 способа + пошаговая инструкция 34 мин чтения
- Лучшие конструкторы сайтов для самостоятельного запуска 23 мин чтения
- Как сделать переход на другую страницу в PHP 5 мин чтения
- Как создать календарь на AJAX и PHP 5 мин чтения
- Создание форм регистрации и авторизации на PHP 7 мин чтения
- База данных картинка: загрузка на сервер или в MySQL через PHP 12 мин чтения
Комментарии