PHP Luminova: Base Email Template Base Classes
The BaseMailer class provides a convenient way to create reusable email templates and send them when necessary using the Luminova email framework.
The BaseMailer
class is a foundational component of the Luminova email framework, designed to simplify the process of creating and sending email messages.It serves as a template for defining email templates with customizable subjects, HTML content, alternative text bodies, and attachments.
- Class namespace:
\Luminova\Base\BaseMailer
- This class is an Abstract class
Methods
getSubject
Get the subject of the email.
public getSubject(): string|null
Return Value:
string|null
- The subject of the email.
getHtml
Get the HTML
body of the email.
public getHtml(): string|null
Return Value:
string|null
- Return email template html body.
getText
Get the TEXT
body of the email.
public getText(): string|null
Return Value:
string|null
- Return email template alt text body.
getFiles
Get the attachments of the email.
public getFiles(): array<string,string>|null
Return Value:
array<string,string>|null
- Return arrays of attachments or null if not attachment to send.
Array keys
- path: The file path.
- name: Optional file name.
- encoding: File encoding (default: base64).
- type: Optional file type.
- disposition: File disposition (default: attachment)
Usage
To create a custom email template, you can extend the BaseMailer
class and implement the required methods for subject, HTML content, alternative text body, and attachments.
// app/Utils/OrderTemplate.php
<?php
namespace App\Utils;
use \Luminova\Base\BaseMailer;
class OrderTemplate extends BaseMailer
{
public function getSubject(): ?string
{
return 'Subject';
}
public function getHtml(): ?string
{
return '<p>Message html</p>';
}
public function getText(): ?string
{
return 'Message alt body';
}
public function getFiles(): ?array
{
return null;
}
}
In this example, OrderTemplate
extends BaseMailer
and provides implementations for the getSubject()
, getHtml()
, getText()
, and getAttachments()
methods.
Sending Email
To send an email using the OrderTemplate
, you can use the Mailer
class provided by Luminova framework.
// app/Controllers/MailerController.php
<?php
namespace App\Controllers;
use \Luminova\Email\Mailer;
use \App\Utils\OrderTemplate;
class MailerController extends BaseController
{
public function sendEmail(): int
{
Mailer::to('[email protected]')->send(new OrderTemplate());
}
}
In this code, an instance of Mailer
is created, and the send()
method is called with the OrderTemplate
instance as an argument.The email will be sent with the configured subject, HTML content, alternative text body, and attachments defined in the OrderTemplate
class.