pardnchiu / mailer

v1.0.0 2025-08-24 11:13 UTC

Requires

• php: >=8.0
• phpmailer/phpmailer: ^6.9

MIT

• 邱敬幃 Pardn Chiu

• mailer
• php
• email
• smtp
• pardnchiu
• 邱敬幃

Published on Packagist.org on 2025-08-24 11:14 UTC

README

Last updated: 2026-10-25

Note

This README was generated by SKILL, get the ZH version from here.

SEND SMTP MAIL IN ONE STATIC CALL!

A PHP mailer library with env-based SMTP configuration, port-aware encryption, and rate-limit-friendly bulk sending

Table of Contents

• Features
• Architecture
• License
• Author

Features

composer require pardnchiu/mailer · Documentation

• Environment Variables as Config — SMTP host, credentials, port, and charset all come from environment variables, so sending takes one static call.
• Port-Aware Encryption — Port 465 switches to SMTPS automatically and every other port uses STARTTLS, with no encryption setting to choose.
• Flexible Recipient Formats — To, CC, and BCC each accept a single string, a list of addresses, or an address-to-name map.
• Rate-Limit-Friendly Bulk Sending — Bulk sends wait a random 1 to 3 seconds between messages to avoid tripping limits at providers like Gmail and iCloud.
• Priority and Dual-Format Bodies — High, normal, and low priority are supported, and HTML bodies can carry a plain-text alternative.

Architecture

Full Architecture

graph TB
    A[Caller] --> B[Mailer::send / sendBulk]
    ENV[MAIL_SERVICE_* env vars] --> C[SMTP setup]
    B --> C
    C --> D[Recipients / CC / priority]
    D --> E[PHPMailer]
    E --> F[SMTP server]

Loading

License

This project is licensed under the MIT LICENSE.

Author

Just open an issue to share an idea.

©️ 2025 邱敬幃 Pardn Chiu