# imap_getacl

(PHP 5, PHP 7)

imap_getacl — Gets the ACL for a given mailbox

### 说明

imap_getacl ( resource `$imap_stream` , string `$mailbox` ) : array

Gets the ACL for a given mailbox.

### 参数

`imap_stream`

  由 imap_open() 返回的 IMAP 流。

`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.

### 范例

Example #1 imap_getacl() example

    <?php

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

    ?>

以上例程的输出类似于：

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

### 注释

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

### 参见

- imap_setacl() - Sets the ACL for a given mailbox