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

    VersionBeschreibung
    8.0.0 Bei Erfolg gibt diese Funktion nun eine SysvSharedMemory-Instanz zurück; vorher wurde eine resource zurückgegeben.
    8.0.0size 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
    To Top