This article introduces you to the issue of integrating PHP emails. PHP is one of the most popular web development programming languages ??today. Companies send emails to users to inform them of new products, such as promotional emails or to communicate with employees. Below I will give you a detailed introduction on how to integrate the popular Mailtrap platform in PHP to send multiple emails. I hope it will be helpful to friends in need~

Use Mailtrap to integrate PHP emails

PHP is one of the most popular web development programming languages ??today. Companies send emails to users to inform them of new products, such as promotional emails or to communicate with employees.

In this tutorial, we look at how to integrate the popular Mailtrap platform in our PHP to send multiple emails. [Recommended learning: PHP video tutorial]

Prerequisites

To follow this tutorial, you need to meet the following conditions.

• Basic concepts of PHP, preferably PHP8.0.

• Basic concepts of Simple Mail Transfer Protocol (SMTP).

• A mailtrap account.

Goals

By the end of this tutorial, you should be able to integrate Mailtrap into your PHP application for testing emails.

Get started with mailtrap

Developing a wide range of applications has many requirements. This includes requirements to test your application to ensure everything is working as planned. One of the key requirements for these applications, such as Edge as a service, is the ability to test email functionality.

Co's customers often take advantage of Edge as a service, and they have a flexible payment plan. To remind these customers of their next due date, we need to send them an email.

A key challenge with sending emails is that we are not sure if our emails are being delivered. To ensure emails are delivered, we need to test our emails at a development and staging level to ensure they work well in production.

Now, Mailtrap comes along with the development and staging phases of the application development process. It is used to test emails to ensure they are delivered to their intended recipients. In the next section, we’ll take a closer look at PHP’s email sending methods, how they work, and the issues they may face.

PHP built-in email sending methods

In PHP, we have 2 different methods to send emails to our system users.

These methods are.

• By using PHP packages, we will see in the next section.

• Use built-in methods.

In this section, we will use PHP's mail() method to send emails to our users. We will then proceed to check whether these emails were delivered or failed.

The general structure of mail() is as follows.

// the mail method in PHP for sending emails
mail(
    // recipient email
    string $to,
    // the email subject
    string $subject,
    // the email body
    string $message,
    //any other additional settings
    array|string $additional_headers = [],
    string $additional_params = ""
): bool

The above method receives multiple parameters, which are described below.

$to : This parameter refers to the recipient of the email. This can look like this: . test@section.io

$subject: This refers to the subject of the email, you must ensure that it complies with RFC 2047 - MIME (Multipurpose Internet Mail Extensions).

$message: This is the body of your email. We need to make sure each line is separated by CRLF (\r\n). The number of lines should not be greater than 70 characters, otherwise the email will not be sent.

$additional_headers (optional)- This is an array parameter that ensures we can add additional information to the email headers. This may include CC, BCC, etc.

Now that we understand the basic functionality of PHP’s mail() method, let’s move on to sending a sample email to some random emails.

<?php
// sending to
$to      = &#39;no-reply@section.io&#39;;
// email subject
$subject = "Section&#39;s Edge as a service";
// additional headers
$headers = array(
    &#39;From&#39; => &#39;test@example.com&#39;,
    &#39;Reply-To&#39; => &#39;test2@example.com&#39;,
    &#39;X-Mailer&#39; => &#39;PHP/&#39; . phpversion()
);
//body template

$message = &#39;
<html>
<head>
  <title>Node.js Deployment</title>
</head>
<body>
  <p>I have a few requests:</p>
  <ol>
    <li>How much is the cost?</li>
    <li>What is the whole procedure of delpoyment</li>
    <li>How are my appplications distributed?</li>
    <li>How flexible is the payment plans?</li>
  </ol>
</body>
</html>
&#39;;

mail($to, $subject, $message, $headers);

In the above code, we are sending a query email to a random email. We have defined the HTML body and added additional parameters such as title.

Note: It is important to remember that to send an email to a user using an HTML body, we must set our header as shown in the image below.

