SyncSharedMemory::__construct

Constructs a new SyncSharedMemory object

Description

public SyncSharedMemory::__construct ( string $name , integer $size )

Constructs a named shared memory object.

Parameters

name

The name of the shared memory 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.

size

The size, in bytes, of shared memory to reserve.

Note:

The amount of memory cannot be resized later. Request sufficient storage up front.

Return Values

The new SyncSharedMemory object. An exception is thrown if the shared memory object cannot be created or opened.

Examples

Example #1 SyncSharedMemory::__construct example

<?php
// You will probably need to protect shared memory with other synchronization objects.
// Shared memory goes away when the last reference to it disappears.
$mem = new SyncSharedMemory("AppReportName"1024);
if (
$mem->first())
{
    
// Do first time initialization work here.
}

$result $mem->write(json_encode(array("name" => "my_report.txt")));
?>

See Also

  • SyncSharedMemory::first
  • SyncSharedMemory::size
  • SyncSharedMemory::write
  • SyncSharedMemory::read