README

This package is wrapper for php sysv shm_xxx.

Installing

from Packagist

composer require takuya/php-sysv-ipc-shared-memory

from GitHub

name='php-sysv-ipc-shared-memory'
composer config repositories.$name \
vcs https://github.com/takuya/$name  
composer require takuya/$name:master
composer install

Examples

<?php
$uniq_name = 'shm_name';
$shm = new IPCSharedMem($uniq_name);
$shm->put(new MyClass());
//
$obj = $shm->get();// instance of MyClass;
// remove ipc
$shm->destroy()

Safer Access for update.

call get() then set() in the lock to update value using semaphore.

<?php
$idx = 'key';
$store = new IPCShmKeyStore('shm_name');
$store->runWithLock(function($store)use($idx){
  $store->set($store,$shm->get($idx)+1);
});

More easy usage : Array Access.

This package offers KVS style access to Shared Memory.

<?php
$store = new IPCShmKeyStore('kvs-like', 1024*1024);
// Set by key
$store->set('key',['msg'=>'Auxakai3']);
// Get by key
$store->get('key')['msg']; // => Auxakai3 

This package offers ArrayAccess style to use Shared Memory.

<?php
$arr = new IPCShmKeyStore('array-like', 100);
$arr[] = 'a';
$arr[] = 'b';
$arr[] = 'c';
foreach($arr as $e){
  echo "$e,";
}
// => "a,b,c,"

Limitation: ArrayAccess is not a real 'array'. Array functions ( ex array_map() ) cannot be applied for this.

comparison to shm_open

Compare to shared memory functions ( ex shmop_open()) , One big advantage SysV functions has.

Sysv function (ex shm_put_var) has auto serialization.

See Also.

I wrote these php code.

• SysV IPC Wrapper
  • PHP SysV IPC SharedMemory Wrapper This package
  • PHP SysV IPC Semaphore Wrapper
  • PHP SysV IPC Message Queue Wrapper
• shm_open
  • PHP SharedMemory Operation (shmop_open)
• psr/simplecache
  • PHP SysV IPC SharedMemory as Cache
• maintenance
  • PHP SysV IPC Info
• laravel cache
  • Laravel Shm Cache Store

remove ipc by manually

If unused ipc remains. use SHELL command to remove.

ipcs -m | grep $USER | grep -oE '0x[a-f0-9]+' | xargs -I@ ipcrm --shmem-key @