declare (directive) statement

Раздел directive позволяет устанавливать поведение блока declare. В настоящее время распознаётся только одна директива: ticks. (См. далее о директиве ticks.)

Часть statement блока declare будет выполнена - то, как она выполняется и какие побочные эффекты возникают в процессе выполнения, зависит от директивы, установленной в блоке directive.

Ticks/Тики

Тик/tick это событие, которое возникает для каждого оператора N нижнего уровня, выполняемого разборщиком внутри блока declare. Значение N специфицируется ticks=N внутри раздела directive блока declare.

Событие (-ия), возникающее при каждом тике, специфицируется функцией register_tick_function(). См. детали далее в примере. Заметьте, что для каждого тика может возникать более чем одно событие.

<?php
// Функция, которая записывает время, когда её вызывают
function profile ($dump = FALSE)
{
    static $profile;

    // Возвращается время, хранимое в профиле, затем удаляется
    if ($dump) {
        $temp = $profile;
        unset ($profile);
        return ($temp);
    }

    $profile[] = microtime ();
}

// Установка обработчика тика/tick handler
register_tick_function("profile");

// Инициализация функции перед блоком declare
profile ();

// Выполняется блок кода, тик вызывается на каждом втором операторе
declare (ticks=2) {
    for ($x = 1; $x < 50; ++$x) {
        echo similar_text (md5($x), md5($x*$x)), "<br />;";
    }
}

// Выводятся данные, хранимые в profiler’е
print_r (profile (TRUE));
?>

Этот пример профилирует PHP-код внутри блока ’declare’, записывая время при выполнении каждого второго низкоуровневого оператора выполненного блока. Эта информация может затем использоваться для поиска медленно работающих участков определённого сегмента кода. Это процесс может выполняться с использованием других методов: использование тиков удобнее и легче реализуется.

Тики хорошо подходят для отладки, реализуя простую многозадачность, фоновый I/O и многие другие задачи.

См. также register_tick_function() и unregister_tick_function().