jstewmc/floor-execution-time

Floor a script's execution time

floor-execution-time

Floor a script's execution time., _(*1)

This library will calculate a script's total execution time from $_SERVER['REQUEST_TIME_FLOAT'] to now in milliseconds., _(*2)

If the total execution time is less than the floor, it will sleep for the difference:, _(*3)

namespace Jstewmc\FloorExecutionTime;

// instantiate the service with a 500 millisecond floor
$service = new FloorExecutionTime(500);

// ... something that takes 100 milliseconds

$service();  // sleeps for 400 milliseconds

If the execution time is greater than the floor, it will not sleep:, _(*4)

namespace Jstewmc\FloorExecutionTime;

// instantiate the service with a 500 millisecond floor
$service = new FloorExecutionTime(500);

// ... something that takes 1,000 milliseconds

$service();  // sleeps for 0 milliseconds

Flooring execution time helps defend against brute-force and timing attacks. Scripts which are likely to be brute-forced should be slow. Scripts which are likely to be timing attacked should have a constant execution time. Some scripts should be both., _(*5)

Dependencies

This library depends on the REQUEST_TIME_FLOAT server variable. There is no guarantee that every web server will provide the REQUEST_TIME_FLOAT variable, however, most will. If the REQUEST_TIME_FLOAT server variable does not exist, this library will throw a RuntimeException on construction., _(*6)

License

MIT, _(*7)

Author

Jack Clayton, _(*8)

Version

2.0.0, December 27, 2016

• Rename Floor to FloorExecutionTime.
• Update __construct() to throw exception if REQUEST_TIME_FLOAT server variable does not exist.
• Remove $start argument of __invoke() method. It makes more sense to use REQUEST_START_TIME.

1.0.0, August 16, 2016

• Major release
• Update composer.json
• Clean up comments

0.1.0, August 3, 2016

• Initial release