shm_attach
(PHP 4, PHP 5, PHP 7, PHP 8)
shm_attach — Erzeugt oder öffnet einen gemeinsamen Speicherbereich
Beschreibung
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_memin 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
