imap_errors

(PHP 4, PHP 5, PHP 7, PHP 8)

imap_errors — Получает все произошедшие ошибки IMAP

Описание

imap_errors(): array|false

Возвращает все ошибки IMAP (если они есть), произошедшие с момента запроса текущей страницы или с момента последнего сброса стека ошибок.

Когда вызывается функция imap_errors(), стек ошибок очищается.

Список параметров

У этой функции нет параметров.

Возвращаемые значения

Эта функция возвращает массив всех ошибок IMAP, возникших с момента последнего запуска imap_errors() или с начала страницы. Если таковых нет, возвращает false.

Смотрите также

imap_last_error() - Получает последнюю ошибку IMAP в текущем запросе
imap_alerts() - Возвращает все произошедшие предупредительные сообщения IMAP

add a note

User Contributed Notes 4 notes

down

Brandon Kirsch at perceptionilluminates dot com ¶

11 years ago


If you do not use imap_errors() to clear the error stack, any errors that remain at the end of the script execution will be raised as PHP Notices.

down

Jeremy Glover ¶

17 years ago


When calling imap_close($mbox), notices will be generated for each error that has occurred within the imap functions.  To suppress these error messages (including Mailbox is empty, which is not really an error) simply call imap_errors() and then imap_close($mbox).

down

Luke Madhanga ¶

9 years ago


For those curious, this function will return a linear array of strings as opposed to say error_get_last which returns an associative array of different things.

e.g. 

 [0 => '[TRYCREATE] No folder {imap.gmail.com} (Failure)']

down

olliejones at gmail dot com ¶

1 year ago


This can generate the string "Mailbox is empty" right after a call to imap_open().  That's not an error.  That means something like this is not good enough to know the open failed due to a wrong password or host name or whatever. This

  $imap = @imap_open( $mailbox, $user, $pass); 
  $errors = @imap_errors();
  if ( $errors ) {
      echo 'Login failed: ' . implode ('; ', $errors );
  }

can output "Login failed: Mailbox is empty" which is silly.

Instead, check the return value from imap_open().

  $imap = @imap_open( $mailbox, $user, $pass); 
  if ( ! $imap ) {
      $errors = @imap_errors();
      echo 'Login failed: ' . implode ('; ', $errors );
  }

add a note