PHP: полный мануал с примерами, функциями и ООП

PECL hrtime 0.4.3+ · hrtime

class HRTime\PerformanceCounter { public static getFrequency(): int; public static getTicks(): int; public static getTicksSince(int $start): int; }

Для измерения одного участка достаточно двух показаний счётчика. Этот класс даёт исходные ticks и частоту, чтобы перевести разницу в секунды.

Имя HRTime\StopWatch содержит пространство имён HRTime и класс StopWatch. $watch = new HRTime\StopWatch(); создаёт отдельный секундомер; = сохраняет его в переменную. $watch->start() вызывает действие именно этого экземпляра; круглые скобки содержат аргументы, пустые означают их отсутствие. HRTime\PerformanceCounter::getTicks() — статический вызов без экземпляра. HRTime\Unit::MILLISECOND — именованная целочисленная константа единицы. echo выводит, var_dump показывает значение с типом, "\n" переносит строку. Класс и объект; Пространства имён.

В сигнатуре int — целое, float — число с дробной частью, bool — true/false; void означает отсутствие полезного возвращаемого значения. Эти слова описывают договор метода, а не единицы времени.

Примеры ниже требуют загруженного PECL hrtime 0.6.0 и совместимой сборки PHP. В общем окружении они проверяются как контекстные; отдельный реальный прогон этой партии выполнен с официальной Windows DLL. Диагностика совместимости и границы проверки.

<?php
$start = HRTime\PerformanceCounter::getTicks();
$sum = array_sum([120, 80, 50]);
$ticks = HRTime\PerformanceCounter::getTicksSince($start);
$seconds = $ticks / HRTime\PerformanceCounter::getFrequency();
echo $sum, "\n";
var_dump($seconds >= 0);

250
bool(true)

<?php
$start = HRTime\PerformanceCounter::getTicks();
str_repeat('item;', 100);
$delta = HRTime\PerformanceCounter::getTicks() - $start;
$frequency = HRTime\PerformanceCounter::getFrequency();
$seconds = $delta / $frequency;
$milliseconds = $seconds * 1000;
var_dump($delta >= 0, $milliseconds >= $seconds);

bool(true)
bool(true)

Практика и границы. Сохраняйте разницу, единицу и описание операции. Не используйте абсолютные ticks как ID сообщения или общую отметку между серверами/перезапусками.

Рядом: HRTime\PerformanceCounter::getTicks, HRTime\PerformanceCounter::getTicksSince, HRTime\PerformanceCounter::getFrequency, HRTime\StopWatch.

Маршрут от задачи к измерению.

• PHP: HRTime\PerformanceCounter
• PECL HRTime: проверенные исходники

PECL hrtime 0.4.3+ · hrtime

public static function getFrequency(): int

Перевести аппаратные тики в понятные секунды можно, только зная число тиков в секунде.

Имя HRTime\StopWatch содержит пространство имён HRTime и класс StopWatch. $watch = new HRTime\StopWatch(); создаёт отдельный секундомер; = сохраняет его в переменную. $watch->start() вызывает действие именно этого экземпляра; круглые скобки содержат аргументы, пустые означают их отсутствие. HRTime\PerformanceCounter::getTicks() — статический вызов без экземпляра. HRTime\Unit::MILLISECOND — именованная целочисленная константа единицы. echo выводит, var_dump показывает значение с типом, "\n" переносит строку. Класс и объект; Пространства имён.

В сигнатуре int — целое, float — число с дробной частью, bool — true/false; void означает отсутствие полезного возвращаемого значения. Эти слова описывают договор метода, а не единицы времени.

Примеры ниже требуют загруженного PECL hrtime 0.6.0 и совместимой сборки PHP. В общем окружении они проверяются как контекстные; отдельный реальный прогон этой партии выполнен с официальной Windows DLL. Диагностика совместимости и границы проверки.

<?php
$frequency = HRTime\PerformanceCounter::getFrequency();
var_dump(is_int($frequency), $frequency > 0);

