cvs: pear /Mail package.xml /Mail/Mail null.php

chagenbu Wed Nov 12 22:49:39 2003 EDT Added files: /pear/Mail/Mail null.php Modified files: /pear/Mail package.xml Log: Add a 'null' driver to the Mail:: package, allowing easy discarding of mail just by changing a config setting. Submitted by Phil Kernick <philk@rotfl.com.au>. Index: pear/Mail/package.xml diff -u pear/Mail/package.xml:1.11 pear/Mail/package.xml:1.12 --- pear/Mail/package.xml:1.11 Fri Sep 5 02:21:12 2003 +++ pear/Mail/package.xml Wed Nov 12 22:49:38 2003 @@ -41,6 +41,7 @@ <file name="Mail.php"/> <dir name="Mail"> <file name="mail.php"/> + <file name="null.php"/> <file name="sendmail.php"/> <file name="smtp.php"/> <file name="RFC822.php"/> Index: pear/Mail/Mail/null.php +++ pear/Mail/Mail/null.php <?php // // +----------------------------------------------------------------------+ // | PHP Version 4 | // +----------------------------------------------------------------------+ // | Copyright (c) 1997-2003 The PHP Group | // +----------------------------------------------------------------------+ // | This source file is subject to version 2.02 of the PHP license, | // | that is bundled with this package in the file LICENSE, and is | // | available at through the world-wide-web at | // | http://www.php.net/license/2_02.txt. | // | If you did not receive a copy of the PHP license and are unable to | // | obtain it through the world-wide-web, please send a note to | // | license@php.net so we can mail you a copy immediately. | // +----------------------------------------------------------------------+ // | Author: Phil Kernick <philk@rotfl.com.au> | // +----------------------------------------------------------------------+ // // $Id: null.php,v 1.1 2003/11/13 03:49:39 chagenbu Exp $ // require_once 'Mail.php'; /** * Null implementation of the PEAR Mail:: interface. * @access public * @package Mail * @version $Revision: 1.1 $ */ class Mail_null extends Mail { /** * Implements Mail_null::send() function. Silently discards all * mail. * * @param mixed $recipients Either a comma-seperated list of recipients * (RFC822 compliant), or an array of recipients, * each RFC822 valid. This may contain recipients not * specified in the headers, for Bcc:, resending * messages, etc. * * @param array $headers The array of headers to send with the mail, in an * associative array, where the array key is the * header name (ie, 'Subject'), and the array value * is the header value (ie, 'test'). The header * produced from those values would be 'Subject: * test'. * * @param string $body The full text of the message body, including any * Mime parts, etc. * * @return mixed Returns true on success, or a PEAR_Error * containing a descriptive error message on * failure. * @access public */ function send($recipients, $headers, $body) { return true; } }