# imap_getacl

(PHP 5, PHP 7, PHP 8)

imap_getacl — Gets the ACL for a given mailbox

### Descripción

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

Gets the ACL for a given mailbox.

### Parámetros

`imap`

  An IMAP\Connection instance.

`mailbox`

  The mailbox name, see imap_open() for more information

  Advertencia

  El paso de datos no confiables a este parámetro es inseguro, a menos que imap.enable_insecure_rsh esté inhabilitado.

### Valores devueltos

Returns an associative array of "folder" => "acl" pairs, o `false` en caso de error.

### Historial de cambios

Versión | Descripción
--- | ---
8.1.0 | The `imap` parameter expects an IMAP\Connection instance now; previously, a valid `imap` recurso was expected.

### Ejemplos

Ejemplo #1 imap_getacl() example

`<?php
print_r(imap_getacl($imap, 'user.joecool'));
?>`

El resultado del ejemplo sería algo similar a:

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

### Notas

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

### Ver también

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