bool(true)
bool(true)

<?php
$start = HRTime\PerformanceCounter::getTicks();
$count = count([10, 20, 30]);
$delta = HRTime\PerformanceCounter::getTicksSince($start);
$milliseconds = 1000 * $delta / HRTime\PerformanceCounter::getFrequency();
echo $count, "\n";
var_dump($milliseconds >= 0);

3
bool(true)

Практика и границы. Разрешение счётчика и точность конкретного опыта не равны выбранной единице. Наносекундная подпись не устраняет шум планировщика и накладные расходы.

Рядом: HRTime\PerformanceCounter::getTicks, HRTime\StopWatch::getElapsedTime.

Маршрут от задачи к измерению.

• PHP: HRTime\PerformanceCounter::getFrequency
• PECL HRTime: проверенные исходники

PECL hrtime 0.6.0+ · hrtime

public static function getTicks(): int

Снять начальную отметку перед построением отчёта и конечную после него. Измерение задают границы участка кода.

Имя HRTime\StopWatch содержит пространство имён HRTime и класс StopWatch. $watch = new HRTime\StopWatch(); создаёт отдельный секундомер; = сохраняет его в переменную. $watch->start() вызывает действие именно этого экземпляра; круглые скобки содержат аргументы, пустые означают их отсутствие. HRTime\PerformanceCounter::getTicks() — статический вызов без экземпляра. HRTime\Unit::MILLISECOND — именованная целочисленная константа единицы. echo выводит, var_dump показывает значение с типом, "\n" переносит строку. Класс и объект; Пространства имён.

В сигнатуре int — целое, float — число с дробной частью, bool — true/false; void означает отсутствие полезного возвращаемого значения. Эти слова описывают договор метода, а не единицы времени.

if (условие) { ... } выбирает действие; foreach проходит по элементам массива. function ... { return ...; } объявляет повторяемую операцию и отдаёт результат. Вызов и результат; Массив.

Примеры ниже требуют загруженного PECL hrtime 0.6.0 и совместимой сборки PHP. В общем окружении они проверяются как контекстные; отдельный реальный прогон этой партии выполнен с официальной Windows DLL. Диагностика совместимости и границы проверки.

<?php
$before = HRTime\PerformanceCounter::getTicks();
$text = implode(',', ['red', 'green']);
$after = HRTime\PerformanceCounter::getTicks();
echo $text, "\n";
var_dump($after >= $before);

red,green
bool(true)

<?php
function buildLine($items) { return implode(';', $items); }
$start = HRTime\PerformanceCounter::getTicks();
$line = buildLine(['sku-1', 'sku-2']);
$elapsed = HRTime\PerformanceCounter::getTicks() - $start;
echo $line, "\n";
var_dump($elapsed >= 0);

sku-1;sku-2
bool(true)

Практика и границы. Счётчик не является устойчивой меткой календарного события. На 32-bit представление int требует отдельной проверки диапазона; эта партия исполнена на x64.

Рядом: HRTime\PerformanceCounter::getTicksSince, HRTime\PerformanceCounter::getFrequency.

Маршрут от задачи к измерению.

• PHP: HRTime\PerformanceCounter::getTicks
• PECL HRTime: проверенные исходники

PECL hrtime 0.6.0+ · hrtime

public static function getTicksSince(int $start): int

Когда начальная отметка уже сохранена, метод сам снимает текущее показание и отдаёт разность.

Имя HRTime\StopWatch содержит пространство имён HRTime и класс StopWatch. $watch = new HRTime\StopWatch(); создаёт отдельный секундомер; = сохраняет его в переменную. $watch->start() вызывает действие именно этого экземпляра; круглые скобки содержат аргументы, пустые означают их отсутствие. HRTime\PerformanceCounter::getTicks() — статический вызов без экземпляра. HRTime\Unit::MILLISECOND — именованная целочисленная константа единицы. echo выводит, var_dump показывает значение с типом, "\n" переносит строку. Класс и объект; Пространства имён.

