Lightweight PHP mail client with SMTP support, automatic configuration management, and complete email functionality.
Built on PHPMailer, providing stable and reliable email delivery experience.
Automatically configure connection parameters based on environment variables, supporting multiple SMTP services
Support bulk email sending functionality, suitable for system notifications and high-volume sending needs
Built-in error handling and automatic cleanup mechanisms to ensure reliable email delivery
- Environment Variable Configuration: Flexible environment variable setup supporting multi-environment deployment
- SMTP Support: Support for multiple SMTP services with automatic encryption configuration
- HTML/Plain Text: Support for both HTML and plain text email formats
- Multiple Recipients: Support for multiple recipients, CC, and BCC
- Priority Settings: Support for high, normal, and low priority email sending
- Bulk Sending: Built-in bulk sending functionality for improved sending efficiency
- Automatic Cleanup: Automatic cleanup of recipient lists after sending
composer require pardnchiu/mailerMAIL_SERVICE=smtp.gmail.com # SMTP server
MAIL_SERVICE_USER=[email protected] # Sender account
MAIL_SERVICE_PASSWORD=your_password # Password or app password
MAIL_SERVICE_PORT=587 # SMTP port (465/587/25)
MAIL_SERVICE_CHARSET=UTF-8 # Character encodingMethod 1: Static Call (Recommended)
<?php
use pardnchiu\Mailer;
// Direct static call
$result = Mailer::send([
"email" => "[email protected]",
"subject" => "Test Email",
"body" => "<h1>This is a test email</h1>",
"isHtml" => true
]);
if ($result) {
echo "Email sent successfully";
} else {
echo "Email sending failed";
}Method 2: Instance Call
<?php
use pardnchiu\Mailer;
// Initialize mail client
$mailer = new Mailer();
// Basic email sending (calling static method through instance)
$result = $mailer::send([
"email" => "[email protected]",
"subject" => "Test Email",
"body" => "<h1>This is a test email</h1>",
"isHtml" => true
]);
if ($result) {
echo "Email sent successfully";
} else {
echo "Email sending failed";
}Mailer::send($config) - Send single email (static call)
$result = Mailer::send([
"email" => "[email protected]", // Recipient (required)
"subject" => "Email Subject", // Subject (required)
"body" => "Email Content", // Content (required)
"altBody" => "Plain text content", // Plain text version (optional)
"fromEmail" => "[email protected]", // Sender email (optional, defaults to configured account)
"fromName" => "Sender Name", // Sender name (optional)
"cc" => ["[email protected]"], // CC (optional)
"bcc" => ["[email protected]"], // BCC (optional)
"priority" => "high", // Priority: high/normal/low (optional)
"isHtml" => true // HTML format (optional, default false)
]);Multiple Recipients
$config = [
"email" => [
"[email protected]" => "User One",
"[email protected]" => "User Two",
"[email protected]"
],
"subject" => "Group Notification",
"body" => "This is a group notification email"
];
$result = Mailer::send($config);CC and BCC
$config = [
"email" => "[email protected]",
"cc" => [
"[email protected]" => "CC User One",
"[email protected]"
],
"bcc" => [
"[email protected]" => "BCC User One",
"[email protected]"
],
"subject" => "Important Notice",
"body" => "Email content"
];
$result = Mailer::send($config);Mailer::sendBulk($recipients, $subject, $body, $options) - Bulk email sending (static call)
Note: Bulk sending automatically adds a random interval of 1-3 seconds between each email to avoid triggering rate limits from email providers like Gmail and iCloud.
$results = Mailer::sendBulk(
[
"[email protected]" => "User One",
"[email protected]" => "User Two",
"[email protected]" => "User Three"
],
"Bulk Notification Email",
"<h1>This is a bulk sent email</h1>",
[
"isHtml" => true,
"priority" => "normal",
"fromName" => "System Administrator"
]
);
// Check sending results
foreach ($results as $email => $success) {
if ($success) {
echo "Successfully sent to {$email}\n";
} else {
echo "Failed to send to {$email}\n";
}
}try {
$mailer = new Mailer();
$result = Mailer::send([
"email" => "[email protected]",
"subject" => "Test Email",
"body" => "Test content"
]);
if ($result) {
echo "Email sent successfully";
} else {
echo "Email sending failed";
}
} catch (\Exception $e) {
error_log("Email sending error: " . $e->getMessage());
if (strpos($e->getMessage(), "SMTP connect() failed") !== false) {
echo "SMTP connection failed, please check server settings";
} elseif (strpos($e->getMessage(), "Authentication") !== false) {
echo "SMTP authentication failed, please check username and password";
} else {
echo "Email sending exception: " . $e->getMessage();
}
}// Test SMTP connection
try {
$mailer = new Mailer();
// Send test email
$result = Mailer::send([
"email" => "[email protected]",
"subject" => "SMTP Connection Test",
"body" => "If you receive this email, SMTP configuration is correct."
]);
echo $result ? "SMTP configuration is correct" : "SMTP configuration error";
} catch (\Exception $e) {
echo "SMTP test failed: " . $e->getMessage();
}$results = Mailer::sendBulk([
"[email protected]" => "User One",
"[email protected]" => "User Two",
"[email protected]" => "User Three"
], "Notification", "Content");
$successCount = array_sum($results);
$totalCount = count($results);
$failureCount = $totalCount - $successCount;
echo "Bulk sending completed - Success: {$successCount}, Failed: {$failureCount}, Total: {$totalCount}";This source code project is licensed under MIT.
©️ 2025 邱敬幃 Pardn Chiu