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

shm_detach() - Beendet die Anbindung an einen gemeinsamen Speicherbereich
ftok() - Erzeugt aus einem Dateipfad und einem Projektbezeichner einen System-V-IPC-Schlüssel