В сигнатуре int — целое, float — число с дробной частью, bool — true/false; void означает отсутствие полезного возвращаемого значения. Эти слова описывают договор метода, а не единицы времени.

Примеры ниже требуют загруженного PECL hrtime 0.6.0 и совместимой сборки PHP. В общем окружении они проверяются как контекстные; отдельный реальный прогон этой партии выполнен с официальной Windows DLL. Диагностика совместимости и границы проверки.

<?php
$start = HRTime\PerformanceCounter::getTicks();
$valid = count(['a', 'b', 'c']) === 3;
$ticks = HRTime\PerformanceCounter::getTicksSince($start);
var_dump($valid, $ticks >= 0);

bool(true)
bool(true)

<?php
$start = HRTime\PerformanceCounter::getTicks();
str_repeat('a', 100);
$first = HRTime\PerformanceCounter::getTicksSince($start);
str_repeat('b', 200);
$second = HRTime\PerformanceCounter::getTicksSince($start);
var_dump($first >= 0, $second >= $first);

bool(true)
bool(true)

Практика и границы. Это измерение прошедшего времени, а не жёсткий timeout. Если проверять бюджет после блокирующего вызова, уже потраченное время вернуть нельзя.

Рядом: HRTime\PerformanceCounter::getTicks, HRTime\PerformanceCounter::getFrequency, HRTime\StopWatch.

Маршрут от задачи к измерению.

• PHP: HRTime\PerformanceCounter::getTicksSince
• PECL HRTime: проверенные исходники

PECL hrtime 0.4.3+ · hrtime

class HRTime\StopWatch extends HRTime\PerformanceCounter { start(): void; stop(): void; isRunning(): bool; getElapsedTicks(): int; getLastElapsedTicks(): int; getElapsedTime(int $unit = HRTime\Unit::SECOND): float; getLastElapsedTime(int $unit = HRTime\Unit::SECOND): float; }

Импорт разбит на два обрабатываемых блока; паузу между ними учитывать не нужно. Объект суммирует завершённые участки start→stop.

Имя HRTime\StopWatch содержит пространство имён HRTime и класс StopWatch. $watch = new HRTime\StopWatch(); создаёт отдельный секундомер; = сохраняет его в переменную. $watch->start() вызывает действие именно этого экземпляра; круглые скобки содержат аргументы, пустые означают их отсутствие. HRTime\PerformanceCounter::getTicks() — статический вызов без экземпляра. HRTime\Unit::MILLISECOND — именованная целочисленная константа единицы. echo выводит, var_dump показывает значение с типом, "\n" переносит строку. Класс и объект; Пространства имён.

В сигнатуре int — целое, float — число с дробной частью, bool — true/false; void означает отсутствие полезного возвращаемого значения. Эти слова описывают договор метода, а не единицы времени.

Примеры ниже требуют загруженного PECL hrtime 0.6.0 и совместимой сборки PHP. В общем окружении они проверяются как контекстные; отдельный реальный прогон этой партии выполнен с официальной Windows DLL. Диагностика совместимости и границы проверки.

<?php
$watch = new HRTime\StopWatch();
$watch->start();
$sum = array_sum([8, 12]);
$watch->stop();
echo $sum, "\n";
var_dump($watch->isRunning(), $watch->getElapsedTicks() >= 0);

20
bool(false)
bool(true)

<?php
$watch = new HRTime\StopWatch();
$watch->start(); array_sum([1, 2]); $watch->stop();
$first = $watch->getLastElapsedTicks();
str_repeat('outside;', 20);
$watch->start(); array_sum([3, 4]); $watch->stop();
$last = $watch->getLastElapsedTicks();
var_dump($watch->getElapsedTicks() === $first + $last);
$fresh = new HRTime\StopWatch();
echo $fresh->getElapsedTicks(), "\n";

