mail

mail поддерживает IMAP-соединение для диагностики ящиков, читает и сохраняет письма, управляет отметками удаления и отправляет тестовые сообщения через локальный PHP mail.

СетьВерсия 1.1.5Стабильная
lil-terminal

Обзор

Используйте mail, чтобы проверять входящую и исходящую почту как два разных маршрута. IMAP отвечает за подключение, ящики и чтение, а mail send отдельно проверяет почтовый транспорт PHP на хостинге.

Входящая и исходящая почта проверяются отдельно

Пароль IMAP вводится через скрытое поле, а состояние соединения хранится в сессии. mail del только ставит отметку удаления; окончательное удаление выполняет mail expunge. Рабочий IMAP не доказывает, что PHP mail отправляет письма, и наоборот.

Синтаксис

lil-terminal
mail [subcommand] [arguments] [options]

Справочник

mail

показать состояние IMAP-соединения и почтового ящика

mail connect <host> <user> [box]

подключиться с вводом пароля в скрытом поле

mail boxes

показать доступные почтовые ящики

mail box <name>

переключить почтовый ящик

mail ls [n] [-u]

показать последние сообщения; -u показывает только непрочитанные

mail read <id> [-o <file>]

показать сообщение или сохранить его текст

mail send <to> <subject> <text>

отправить через PHP mail

-p <port>

задать порт IMAP

-ssl | -tls | -plain

выбрать транспорт IMAP

-k

разрешить непроверенный TLS-сертификат только для диагностики

-f

заменить существующий файл сохранённого сообщения

-from <addr> | -cc <addr> | -bcc <addr> | -reply <addr>

задать дополнительные заголовки сообщения

mail del <id> | mail undel <id>

пометить сообщение на удаление

mail expunge

окончательно удалить сообщения, помеченные на удаление

mail -e

отключиться и очистить данные соединения

Безопасность

Пароли вводятся в общем скрытом поле. Дополнительные заголовки сообщения проверяются до вызова PHP mail. -k отключает проверку сертификата и предназначен только для диагностики

Интерактивный пример из `/sandbox/`

Запускайте подготовленные примеры прямо на странице. Результат заранее сформирован и показывается в браузере; команды терминала на сервере не выполняются.

Показать состояние IMAP-соединения и почтового ящика

Установка и управление

Устанавливайте актуальную совместимую версию. Для полного набора возможностей выбирайте Base, для сокращённого — Minimum; уже установленный модуль обновляет команда upgrade.

Base и Minimum — два пакета одного текущего релиза модуля, а не разные версии команды.

Пакет Base

Установить полный пакет с локальной справкой и всеми опубликованными режимами.

install mail
Пакет Minimum

Установить сокращённый пакет без локальной справки; help <cmd> -i открывает актуальную серверную справку.

install mail -m
Точная публичная версия

Установить именно эту опубликованную версию.

install mail -v 1.1.5
Проверить или обновить

Поручить upgrade проверить совместимость и заменить установленный блок только при необходимости.

upgrade mail
Удалить модуль

Удалить блок расширения, не затрагивая ядро и остальные модули.

install mail -u

Примеры

Примеры можно копировать, но сайт их не выполняет. Перед запуском на реальном проекте проверьте пути, права и разрушающие флаги.

Показать состояние IMAP-соединения и почтового ящика
mail
Почта не подключена
Подключиться с вводом пароля в скрытом поле
mail connect imap.example.com user@example.com
Status    connected
Host      imap.example.com:993/ssl
User      user@example.com
Box       INBOX
Messages  128
Recent    2
Unread    4
Подключиться с вводом пароля в скрытом поле
mail connect imap.example.com user@example.com INBOX -tls -p 143
Status    connected
Host      imap.example.com:993/ssl
User      user@example.com
Box       INBOX
Messages  128
Recent    2
Unread    4
Показать доступные почтовые ящики
mail boxes
INBOX
Archive
Sent
Trash
Переключить почтовый ящик
mail box Archive
Mailbox  Archive
Messages 128
Показать последние сообщения; -u показывает только непрочитанные
mail ls 20
42  2026-08-08  noreply@example.com  Deployment report
41  2026-08-07  admin@example.com    Backup complete
40  2026-08-07  alerts@example.com   TLS renewal
Показать последние сообщения; -u показывает только непрочитанные
mail ls 20 -u
42  2026-08-08  noreply@example.com  Deployment report
Показать сообщение или сохранить его текст
mail read 42
From     noreply@example.com
To       user@example.com
Subject  Deployment report
Date     2026-08-08 09:15:00 UTC

Deployment completed successfully.
Показать сообщение или сохранить его текст
mail read 42 -o sandbox/tmp/message-42.txt
sandbox/tmp/
  message-42.txt
Отправить через PHP mail
mail send admin@example.com "lil diagnostic" "Mail transport test"
Сообщение принято локальным почтовым транспортом
Задать дополнительные заголовки сообщения
mail send admin@example.com "lil diagnostic" "Mail transport test" -from lil@example.com -reply support@example.com
Сообщение принято локальным почтовым транспортом
Пометить сообщение на удаление
mail del 42
Message  42
Deleted  marked
Пометить сообщение на удаление
mail undel 42
Message  42
Deleted  cleared
Окончательно удалить сообщения, помеченные на удаление
mail expunge
Expunged  1
Отключиться и очистить данные соединения
mail -e
Connection  closed
Отклонить неверный адрес получателя
mail send not-an-email "test" "hello"
Некорректно: адрес получателя

Связанная документация

Текущая публичная версия

v1.1.52026-08-12

Синхронизация языков

Завершена синхронизация локальной и серверной справки и усилена безопасность локализации mail.