Ini set: примеры (PHP)

Простые примеры использования

<?php
// Установка максимального времени выполнения скрипта в 120 секунд
$old_value = ini_set('max_execution_time', 120);
echo "Предыдущее значение max_execution_time: $old_value";
?>

Предыдущее значение max_execution_time: 30

<?php
// Включение отображения всех ошибок, кроме предупреждений (E_ALL & ~E_WARNING)
ini_set('error_reporting', E_ALL & ~E_WARNING);
// Перенаправление ошибок в лог-файл
ini_set('error_log', '/path/to/php_errors.log');
?>

(Скрипт выполняется, ошибки записываются в указанный файл)

<?php
// Включение буферизации вывода с размером буфера 4096 байт
ini_set('output_buffering', 4096);
?>

(Вывод скрипта начинает буферизоваться)

Похожие функции в PHP

В PHP существует ряд функций для работы с конфигурацией:

• ini_get($option) — получает текущее значение директивы. Используется для чтения настроек.
• ini_get_all([$extension]) — возвращает все доступные директивы конфигурации или для указанного модуля.
• ini_restore($option) — восстанавливает исходное значение директивы, заданное в php.ini. Полезна для отмены временных изменений.
• get_cfg_var($option) — получает значение опции из основного файла конфигурации PHP, игнорируя изменения через ini_set.

ini_set предпочтительнее для временного изменения настроек в runtime. ini_get — для чтения текущих значений. ini_restore — для сброса к исходному состоянию.

Аналоги в других языках

Ini set в Python

В Python нет прямой аналогии, так как настройки интерпретатора обычно задаются аргументами командной строки или переменными окружения. Однако для управления некоторыми аспектами выполнения можно использовать модуль sys или resource (на Unix).

import sys
import resource
# Аналог изменения memory_limit - установка мягкого лимита памяти (в байтах)
resource.setrlimit(resource.RLIMIT_DATA, (1073741824, 1073741824))  # 1 GB
print(sys.getrecursionlimit())  # Аналог получения значения
sys.setrecursionlimit(3000)     # Аналог установки max_execution_time (но для глубины рекурсии)

1000

В Node.js настройки интерпретатора V8 задаются флагами при запуске процесса. Динамически изменить большинство параметров невозможно.

// Задание максимального объема памяти для процесса (не во время выполнения)
// Запуск из командной строки: node --max-old-space-size=4096 script.js
// Внутри скрипта можно читать некоторые параметры через process
console.log(process.memoryUsage());

{ rss: 12345678, heapTotal: 5678901, heapUsed: 3456789, external: 1234 }

Ini set в MySQL

В MySQL для изменения переменных сессии используется оператор SET, что концептуально ближе к ini_set.

-- Установка переменной сессии (действует до конца соединения)
SET SESSION max_execution_time = 60000; -- миллисекунды
-- Просмотр значения
SELECT @@SESSION.max_execution_time;

60000

Типичные ошибки

Некоторые директивы (с пометкой PHP_INI_SYSTEM в документации) нельзя изменить через ini_set.

<?php
$result = ini_set('extension_dir', '/new/path');
var_dump($result); // Вернет false
?>

bool(false)

<?php
$result = ini_set('nonexistent.directive', 'value');
var_dump($result);
?>

bool(false)

Некоторые директивы ожидают строго определенный тип (например, булево значение).

<?php
// Директива log_errors ожидает булево значение 'On'/'Off' или числовое 1/0.
// Передача строки 'yes' может не сработать ожидаемым образом.
ini_set('log_errors', 'yes'); // Может интерпретироваться как false
?>

(Предупреждение может отсутствовать, но значение не установится)

Изменения в последних версиях PHP

В PHP 8.0 и 8.1 были введены новые директивы конфигурации, которые можно изменять через ini_set, например, opcache.file_cache_only. Также изменились значения по умолчанию для некоторых существующих директив, таких как error_reporting (теперь по умолчанию E_ALL). Сама функция ini_set не претерпела значительных синтаксических изменений, но ее поведение может зависеть от новых возможностей языка и изменений в модулях (например, OPcache).

Важным изменением является усиление строгости типов. В PHP 8 функция более строго проверяет типы передаваемых аргументов, хотя они все еще приводятся к строковым.

Расширенные примеры

<?php
// Сохраняем исходное значение
$original_memory_limit = ini_get('memory_limit');
// Устанавливаем новое значение для ресурсоемкой операции
ini_set('memory_limit', '512M');
// Выполняем операцию, требующую много памяти
$data = range(1, 1000000);
// Восстанавливаем исходное значение
ini_restore('memory_limit');
echo 'Текущий лимит после восстановления: ' . ini_get('memory_limit');
?>

Текущий лимит после восстановления: 128M

<?php
// Установка времени жизни cookie сессии
ini_set('session.cookie_lifetime', 86400); // 1 день
// Изменение пути сохранения файлов сессии
ini_set('session.save_path', '/custom/session/path');
// Запуск сессии с новыми параметрами
session_start();
?>

(Сессия создается с указанными параметрами)

<?php
if ($_SERVER['HTTP_HOST'] == 'localhost') {
    ini_set('display_errors', 1);
    ini_set('display_startup_errors', 1);
} else {
    ini_set('display_errors', 0);
    ini_set('log_errors', 1);
}
?>

(На localhost ошибки выводятся на экран, на продакшн-сервере пишутся в лог)

<?php
// Подготовка к загрузке большого файла
ini_set('upload_max_filesize', '100M');
ini_set('post_max_size', '110M');
ini_set('max_input_time', 300);
// Важно: эти директивы должны быть изменены ДО обработки входящих данных (например, до $_FILES).
?>

(Сервер готов принять файл размером до 100 МБ)