bool(true)
0

Практика и границы. Один экземпляр не измеряет вложенные участки: повторный start не создаёт стек. Для вложенных/одновременных операций используйте отдельные экземпляры.

Рядом: HRTime\StopWatch::start, HRTime\StopWatch::stop, HRTime\StopWatch::getElapsedTime.

Маршрут от задачи к измерению.

• PHP: HRTime\StopWatch
• PECL HRTime: проверенные исходники

PECL hrtime 0.4.3+ · hrtime

public function start(): void

Начать измерение участка; при повторном использовании продолжить накопление.

Имя HRTime\StopWatch содержит пространство имён HRTime и класс StopWatch. $watch = new HRTime\StopWatch(); создаёт отдельный секундомер; = сохраняет его в переменную. $watch->start() вызывает действие именно этого экземпляра; круглые скобки содержат аргументы, пустые означают их отсутствие. HRTime\PerformanceCounter::getTicks() — статический вызов без экземпляра. HRTime\Unit::MILLISECOND — именованная целочисленная константа единицы. echo выводит, var_dump показывает значение с типом, "\n" переносит строку. Класс и объект; Пространства имён.

В сигнатуре int — целое, float — число с дробной частью, bool — true/false; void означает отсутствие полезного возвращаемого значения. Эти слова описывают договор метода, а не единицы времени.

Примеры ниже требуют загруженного PECL hrtime 0.6.0 и совместимой сборки PHP. В общем окружении они проверяются как контекстные; отдельный реальный прогон этой партии выполнен с официальной Windows DLL. Диагностика совместимости и границы проверки.

<?php
$watch = new HRTime\StopWatch();
var_dump($watch->isRunning());
$result = $watch->start();
var_dump($result, $watch->isRunning());
$watch->stop();

bool(false)
NULL
bool(true)

<?php
$watch = new HRTime\StopWatch();
$watch->start(); $watch->stop();
$before = $watch->getElapsedTicks();
$watch->start(); $watch->stop();
var_dump($watch->getElapsedTicks() >= $before);

bool(true)

Практика и границы. Перед условным вызовом используйте isRunning. Не подавляйте предупреждения операторами @; лучше соблюсти состояние.

Рядом: HRTime\StopWatch::isRunning, HRTime\StopWatch::getElapsedTicks, HRTime\StopWatch::stop.

Маршрут от задачи к измерению.

• PHP: HRTime\StopWatch::start
• PECL HRTime: проверенные исходники

PECL hrtime 0.4.3+ · hrtime

public function stop(): void

Закончить текущий участок, чтобы его длительность вошла в итог.

Имя HRTime\StopWatch содержит пространство имён HRTime и класс StopWatch. $watch = new HRTime\StopWatch(); создаёт отдельный секундомер; = сохраняет его в переменную. $watch->start() вызывает действие именно этого экземпляра; круглые скобки содержат аргументы, пустые означают их отсутствие. HRTime\PerformanceCounter::getTicks() — статический вызов без экземпляра. HRTime\Unit::MILLISECOND — именованная целочисленная константа единицы. echo выводит, var_dump показывает значение с типом, "\n" переносит строку. Класс и объект; Пространства имён.

В сигнатуре int — целое, float — число с дробной частью, bool — true/false; void означает отсутствие полезного возвращаемого значения. Эти слова описывают договор метода, а не единицы времени.

try { ... } finally { ... } выполняет уборку даже при исключении; catch получает ошибку. Обработчик set_error_handler в специальном опыте ловит ожидаемое предупреждение, после него прежний обработчик восстанавливают. Исключения и finally.

Примеры ниже требуют загруженного PECL hrtime 0.6.0 и совместимой сборки PHP. В общем окружении они проверяются как контекстные; отдельный реальный прогон этой партии выполнен с официальной Windows DLL. Диагностика совместимости и границы проверки.

