Download the PHP package neutron/tip-top without Composer
On this page you can find all versions of the php package neutron/tip-top. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package tip-top
TIP-TOP
A micro library to set timeouts and periodic timers.
It uses Evenement. Most of the timers code has been taken from ReactPHP timers implementation.
Installation
The recommended way to use tip-top is through composer.
Disclaimer
Limitations
-
Tip-Top requires you declare ticks in the script you're running.
- Tip-Top may not work as expected with blocking calls (try it before)
Is this blocking or non-blocking IO ?
TipTop is non blocking, but it has been designed to support some blocking
calls. Timers and timeout may be triggered lately in case you use blocking
calls like sleep(5)
.
A common workaround for sleep
is to iterate 1 seconds sleeps :
for ($i=0; $i!=5; $i++;) {sleep(1);}
.
Has the clock atomic precision ?
Unfortunately, this library is based on a hack on the pcntl_alarm function. Therefore, the resolution of the clock is the second, and it has shift that is approximatively 0,001 second per second.
What's the use case for such clock ?
Think about long running processes that have to be checked regularly.
Documentation
Examples
There are two main methods on the Neutron\TipTop\Clock
object :
addPeriodicTimer
and addTimer
.
Remove a timer
You can remove a timer using its cancel
method :
Clear all timers
You may want to clear all timers :
Block
You can sometimes want to block until all timers have finished, use the block
method to do that.
Tests
Tip Top is functional and unit testable with PHPUnit.
To run tests on your system, please be sure to install dev-dependencies with
composer install --dev
, then run either bin/phpunit -c phpunit.xml.dist
for
unit tests, either bin/phpunit -c phpunit-functional.xml.dist
for functional
tests.
License
This project is licensed under the MIT license.
All versions of tip-top with dependencies
ext-pcntl Version *
ext-posix Version *
evenement/evenement Version ~1.0