PHP 8.4.1 Released!

imap_getacl

(PHP 5, PHP 7, PHP 8)

imap_getaclLiefert die Liste der Zugriffsrechte (ACL) für ein Postfach

Beschreibung

imap_getacl(IMAP\Connection $imap, string $mailbox): array|false

Gibt die Zugriffsrechte (ACL, Access Control List) für ein gegebenes Postfach zurück.

Parameter-Liste

imap

Eine IMAP\Connection-Instanz.

mailbox

Der Name des Postfachs, siehe imap_open() für weitere Informationen

Warnung

Die Übergabe von nicht vertrauenswürdigen Daten an diesen Parameter ist unsicher,falls imap.enable_insecure_rsh nicht deaktiviert ist.

Rückgabewerte

Gibt ein Array mit Postfachnamen als Schlüssel und Zugriffsrecht-Listen als Wert zurück. Bei einem Fehler wird false zurückgegeben.

Changelog

Version Beschreibung
8.1.0 Der Parameter imap erwartet nun eine IMAP\Connection-Instanz; vorher wurde eine gültige imap-Ressource erwartet.

Beispiele

Beispiel #1 imap_getacl()-Beispiel

<?php

print_r
(imap_getacl($imap, 'user.joecool'));

?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

Array
(
    [asubfolder] => lrswipcda
    [anothersubfolder] => lrswipcda
)

Anmerkungen

Diese Funktion ist aktuell erst ab der Bibliotheksversion c-client2000 verfügbar.

Siehe auch

  • imap_setacl() - Legt die ACL (Zugriffsrechte) für ein Postfach fest

add a note

User Contributed Notes 1 note

up
0
hartmut dot woehrle at hwds dot ch
8 years ago
Maybe the functionality changed over the years but the examples are wrong.
It does NOT return [subfolder] => ACL

At the moment (PHP5) the usage and answer of imap_getacl is the following:
You ask for the folder and get the ACLs for exactly this folder (no Wildcards)

Example:
When you have the folder Business in your mailbox

print_r(imap_getacl($connection , "user/john.doe/Business"));

returns the following:

Array
(
[john.doe@example.com] => lrswipkxtecda
[cyrus@example.com] => lrswipkxtecd
[secretary@example.com] => lrsp
[department@example.com] => lrs
)

Which means you have to loop over your directories (imap_list) and list the ACL for ever folder seperately.
To Top