<?php
$watch = new HRTime\StopWatch();
$watch->start();
$result = $watch->stop();
var_dump($result, $watch->isRunning());

NULL
bool(false)

<?php
$watch = new HRTime\StopWatch();
$watch->start();
try {
    try { throw new RuntimeException('broken record'); }
    finally { $watch->stop(); }
} catch (RuntimeException $error) { echo "record rejected\n"; }
var_dump($watch->isRunning());

record rejected
bool(false)

Практика и границы. Перед условным вызовом используйте isRunning. Не подавляйте предупреждения операторами @; лучше соблюсти состояние.

Рядом: HRTime\StopWatch::isRunning, HRTime\StopWatch::getElapsedTicks, HRTime\StopWatch::start.

Маршрут от задачи к измерению.

• PHP: HRTime\StopWatch::stop
• PECL HRTime: проверенные исходники

PECL hrtime 0.4.3+ · hrtime

public function isRunning(): bool

Перед остановкой таймера узнать, начат ли у этого экземпляра незакрытый интервал.

Имя HRTime\StopWatch содержит пространство имён HRTime и класс StopWatch. $watch = new HRTime\StopWatch(); создаёт отдельный секундомер; = сохраняет его в переменную. $watch->start() вызывает действие именно этого экземпляра; круглые скобки содержат аргументы, пустые означают их отсутствие. HRTime\PerformanceCounter::getTicks() — статический вызов без экземпляра. HRTime\Unit::MILLISECOND — именованная целочисленная константа единицы. echo выводит, var_dump показывает значение с типом, "\n" переносит строку. Класс и объект; Пространства имён.

В сигнатуре int — целое, float — число с дробной частью, bool — true/false; void означает отсутствие полезного возвращаемого значения. Эти слова описывают договор метода, а не единицы времени.

if (условие) { ... } выбирает действие; foreach проходит по элементам массива. function ... { return ...; } объявляет повторяемую операцию и отдаёт результат. Вызов и результат; Массив.

Примеры ниже требуют загруженного PECL hrtime 0.6.0 и совместимой сборки PHP. В общем окружении они проверяются как контекстные; отдельный реальный прогон этой партии выполнен с официальной Windows DLL. Диагностика совместимости и границы проверки.

<?php
$watch = new HRTime\StopWatch();
var_dump($watch->isRunning());
$watch->start(); var_dump($watch->isRunning());
$watch->stop(); var_dump($watch->isRunning());

bool(false)
bool(true)
bool(false)

<?php
$watch = new HRTime\StopWatch();
if ($watch->isRunning()) { $watch->stop(); }
$watch->start();
if ($watch->isRunning()) { $watch->stop(); }
var_dump($watch->isRunning());

bool(false)

Практика и границы. Проверка одного объекта ничего не говорит о другом секундомере или о завершении асинхронной операции. Таймер показывает своё состояние, не статус внешнего запроса.

Рядом: HRTime\StopWatch::start, HRTime\StopWatch::stop.

Маршрут от задачи к измерению.

• PHP: HRTime\StopWatch::isRunning
• PECL HRTime: проверенные исходники

PECL hrtime 0.4.3+ · hrtime

public function getElapsedTicks(): int

Прочитать общую длительность выбранных этапов в исходных тиках счётчика.

Имя HRTime\StopWatch содержит пространство имён HRTime и класс StopWatch. $watch = new HRTime\StopWatch(); создаёт отдельный секундомер; = сохраняет его в переменную. $watch->start() вызывает действие именно этого экземпляра; круглые скобки содержат аргументы, пустые означают их отсутствие. HRTime\PerformanceCounter::getTicks() — статический вызов без экземпляра. HRTime\Unit::MILLISECOND — именованная целочисленная константа единицы. echo выводит, var_dump показывает значение с типом, "\n" переносит строку. Класс и объект; Пространства имён.

В сигнатуре int — целое, float — число с дробной частью, bool — true/false; void означает отсутствие полезного возвращаемого значения. Эти слова описывают договор метода, а не единицы времени.

