msg_set_queue
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
msg_set_queue — Setzt Metadaten in der Datenstruktur der Nachrichten-Warteschlange
Beschreibung
msg_set_queue() erlaubt es, die Werte der Felder msg_perm.uid, msg_perm.gid, msg_perm.mode und msg_qbytes in der Datenstruktur der Nachrichten-Warteschlange zu ändern.
Änderungen an diesen Werten erfordern, dass PHP unter demselben Benutzer ausgeführt wird, der die Warteschlange erstellt hat, der Eigentümer der Warteschlange ist (wie in den existierenden msg_perm.xxx Feldern festgelegt) oder mit root-Rechten ausgeführt wird. Zur Erhöhung des msg_qbytes-Wertes über das systemweite Limit hinaus sind ebenfalls root-Rechte erforderlich.
Parameter-Liste
-
queue
-
Die Nachrichten-Warteschlange.
-
data
-
Die gewünschten neuen Werte werden als Schlüssel/Wert-Paare im
data
-Array übergeben.
Rückgabewerte
Gibt bei Erfolg true
zurück. Bei einem Fehler wird false
zurückgegeben.
Changelog
Version | Beschreibung |
---|---|
8.0.0 |
queue erwartet nun eine
SysvMessageQueue-Instanz; vorher wurde eine
resource erwartet.
|
Siehe auch
- msg_remove_queue() - Entfernt eine Nachrichten-Warteschlange
- msg_receive() - Liest eine Nachricht aus einer Nachrichten-Warteschlange aus
- msg_stat_queue() - Liefert Informationen zur Datenstruktur einer Nachrichten-Warteschlange
- msg_get_queue() - Legt eine Nachrichten-Warteschlange an oder hängt sich an existierende an