theoafactor/messenger

处理向用户发送电子邮件消息

v1.2.0 2022-03-06 02:03 UTC

This package is auto-updated.

Last update: 2024-09-06 07:12:52 UTC


README

电子邮件和消息发送器。

  1. 轻松向用户发送电子邮件

  2. 添加项目

	composer require theoafactor/messenger
  1. 在项目顶部添加以下行
require "vendor/autoload.php";

use Messenger\Messenger;
  1. 创建Messenger类的实例
	$messeger = new Messenger();
  1. 发送您的电子邮件。
	$messenger->sendMessage('recepient@email.com', 'Message Subject', $extra_data_array, "email_template.html");
  1. sendMessage()方法接受以下参数

    • 收件人电子邮件地址
    • 电子邮件主题
    • 关联数组形式的额外数据
    • 要使用的电子邮件模板的文件路径
  2. 所有参数中,收件人电子邮件地址和电子邮件主题是必填的,而其他参数则不是。但设置这些参数是个好习惯。

设置环境值

  1. 您应该在项目的根目录中使用.env文件设置环境值。请使用.env.example文件作为示例。

  2. 创建一个.env文件,并将theoafactor/messenger/src目录中的.env.example文件中的样本复制过来。

  3. 提供数据。

使用电子邮件模板

  1. 该软件包使用微型模板引擎。该引擎将在目录的根目录中查找您的电子邮件模板。

  2. 变量在模板中使用{{ variable_name }}输出。

  3. 变量数据来自传递给sendMessage()方法的额外数据关联数组。例如,在下面的代码中,我们将额外的数据关联数组设置具有firstname和lastname键。

	$userData = [

		"firstname" => "James",
		"lastname"  => "John"

	];

  1. 在电子邮件模板中,我们可以通过以下方式引用firstname键

    	<body>
    
    		<h2>Welcome {{ firstname }}</h2>
    
    	</body>
    
    

循环

  1. 此软件包使用基本循环机制,仅支持foreach循环。要在模板中循环数组,请遵循以下示例
	@foreach(arrayKey as item)
		{{ item }}
	@endforeach
  1. 请注意,arrayKey来自传递给sendMessage()方法的数据。

  2. 尚未添加嵌套循环支持。

  3. 尚未添加条件语句支持。

注意

  1. 此项目正在积极开发中。您可以使用它来构建项目。您也可以通过创建pull request来为此项目做出贡献。

  2. 请一发现任何安全问题立即报告。

作者:Olu Adeyemo [theoafactor@gmail.com]