bitandblack/measurement

Simple PHP code time measurement

2.1.0 2025-03-13 15:31 UTC

Requires

• php: >=8.2

Requires (Dev)

• phpstan/phpstan: ^1.0
• phpunit/phpunit: ^11.0
• rector/rector: ^1.0
• symplify/easy-coding-standard: ^12.0

MIT

• Tobias Köngeter

• time
• measure
• measurement

README

Bit&Black Measurement

Simple PHP code time measurement. Using time units allows receiving information about the start time and end time of a unit and also its execution length in total seconds and in percent.

If angle/chrono is the easiest way, this is the second easiest.

Installation

This library is made for the use with Composer. Add it to your project by running $ composer require bitandblack/measurement.

Usage

Set up a new Measurement object once:

<?php 

use BitAndBlack\Measurement\Measurement;

$measurement = new Measurement();

Create a Unit object for every part you want to measure, add it to the measurement object and start the measurement:

<?php 

use BitAndBlack\Measurement\Unit;

$unit = new Unit('Sample Unit');

$measurement->add(
    $unit->start()
);

When you want to end the measurement of a unit, call $unit->end().

To receive the information about all your units, call $measurement->getSummary(). In out example, this would get something like:

Array
(
    [0] => Array
        (
            [description] => Sample Unit
            [started] => object(DateTime) // 2022-07-04 07:08:38.032900
            [ended] => object(DateTime) // 2022-07-04 07:08:40.035100
            [tookTime] => 2.0021901130676
            [tookPercent] => 100
        )
)

Each unit object stores its own information, that can be access by regular getter methods. So you can access them for example like that:

<?php 

var_dump('Sample Unit took ' . $unit->getTime() . ' seconds.');

Help

If you have any questions, feel free to contact us under [e-mail].

Further information about Bit&Black can be found under www.bitandblack.com.