Time Module¶

XPSPL¶

XPSPL >= 2.0

Importing¶

<?php

xp_import('time');

Timeouts¶

Timeouts are functions executed once after a specific amount of time.

Timeouts are supported using the awake and xp_exhaust functions.

The below example demonstrates executing a timeout after 30 seconds.

<?php
// Import the time module.
xp_import('time');

// Define the exhaust rate of 1.
time\awake(30, xp_exhaust(1, function(){
    echo '30 seconds just passed';
});

Intervals¶

Intervals are functions executed continously after a specific amount of time.

The example below demonstrates an interval that runs every 30 seconds.

<?php

xp_import('time');

time\awake(30, function(){
    echo '30 seconds passed';
});

Milliseconds and Microseconds Instructions¶

The wait time period can be defined as seconds, milliseconds and microseconds.

Defining the instruction of time can be done by providing the $instruction to the awake function usign the time instruction constants.

• TIME_SECONDS Second instruction
• TIME_MILLISECONDS Millisecond instruction
• TIME_MICROSECONDS Microsecond instruction

The example below demonstrates executing timeouts in seconds, milliseconds and microseconds.

<?php

xp_import('time');

// SECONDS
time\awake(30, function(){
    echo '30 seconds just passed';
}, TIME_SECONDS);

// MILLISECONDS
time\awake(1000, function(){
    echo '1000 milliseconds just passed';
}, TIME_MILLISECONDS);

// SECONDS
time\awake(1000, function(){
    echo '1000 microseconds just passed';
}, TIME_MICROSECONDS);

CRON Time¶

The CRON syntax is supported for executing signals based on the CRON syntax using the CRON api function.

The example below demonstrates executing a signal everyday at 12pm.

<?php
// CRON
time\CRON('12 * * * *', function(){
    echo 'It is 12 oclock!';
});