Примеры ниже требуют загруженного PECL hrtime 0.6.0 и совместимой сборки PHP. В общем окружении они проверяются как контекстные; отдельный реальный прогон этой партии выполнен с официальной Windows DLL. Диагностика совместимости и границы проверки.

<?php
$watch = new HRTime\StopWatch();
var_dump($watch->getElapsedTicks());
$watch->start();
$sum = array_sum([2, 3]);
$watch->stop();
echo $sum, "\n";
var_dump($watch->getElapsedTicks() >= 0);

int(0)
5
bool(true)

<?php
$watch = new HRTime\StopWatch();
$watch->start(); array_sum([1, 2]); $watch->stop();
$first = $watch->getLastElapsedTicks();
$watch->start(); array_sum([3, 4]); $watch->stop();
$last = $watch->getLastElapsedTicks();
var_dump($watch->getElapsedTicks() === $first + $last);

bool(true)

Практика и границы. Ticks надо делить на getFrequency, прежде чем подписывать «секунды». Сначала stop, затем чтение: getter не останавливает измерение. Таймер показывает прошедшее время участка, включая ожидание ОС; он не является счётчиком чистого CPU.

Рядом: HRTime\StopWatch::stop, HRTime\PerformanceCounter::getFrequency, HRTime\Unit.

Маршрут от задачи к измерению.

• PHP: HRTime\StopWatch::getElapsedTicks
• PECL HRTime: проверенные исходники

PECL hrtime 0.4.3+ · hrtime

public function getLastElapsedTicks(): int

Прочитать длительность последнего этапа в исходных тиках счётчика.

Имя HRTime\StopWatch содержит пространство имён HRTime и класс StopWatch. $watch = new HRTime\StopWatch(); создаёт отдельный секундомер; = сохраняет его в переменную. $watch->start() вызывает действие именно этого экземпляра; круглые скобки содержат аргументы, пустые означают их отсутствие. HRTime\PerformanceCounter::getTicks() — статический вызов без экземпляра. HRTime\Unit::MILLISECOND — именованная целочисленная константа единицы. echo выводит, var_dump показывает значение с типом, "\n" переносит строку. Класс и объект; Пространства имён.

В сигнатуре int — целое, float — число с дробной частью, bool — true/false; void означает отсутствие полезного возвращаемого значения. Эти слова описывают договор метода, а не единицы времени.

Примеры ниже требуют загруженного PECL hrtime 0.6.0 и совместимой сборки PHP. В общем окружении они проверяются как контекстные; отдельный реальный прогон этой партии выполнен с официальной Windows DLL. Диагностика совместимости и границы проверки.

<?php
$watch = new HRTime\StopWatch();
var_dump($watch->getLastElapsedTicks());
$watch->start();
$sum = array_sum([2, 3]);
$watch->stop();
echo $sum, "\n";
var_dump($watch->getLastElapsedTicks() >= 0);

int(0)
5
bool(true)

<?php
$watch = new HRTime\StopWatch();
$watch->start(); array_sum([1, 2]); $watch->stop();
$first = $watch->getLastElapsedTicks();
$watch->start(); array_sum([3, 4]); $watch->stop();
$last = $watch->getLastElapsedTicks();
var_dump($watch->getLastElapsedTicks() === $last);

bool(true)

Практика и границы. Ticks надо делить на getFrequency, прежде чем подписывать «секунды». Сначала stop, затем чтение: getter не останавливает измерение. Таймер показывает прошедшее время участка, включая ожидание ОС; он не является счётчиком чистого CPU.

Рядом: HRTime\StopWatch::stop, HRTime\PerformanceCounter::getFrequency, HRTime\Unit.

Маршрут от задачи к измерению.

• PHP: HRTime\StopWatch::getLastElapsedTicks
• PECL HRTime: проверенные исходники

PECL hrtime 0.4.3+ · hrtime

