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

  IMAP\Connection 实例。

`mailbox`

  The mailbox name, see imap_open() for more information

  警告

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

### 返回值

Returns an associative array of "folder" => "acl" pairs, 或者在失败时返回 `false`.

### 更新日志

版本 | 说明
--- | ---
8.1.0 | 现在 `imap` 参数接受 IMAP\Connection 实例，之前接受有效的 `imap` resource。

### 示例

示例 #1 imap_getacl() example

`<?php
print_r(imap_getacl($imap, '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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open