Hello, community! Today, I want to introduce you to Lithe Mail, a package that simplifies SMTP email sending in PHP applications. It offers flexible integration with environment variables for easy configuration. Let’s take a look at how to set it up and use it in your project.
Installation
You can install the package via Composer. Run the following command in your terminal:
composer require lithemod/mail
Usage
Here’s a comprehensive guide on how to use the package to send emails:
1. Setting Up Environment Variables
Create a .env
file in the root of your project and define your email settings:
MAIL_HOST=smtp.yourprovider.com
MAIL_PORT=587
MAIL_USERNAME=your-email@domain.com
MAIL_PASSWORD=your-password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=noreply@domain.com
MAIL_FROM_NAME=Your Name or Company
2. Sending a Simple Text Email
<?php
require 'vendor/autoload.php';
use Lithe\Support\Mail;
use Lithe\Support\Env;
// Load environment variables
Env::load(__DIR__);
// Send the email
$mail = Mail::to('recipient@domain.com', 'Recipient Name')
->subject('Email Subject')
->text('Body of the email in plain text')
->send();
if ($mail) {
echo 'Email sent successfully!';
} else {
echo 'Failed to send email.';
}
3. Sending an HTML Email
<?php
$mail = Mail::to('recipient@domain.com', 'Recipient Name')
->subject('Email Subject')
->html('<h1>Email body in HTML</h1>')
->send();
if ($mail) {
echo 'Email sent successfully!';
} else {
echo 'Failed to send email.';
}
4. Adding CC and BCC Recipients
You can add CC and BCC recipients to your emails using the following methods:
Adding CC
$mail = Mail::to('recipient@domain.com', 'Recipient Name')
->cc('cc@example.com', 'CC Name')
->subject('Email Subject')
->text('Body of the email in plain text')
->send();
Adding BCC
$mail = Mail::to('recipient@domain.com', 'Recipient Name')
->bcc('bcc@example.com', 'BCC Name')
->subject('Email Subject')
->text('Body of the email in plain text')
->send();
5. Setting Reply-To Address
You can set a reply-to address using the replyTo
method:
$mail = Mail::to('recipient@domain.com', 'Recipient Name')
->replyTo('replyto@example.com', 'Reply-To Name')
->subject('Email Subject')
->text('Body of the email in plain text')
->send();
6. Attaching Files
To attach files to your email, use the attach
method:
$mail = Mail::to('recipient@domain.com', 'Recipient Name')
->subject('Email Subject')
->text('Body of the email in plain text')
->attach('/path/to/file.txt', 'CustomFilename.txt')
->send();
7. Adding Custom Headers
You can add custom headers to your email as follows:
$mail = Mail::to('recipient@domain.com', 'Recipient Name')
->subject('Email Subject')
->text('Body of the email in plain text')
->addHeader('X-Custom-Header', 'HeaderValue')
->send();
Final Thoughts
Lithe Mail offers a practical and efficient way to send emails in your PHP applications. With support for environment variables and various features, it can adapt to your email sending needs. Try it out and see how it can enhance communication in your application!
If you have any questions or suggestions, feel free to comment below!
Top comments (1)
This looks like a really useful package for simplified email sending! Having easy configuration with environment variables is a big plus. I'm definitely going to try it out in my next project.