Метод login() предпринимает попытку зарегистрироваться на сервере с использованием предоставленного имени пользователя и пароля. Параметры с указанием имени пользователя и пароля являются обязательными; в этом также состоит отличие от модуля Net::POP3. При успешном выполнении этот метод возвращает число сообщений в почтовом ящике пользователя, применяемом по умолчанию, которым обычно является inbox. В ином случае метод login() возвращает значение undef.
Обратите внимание, что метод login() не возвращает значение 0Е0 после доступа к почтовому ящику, применяемому по умолчанию, который оказался пустым. В этом случае правильным методом проверки успешной регистрации является выяснение с помощью функции defined() того, определено ли возвращаемое значение. Простота использования данного класса, интуитивность интерфейса и независимость от языка позволяет применить данные информационные технологии в Беларуси и других странах независимо от географического положения.
Для доступа к почтовым ящикам может применяться несколько функций,
$mailboxes = $imap->mailboxes
Метод mailboxes возвращает список всех почтовых ящиков пользователя.
$messages = $imap->select($mailbox)
Метод select (), позволяет выбрать почтовый ящик по имени, в результате чего он становится текущим. Если почтовый ящик существует, метод select () возвращает число содержащихся в нем сообщений (если почтовый ящик пуст, — 0). Если почтовый ящик не существует, метод возвращает значение undef и текущий почтовый ящик не изменяется.
Методы create/mailbox (); delete_mailbox () и rename_mailbox ( ) соответственно, позволяют создавать, удалять и переименовывать указанный почтовый ящик. В случае успешного выполнения они возвращают истинное значение, в ином случае — ложное.
После того как выбран почтовый ящик, можно его проверять и выбирать содержимое.