public function getElapsedTime(int $unit = HRTime\Unit::SECOND): float

Прочитать общую длительность выбранных этапов в понятной единице времени.

Имя HRTime\StopWatch содержит пространство имён HRTime и класс StopWatch. $watch = new HRTime\StopWatch(); создаёт отдельный секундомер; = сохраняет его в переменную. $watch->start() вызывает действие именно этого экземпляра; круглые скобки содержат аргументы, пустые означают их отсутствие. HRTime\PerformanceCounter::getTicks() — статический вызов без экземпляра. HRTime\Unit::MILLISECOND — именованная целочисленная константа единицы. echo выводит, var_dump показывает значение с типом, "\n" переносит строку. Класс и объект; Пространства имён.

В сигнатуре int — целое, float — число с дробной частью, bool — true/false; void означает отсутствие полезного возвращаемого значения. Эти слова описывают договор метода, а не единицы времени.

Примеры ниже требуют загруженного PECL hrtime 0.6.0 и совместимой сборки PHP. В общем окружении они проверяются как контекстные; отдельный реальный прогон этой партии выполнен с официальной Windows DLL. Диагностика совместимости и границы проверки.

<?php
$watch = new HRTime\StopWatch();
var_dump($watch->getElapsedTime(HRTime\Unit::MILLISECOND));
$watch->start();
$sum = array_sum([2, 3]);
$watch->stop();
echo $sum, "\n";
var_dump($watch->getElapsedTime(HRTime\Unit::MILLISECOND) >= 0);

float(0)
5
bool(true)

<?php
$watch = new HRTime\StopWatch();
$watch->start(); array_sum([1, 2]); $watch->stop();
$watch->start(); array_sum([3, 4]); $watch->stop();
$milliseconds = $watch->getElapsedTime(HRTime\Unit::MILLISECOND);
$seconds = $watch->getElapsedTime(HRTime\Unit::SECOND);
var_dump(abs($milliseconds - $seconds * 1000) < 0.000001);

bool(true)

Практика и границы. Документация задаёт default SECOND; у проверенного исходника 0.6.0 локальная unit не инициализирована до необязательного аргумента. Поэтому явная единица обязательна для надёжного примера. Неизвестный числовой unit в ветке switch попадает в секунды — не используйте это как валидацию. Таймер показывает прошедшее время участка, включая ожидание ОС; он не является счётчиком чистого CPU.

Рядом: HRTime\StopWatch::stop, HRTime\PerformanceCounter::getFrequency, HRTime\Unit.

Маршрут от задачи к измерению.

• PHP: HRTime\StopWatch::getElapsedTime
• PECL HRTime: проверенные исходники

PECL hrtime 0.4.3+ · hrtime

public function getLastElapsedTime(int $unit = HRTime\Unit::SECOND): float

Прочитать длительность последнего этапа в понятной единице времени.

Имя HRTime\StopWatch содержит пространство имён HRTime и класс StopWatch. $watch = new HRTime\StopWatch(); создаёт отдельный секундомер; = сохраняет его в переменную. $watch->start() вызывает действие именно этого экземпляра; круглые скобки содержат аргументы, пустые означают их отсутствие. HRTime\PerformanceCounter::getTicks() — статический вызов без экземпляра. HRTime\Unit::MILLISECOND — именованная целочисленная константа единицы. echo выводит, var_dump показывает значение с типом, "\n" переносит строку. Класс и объект; Пространства имён.

В сигнатуре int — целое, float — число с дробной частью, bool — true/false; void означает отсутствие полезного возвращаемого значения. Эти слова описывают договор метода, а не единицы времени.

Примеры ниже требуют загруженного PECL hrtime 0.6.0 и совместимой сборки PHP. В общем окружении они проверяются как контекстные; отдельный реальный прогон этой партии выполнен с официальной Windows DLL. Диагностика совместимости и границы проверки.

