Demo
Demo
База знаний PMTA›Механизм§ 7.4

Обвязка подачи на C++

C++ Submission API
Третья из пяти

Обвязка подачи на C++ — третья из пяти в главе. Её 19 методов — тот же набор возможностей, что у обвязки C, только без функций выделения, освобождения и запроса ошибки.

Три класса в трёх заголовках: submitter/Connection.hxx, submitter/Message.hxx и submitter/Recipient.hxx; на Linux они лежат в /opt/pmta/api/include.

Ошибка — исключение, после которого объект негоден и его выбрасывают. Подключение умеет вход с логином и паролем — механизмом CRAM-MD5, так что пароль по сети не передаётся.

Главная ловушка — продолжать с объектом после ошибки. Любое исключение делает объект негодным: повтор на нём бессмыслен, объект создают заново, а письмо подают заново.
Что делает Хаб. Не используется: Хаб подаёт письма по SMTP. Методы этой обвязки полезны как перечень того, что подающая сторона может решать за письмо.
Рекомендуемые значения

Главные методы:

Метод Что задаёт
Connection::Connection сервер, порт, по желанию логин и пароль
Message::setVirtualMta адрес отправки для письма
Message::setJobId задание
Message::setEncoding кодировку добавляемых данных
Message::setReturnType что вкладывать в отчёт о недоставке
Connection::submit подать письмо
Заголовки, модель ошибок и методы — из руководства (§ 7.4). Выбор методов для таблицы — наш.
Пример в конфигурации
# письмо через обвязку C++: соединение, отправитель, адрес отправки
Connection conn("127.0.0.1", 25);
Message msg("sender@example.com");
msg.setVirtualMta("vmta1");conn.submit(msg);
Набросок по описаниям методов руководства; получателей добавляют addRecipient, содержимое — addData.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
⇄

Связанные записи

2 связи

То же имя в других блоках

Обвязка подачи на CТа же настройка на другом уровне. § 7.5

Где это видно

Что подающая система собирает перед отправкойСмежный механизм: они работают вместе. § 7.4

Как проверить на узле
Проверить, что заголовки обвязки на месте:
ls /opt/pmta/api/include/submitter/
Файлы Connection.hxx, Message.hxx и Recipient.hxx — обвязка C++ установлена.
◇

Что ещё почитать

3 статьи

◇Как письмо попадает в MTAШесть описанных способов подачи: расширенный SMTP, четыре языковые обвязки и каталог, за которым узел следит на диске.◇Кому разрешено сдавать почту и для кого её приниматьИз коробки узел принимает подачу только с самой машины; два разных вопроса — «кто может слать через нас» и «на чьи адреса мы принимаем» — решаются разными директивами.◇Заголовки, которыми отправитель управляет доставкойШесть служебных заголовков позволяют подающей стороне выбрать поток, пометить письмо заданием, задать настройки и ключ подписи, идентификатор конверта и расписание; каждый разрешается отдельно и по источникам.

В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Подключить платформу отправки