$headers[] = 'MIME-Version: 1.0';
$headers[] = 'Content-type: text/html; charset=iso-8859-1';

Otherwise, our email body will be delivered as HTML. Other issues can arise when our transport protocol encounters incorrect content. At this point, we assume that when this particular code is run, we expect it to run flawlessly.

However, how can we ensure that our emails are delivered to the intended recipients? In the next section, let's use a mail package to send the same email. These packages will help us overcome the limitations of the mail() method, which makes it quite difficult to check whether our mail has been delivered.

PHP Mail Package

A key drawback of the previous email sending method is that it has very limited features or functionality. This is usually a problem faced when you need to send large amounts of mail.

In this section we will look at how to overcome these shortcomings and subsequently analyze whether our emails are reaching their intended recipients.

We will discuss the following packages.

• PHPMailer

• Swift Mailer

• Pear Mail

讓我們繼續(xù)，先從PHPMailer ：PHPMailer是我們上面列出的所有包中最流行的用PHP發(fā)送郵件的包之一。

創(chuàng)建一個(gè)PHP文件mail.php ，并添加以下代碼片段。

<?php
// Import the mailer class
use PHPMailer\PHPMailer\PHPMailer;
require_once &#39;./vendor/autoload.php&#39;;
// create a new mailing object
$mail = new PHPMailer();
// SMTP configuration

$phpmailer = new PHPMailer();
$phpmailer->isSMTP();
$phpmailer->Host = &#39;smtp.mailtrap.io&#39;;
$phpmailer->SMTPAuth = true;
$phpmailer->Port = 2525;
$phpmailer->Username = &#39;cb7xx33e1856xxx5b25xx&#39;;
$phpmailer->Password = &#39;87f63xx87d73e52xxx4xx&#39;;

$mail->setFrom(&#39;no-reply@section.io&#39;, &#39;Node.js Deployment&#39;);
$mail->addAddress(&#39;test@gmail.com&#39;, &#39;Me&#39;);
$mail->Subject = &#39;Thanks for using section.io Edge as a service!&#39;;

// Our HTML setup

$mail->isHTML(TRUE);
$mail->Body = &#39;<html>Hello johndoe, thank you for using our Node.js deployment and distribution platform. Kinldy check the document in the attachment below to review your payments plan.</html>&#39;;
$mail->AltBody = &#39;Success&#39;;
// adding mailing attachment for payment plan
$mail->addAttachment(&#39;//node/paymments.pdf&#39;, &#39;payments.pdf&#39;);
// send the thank you messange
if(!$mail->send()){
    echo &#39;Your message could not be develired, try again later&#39;;
    echo &#39;Error: &#39; . $mail->ErrorInfo;
} else {
    echo &#39;Your message has been sent successfully.&#39;;
}

在上面的代碼中，我們已經(jīng)安裝了PHPMailer包。我們還創(chuàng)建了這個(gè)類的一個(gè)新實(shí)例，$mail 。接下來(lái)，我們已經(jīng)創(chuàng)建了我們的Mailtrap賬戶，并在這里抓取了憑證。

當(dāng)你創(chuàng)建一個(gè)項(xiàng)目時(shí)，確保你將其與PHPMailer 選項(xiàng)集成，如下面的截圖所示。

你會(huì)注意到，我們的截圖省略了用戶名和密碼。這些是自動(dòng)生成的，對(duì)每個(gè)用戶都是不同的。

接下來(lái)，我們?cè)O(shè)置了我們的setFrom() 方法來(lái)接收發(fā)件人的電子郵件和電子郵件標(biāo)題。然后，我們繼續(xù)配置收件人的電子郵件地址和電子郵件的主題。

注意：之前，我們?cè)硎荆覀兛梢詫⒄奶砑訛镠TML，然后適當(dāng)?shù)卦O(shè)置我們的內(nèi)容類型。