<?php
$watch = new HRTime\StopWatch();
var_dump($watch->getLastElapsedTime(HRTime\Unit::MILLISECOND));
$watch->start();
$sum = array_sum([2, 3]);
$watch->stop();
echo $sum, "\n";
var_dump($watch->getLastElapsedTime(HRTime\Unit::MILLISECOND) >= 0);

float(0)
5
bool(true)

<?php
$watch = new HRTime\StopWatch();
$watch->start(); array_sum([1, 2]); $watch->stop();
$watch->start(); array_sum([3, 4]); $watch->stop();
$milliseconds = $watch->getLastElapsedTime(HRTime\Unit::MILLISECOND);
$seconds = $watch->getLastElapsedTime(HRTime\Unit::SECOND);
var_dump(abs($milliseconds - $seconds * 1000) < 0.000001);

bool(true)

Практика и границы. Документация задаёт default SECOND; у проверенного исходника 0.6.0 локальная unit не инициализирована до необязательного аргумента. Поэтому явная единица обязательна для надёжного примера. Неизвестный числовой unit в ветке switch попадает в секунды — не используйте это как валидацию. Таймер показывает прошедшее время участка, включая ожидание ОС; он не является счётчиком чистого CPU.

Рядом: HRTime\StopWatch::stop, HRTime\PerformanceCounter::getFrequency, HRTime\Unit.

Маршрут от задачи к измерению.

• PHP: HRTime\StopWatch::getLastElapsedTime
• PECL HRTime: проверенные исходники

PECL hrtime 0.4.3+ · hrtime

class HRTime\Unit { const int SECOND = 0; const int MILLISECOND = 1; const int MICROSECOND = 2; const int NANOSECOND = 3; }

Единица отвечает на вопрос, что означает число в отчёте: секунды, миллисекунды, микросекунды или наносекунды.

Имя HRTime\StopWatch содержит пространство имён HRTime и класс StopWatch. $watch = new HRTime\StopWatch(); создаёт отдельный секундомер; = сохраняет его в переменную. $watch->start() вызывает действие именно этого экземпляра; круглые скобки содержат аргументы, пустые означают их отсутствие. HRTime\PerformanceCounter::getTicks() — статический вызов без экземпляра. HRTime\Unit::MILLISECOND — именованная целочисленная константа единицы. echo выводит, var_dump показывает значение с типом, "\n" переносит строку. Класс и объект; Пространства имён.

В сигнатуре int — целое, float — число с дробной частью, bool — true/false; void означает отсутствие полезного возвращаемого значения. Эти слова описывают договор метода, а не единицы времени.

Примеры ниже требуют загруженного PECL hrtime 0.6.0 и совместимой сборки PHP. В общем окружении они проверяются как контекстные; отдельный реальный прогон этой партии выполнен с официальной Windows DLL. Диагностика совместимости и границы проверки.

<?php
echo HRTime\Unit::SECOND, "\n";
echo HRTime\Unit::MILLISECOND, "\n";
echo HRTime\Unit::MICROSECOND, "\n";
echo HRTime\Unit::NANOSECOND, "\n";

0
1
2
3

<?php
$watch = new HRTime\StopWatch();
$watch->start();
$count = count(['row-1', 'row-2']);
$watch->stop();
$report = ['rows' => $count, 'milliseconds' => $watch->getElapsedTime(HRTime\Unit::MILLISECOND)];
echo $report['rows'], "\n";
var_dump($report['milliseconds'] >= 0);

2
bool(true)

Практика и границы. Нельзя передавать Unit::NANOSECOND в getTicks: у него нет такого аргумента. Для самостоятельного пересчёта ticks нужны частота и масштаб, а не константа режима.

Рядом: HRTime\StopWatch::getElapsedTime, HRTime\StopWatch::getLastElapsedTime, HRTime\PerformanceCounter::getFrequency.

Маршрут от задачи к измерению.

• PHP: HRTime\Unit
• PECL HRTime: проверенные исходники