array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.shm-attach.php', 1 => 'shm_attach', 2 => 'Erzeugt oder öffnet einen gemeinsamen Speicherbereich', ), 'up' => array ( 0 => 'ref.sem.php', 1 => 'Semaphore Funktionen', ), 'prev' => array ( 0 => 'function.sem-remove.php', 1 => 'sem_remove', ), 'next' => array ( 0 => 'function.shm-detach.php', 1 => 'shm_detach', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/sem/functions/shm-attach.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

shm_attach

(PHP 4, PHP 5, PHP 7, PHP 8)

shm_attach — Erzeugt oder öffnet einen gemeinsamen Speicherbereich

Beschreibung

shm_attach(int $key, ?int $size = null, int $permissions = 0666): SysvSharedMemory|false

shm_attach() liefert eine ID, über die mit dem gegebenen key auf einen gemeinsamen Speicherbereich vom Typ System V zugegriffen werden kann. Der erste Aufruf legt den gemeinsamen Speicherbereich mit der Größe size und den Zugriffsberechtigungen gemäß der in permissions gesetzten Bits an.

Ein zweiter Aufruf der Funktion shm_attach() mit dem gleichen key liefert eine andere SysvSharedMemory-Instanz, aber beide Instanzen greifen trotzdem auf denselben zugrundeliegenden gemeinsamen Speicherbereich zu. size und permissions werden in diesem Fall ignoriert.

Parameter-Liste

key
Eine numerische ID des gemeinsamen Speicherbereichs.
size
Die Größe des gemeinsamen Speicherbereichs in Bytes. Wird dieser Parameter nicht übergeben, so wird der Wert aus sysvshm.init_mem in php.ini angenommen. Ist auch dieser nicht gesetzt, ist der Vorgabewert 10000 Bytes.
permissions
Optionale Zugriffsrechte als Bitmaske. der Standardwert ist 0666.

Rückgabewerte

Gibt bei Erfolg eine SysvSharedMemory-Instanz zurück. Bei einem Fehler wird false zurückgegeben..

Changelog

Version Beschreibung
8.0.0 Bei Erfolg gibt diese Funktion nun eine SysvSharedMemory-Instanz zurück; vorher wurde eine resource zurückgegeben.
8.0.0 size ist nun ein Nullable-Typ.

Siehe auch