SyncEvent::__construct

Constructs a new SyncEvent object

Description

public SyncEvent::__construct(string $name = ?, bool $manual = false, bool $prefire = false)

Constructs a named or unnamed event object.

Parameters

name

The name of the event if this is a named event object.

Note:

If the name already exists, it must be able to be opened by the current user that the process is running as or an exception will be thrown with a meaningless error message.

manual

Specifies whether or not the event object must be reset manually.

Note:

Manual reset event objects allow all waiting processes through until the object is reset.

prefire

Specifies whether or not to prefire (signal) the event object.

Note:

Only has impact if the calling process/thread is the first to create the object.

Return Values

The new SyncEvent object.

Errors/Exceptions

An exception is thrown if the event object cannot be created or opened.

Examples

Example #1 SyncEvent::__construct example

<?php
// In a web application:
$event = new SyncEvent("GetAppReport");
$event->fire();

// In a cron job:
$event = new SyncEvent("GetAppReport");
$event->wait();
?>

Changelog

Version Description
PECL sync 1.1.0

Added prefire.

See Also

  • SyncEvent::fire
  • SyncEvent::reset
  • SyncEvent::wait