在上面的郵件正文中，我們將信息定義為HTML，以便我們能夠定制郵件，滿足我們的要求。然后我們添加替代標(biāo)簽，再最后添加一個(gè)附件。然后，我們使用PHPMailer的$mail->send() 方法來(lái)發(fā)送我們的郵件。我們加入了if 語(yǔ)句來(lái)檢查我們的郵件是否已經(jīng)發(fā)送。

當(dāng)我們的郵件未能送達(dá)時(shí)，我們通過(guò)打印一個(gè)警告信息來(lái)通知用戶，否則就打印一個(gè)成功信息。讓我們繼續(xù)使用SwiftMailer ，實(shí)現(xiàn)同樣的功能，如下所示。

在你的服務(wù)器上創(chuàng)建一個(gè)新的文件swift.php ，并添加以下代碼片段。

<?php
require_once &#39;./vendor/autoload.php&#39;;
 try {
    // start by creating SMTP transport
    $transport = (new Swift_SmtpTransport(&#39;smtp.mailtrap.io&#39;, 2525))
        ->setUsername(&#39;xxxxxxxxx&#39;)
        ->setPassword(&#39;xxxxxxxxx&#39;);

    $swift_mailer = new Swift_Mailer($transport);

    // message creation
    $swift_message = new Swift_Message();

    $swift_message->setSubject(&#39;Hooray! You just deployed your first Node&#39;);

    swift_message->setFrom([&#39;no-reply@section.io&#39; => &#39;Saas&#39;]);
    $messswift_messageage->addTo(&#39;test@gmail.com&#39;,&#39;Test&#39;);

    // Adding email attachment
   $email_attachment = Swift_Attachment::fromPath(&#39;./section/payments.pdf&#39;);

    $swift_message->attach($email_attachment);

    // Set the plain-text part
    $swift_message->setBody(&#39;Hello John Doe, thank you for using the Section Node deployment service&#39;);
     // Set the HTML part
    $swift_message->addPart(&#39;We are glad to welcome you on board&#39;);
     // Send the message
    $res = swift_mailer->send($message);

} catch (Exception $e) {
  echo $e->getMessage();
}

就像PHPMailer一樣，我們首先安裝這個(gè)包，并使用./vendor/autoload.php 路徑導(dǎo)入它。還需要注意的是，根據(jù)你的系統(tǒng)設(shè)置，這個(gè)路徑可能與你的應(yīng)用程序路徑不同。

接下來(lái)，我們將傳輸設(shè)置為使用我們Mailtrap的Swift_SmtpTransport 。拿起你的憑證，按照上面的代碼設(shè)置。按照前面的步驟來(lái)配置你的應(yīng)用程序，使其使用Mailtrap包來(lái)發(fā)送郵件。

現(xiàn)在，我們?nèi)绾沃牢覀兊泥]件已經(jīng)被送達(dá)？這就是我們使用Mailrap的原因。與PHPmail() 方法相比，該軟件包允許我們配置我們的應(yīng)用程序使用mailtrap，這給我們提供了一個(gè)平臺(tái)來(lái)測(cè)試我們的應(yīng)用程序，正如下一節(jié)所討論的。

使用mailtrap測(cè)試電子郵件

登錄你的Mailtrap賬戶，進(jìn)入你的收件箱部分，如以下截圖所示。

接下來(lái)，點(diǎn)擊項(xiàng)目名稱，展開(kāi)你所發(fā)送的郵件。

注意：為了安全起見(jiàn)，上述截圖上的一些功能已被跳過(guò)。

總結(jié)

在這篇文章中，我們已經(jīng)廣泛地討論了PHP郵件方法的基本概念。我們已經(jīng)看到了PHP內(nèi)置的方法mail() 是如何限制我們發(fā)送帶有測(cè)試功能的郵件的，我們已經(jīng)用PHP包克服了這個(gè)問(wèn)題。

作者：DebugUsery

鏈接：https://juejin.cn/post/7167615841398161416

The above is the detailed content of Let's talk about how Mailtrap integrates PHP emails. For more information, please follow other related articles on the PHP Chinese website!