cogitium/ cogimail
一个简单的PHP类,用于发送带有附件的电子邮件到不同的地址
1.0.4
2016-12-02 16:22 UTC
This package is not auto-updated.
Last update: 2024-09-23 13:26:09 UTC
README
类功能
- PHP发送电子邮件的简单代码
- 发送带有多个TO、CC、BCC的电子邮件
- 发送带有个人信息和特定REPLY-TO的电子邮件
- 适用于不支持HTML电子邮件的邮件客户端的多部分/替代电子邮件
- 可以将多个文件附加到电子邮件中
- 错误消息仅以英语显示
- 如果出现问题,则生成异常
- 与PHP 5.0及更高版本兼容
你可能需要它的原因
许多PHP开发者在他们的代码中使用电子邮件。支持此功能的唯一PHP函数是mail()
函数。然而,它不提供任何用于利用HTML电子邮件和附件等流行功能的辅助。
正确格式化电子邮件出奇地困难。存在许多重叠的RFC,需要严格遵守复杂难懂的格式化和编码规则 - 在网上找到的绝大多数直接使用mail()
函数的代码都是错误的。请不要被诱惑自己去做这件事 - 如果你不使用CogiMail,在开始自己编写之前,你应该查看许多其他优秀的库 - 尝试PhpMailer、SwiftMailer、Zend_Mail、eZcomponents等。
在本版本中,您需要有一个SMTP本地服务器才能使用该组件。
许可协议
即将推出。
安装与加载
目前,您只需将类文件复制到您想要的文件夹中。
包含内容
在下载中,您将找到以下目录和文件。您将看到如下内容
cogimail/
├── bat/
│ ├── checkstyle.bat
│ ├── phpdoc.bat
├── class/
│ └── CogiMail.class.js
├── doc/
│ ├── ...
│ └── index.html
├── psr/
│ ├── ...
│ └── index.html
└── test/
├── testCogiMail.php
├── image1.jpg
├── image2.gif
├── image3.png
├── image4.jpeg
├── fichier1.pdf
└── fichier2.doc
一个简单示例
<?php
require_once("../class/CogiMail.class.php");
try {
/**
* Initialize the email and the sender detail
*/
$mail = new CogiMail("sender@mail.com","Sender Name","replyto@mail.com");
/**
* Use the setters
*/
$mail->addRecipientEmail('recipient1@mail.com');
$mail->addRecipientEmail('recipient2@mail.com');
$mail->addBccRecipientMail('bcc_recipient1@mail.com');
$mail->addBccRecipientMail('bcc_recipient2@mail.com');
$mail->addFile('file1.jpg');
$mail->addFile('file2.gif');
$mail->addFile('file3.png');
$mail->addFile('file4.jpeg');
$mail->addFile('file5.pdf');
$mail->addFile('file6.doc');
/**
* Initialize the content
*/
$mailObject = 'Object of the email';
$plainTextContent = 'Example,'."\n\n".'With only plain text';
$htmlContent = '<html>
<body>
<h1>Example</h1>
<p>
A text with a
<strong>HTML</strong>
content
</p>
</body>
</html>';
$mail->contentMail($mailObject, $plainTextContent, $htmlContent);
/**
* Send the mail
*/
$mail->sendMail();
echo "<p>Very good, the email was sent !</p>";
$mail->debug();
} catch(Exception $e) {
echo '<p>Exception' . $e->getMessage() . '</p>';
$mail->debug();
}
?>
就是这样。现在您应该已经准备好使用CogiMail了!
本地化
目前只提供英语。
文档
完整的文档在doc文件夹中。
测试
在test文件夹中有一个测试页面,可以尝试该组件。
贡献
请通过电子邮件Philippe发送您的想法或评论。
变更日志
请参阅变更日志。
历史
- 最初,CogiMail是一个PHP库中的过程式函数。
- 然后,这个函数变成了一个类。
- 现在,CogiMail在BitBucket仓库中。
- 包含README和一个PhpDocumentor文件夹。
- 更有甚者,还有一个PSR文件夹,可以查看代码质量;;)