Изменение параметров PHP: руководство администратора

Расширенные примеры изменения настроек PHP

Пример 1: .user.ini с принудительным обновлением кэша

<?php
echo 'Текущий memory_limit: ' . ini_get('memory_limit') . "\n";
touch('/var/www/example/.user.ini');
?>

Текущий memory_limit: 512M

Функция touch() изменяет метку времени файла .user.ini, заставляя PHP перечитать его при следующем запросе.

Пример 2: ini_set с проверкой и обработкой ошибок

<?php
$directive = 'upload_max_filesize';
$newValue = '50M';
if (ini_set($directive, $newValue) === false) {
    echo 'Не удалось установить ' . $directive . '. Возможно, директива запрещена.';
} else {
    echo 'Успешно установлено: ' . $directive . ' = ' . ini_get($directive);
}
?>

Успешно установлено: upload_max_filesize = 50M

Пример 3: Конфигурация пула PHP-FPM с административными директивами

; /etc/php/8.1/fpm/pool.d/example.conf
[example]
user = www-data
group = www-data
listen = /var/run/php/php8.1-fpm-example.sock
pm = dynamic
pm.max_children = 10
pm.start_servers = 2
pm.min_spare_servers = 1
pm.max_spare_servers = 3
php_admin_value[memory_limit] = 512M
php_admin_value[max_execution_time] = 60
php_admin_flag[display_errors] = off

После редактирования этого файла нужно выполнить sudo systemctl restart php8.1-fpm. Директивы с префиксом php_admin_value не могут быть переопределены через ini_set() в скриптах.

Пример 4: .htaccess с использованием php_value и php_flag

# .htaccess (работает только php_value и php_flag)
php_value memory_limit 256M
php_flag display_errors off

В .htaccess запрещено использовать php_admin_value; это можно делать только в конфигурации виртуального хоста или в основном конфигурационном файле Apache.

Пример 5: Настройка через Nginx с fastcgi_param и PHP_ADMIN_VALUE

server {
    listen 80;
    server_name example.com;
    root /var/www/example;

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
        fastcgi_param PHP_VALUE "max_execution_time=90";
        fastcgi_param PHP_ADMIN_VALUE "memory_limit=128M";
    }
}

Переменная PHP_ADMIN_VALUE эквивалентна php_admin_value и имеет более высокий приоритет, чем PHP_VALUE. После перезагрузки Nginx (sudo nginx -s reload) параметры будут применены.

Пример 6: Использование опции -d в командной строке PHP

php -d memory_limit=512M -d max_execution_time=0 script.php

Этот способ полезен при запуске скриптов из командной строки с временными настройками, не затрагивающими глобальную конфигурацию.

Пример 7: Просмотр информации о директивах с помощью ini_get_all

<?php
$settings = ini_get_all();
foreach (['memory_limit', 'allow_url_fopen', 'display_errors'] as $dir) {
    echo $dir . ': value=' . $settings[$dir]['global_value'] . ', access=' . $settings[$dir]['access'] . "\n";
}
?>

memory_limit: value=128M, access=7
allow_url_fopen: value=1, access=4
display_errors: value=1, access=7

Значение access позволяет определить, где можно изменять директиву: 7 - PHP_INI_ALL, 4 - PHP_INI_SYSTEM, 1 - PHP_INI_USER.

Пример 8: Использование переменной окружения PHPRC для загрузки альтернативного php.ini

export PHPRC=/home/user/custom.ini
php script.php

Таким образом можно запустить один скрипт с совершенно другим набором настроек, не изменяя системный php.ini.