Настройка и управление лимитом времени выполнения PHP-скриптов

Расширенные примеры настройки лимита времени выполнения PHP с пояснениями и результатами

<?php
// Пример 1: Комбинирование set_time_limit и обработки ошибок превышения времени
try {
    set_time_limit(2); // установим маленький лимит для демонстрации
    // имитация длительной операции
    sleep(3);
    echo "Скрипт завершен успешно";
} catch (Throwable $e) {
    // В PHP нет специального исключения для превышения времени, 
    // но можно установить обработчик через register_shutdown_function
    echo "Ошибка: " . $e->getMessage();
}
?>

Результат: скрипт будет прерван до завершения. Обработчик не сработает, но shutdown-функция может быть зарегистрирована.

<?php
// Пример 2: Использование register_shutdown_function для реакции на превышение лимита
register_shutdown_function(function() {
    $error = error_get_last();
    if ($error !== null && $error['type'] === E_ERROR) {
        // Проверка на превышение времени: сообщение содержит 'Maximum execution time'
        if (strpos($error['message'], 'Maximum execution time') !== false) {
            echo "Скрипт был остановлен из-за превышения лимита времени.\n";
            // Дополнительная логика: запись в лог, отправка уведомления
        }
    }
});
set_time_limit(1);
while(true) { // бесконечный цикл
    // что-то делаем
}
?>

Результат: скрипт прерывается через 1 секунду, shutdown-функция выводит сообщение и может выполнить очистку.

<?php
// Пример 3: Динамическое увеличение лимита в зависимости от размера входных данных
function processLargeFile($filePath) {
    $fileSize = filesize($filePath);
    // Расчет лимита: 1 секунда на каждые 50 КБ
    $estimatedTime = ceil($fileSize / 50000);
    set_time_limit($estimatedTime + 10); // +10 секунд запаса
    // ... чтение файла построчно
}
?>

Результат: лимит адаптируется под объем работы, снижая риск преждевременного прерывания.

<?php
// Пример 4: Переопределение лимита только для определенного маршрута в фреймворке (Laravel)
// В контроллере:
public function longReport() {
    set_time_limit(600); // 10 минут
    // генерация отчета
}
?>

Результат: только данный экшн имеет увеличенный лимит, остальные используют значение по умолчанию.

<?php
// Пример 5: Отключение лимита времени для фоновых задач (CLI)
// При запуске из командной строки: php script.php
// По умолчанию лимит равен 0 (бесконечно) в CLI, но можно явно установить:
set_time_limit(0);
// или в php.ini для CLI: max_execution_time = 0
?>

Результат: скрипт может работать без ограничения по времени, что удобно для долгих кронов.

<?php
// Пример 6: Влияние set_time_limit на вложенные вызовы (например, рекурсия)
function recursiveTask($depth) {
    if ($depth > 10) return;
    set_time_limit(1); // сброс таймера на каждом рекурсивном вызове
    echo "Глубина: $depth\n";
    recursiveTask($depth + 1);
}
set_time_limit(5);
recursiveTask(0);
?>

Результат: благодаря сбросу таймера на каждом уровне, рекурсия успевает выполниться, даже если общий лимит 5 секунд, а один вызов занимает 0.5 секунды.

<?php
// Пример 7: Использование ini_set с проверкой текущего значения
$currentLimit = ini_get('max_execution_time');
echo "Текущий лимит: $currentLimit сек\n";
if ($currentLimit < 300) {
    ini_set('max_execution_time', 300);
    echo "Лимит увеличен до 300 сек\n";
}
// далее работа
?>

Результат: лимит увеличивается только если он меньше 300, без лишних изменений.

<?php
// Пример 8: Настройка через .user.ini с проверкой директивы (для dev-среды)
// В файле .user.ini:
; max_execution_time = 120
; На production обычно не используют, лучше в php.ini
?>

Результат: файл .user.ini должен быть в корне проекта и прочитан PHP.

<?php
// Пример 9: Обработка ситуации, когда set_time_limit заблокирована в php.ini (disable_functions)
if (function_exists('set_time_limit')) {
    set_time_limit(500);
} else {
    // запасной вариант: попробовать через ini_set
    if (ini_get('max_execution_time') != 0) {
        ini_set('max_execution_time', 500);
    } else {
        echo "Невозможно изменить лимит – используется значение по умолчанию: " . ini_get('max_execution_time') . " сек\n";
    }
}
?>

Результат: скрипт адаптируется к настройкам сервера.

<?php
// Пример 10: Комбинация с set_time_limit и функцией time_nanosleep для пакетной обработки
$batchSize = 100;
$delay = 100000; // 0.1 сек в микросекундах
for ($i = 0; $i < $batchSize; $i++) {
    // обработка элемента
    time_nanosleep(0, $delay * 1000); // микросекунды -> наносекунды
    // сброс таймера каждые 10 итераций, чтобы не превысить лимит
    if ($i % 10 === 0) {
        set_time_limit(ini_get('max_execution_time') + 10);
    }
}
?>

Результат: таймер продлевается по мере выполнения, предотвращая прерывание при длительной пакетной обработке.