imap_getacl

(PHP 5, PHP 7, PHP 8)

imap_getacl — Gets the ACL for a given mailbox

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

Gets the ACL for a given mailbox.

imap: An IMAP\Connection instance.
mailbox: The mailbox name, see imap_open() for more information

Warning
Passing untrusted data to this parameter is insecure, unless imap.enable_insecure_rsh is disabled.

Returns an associative array of "folder" => "acl" pairs, or false on failure.

Version	Description
8.1.0	The `imap` parameter expects an IMAP\Connection instance now; previously, a resource was expected.

Example #1 imap_getacl() example

<?php

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

?>

The above example will output something similar to:

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

This function is currently only available to users of the c-client2000 or greater library.