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文件夹,可以查看代码质量;;)