1: <?php
 2: /**
 3:  * Null implementation of the mail transport interface.
 4:  *
 5:  * LICENSE:
 6:  *
 7:  * Copyright (c) 2010 Phil Kernick
 8:  * All rights reserved.
 9:  *
10:  * Redistribution and use in source and binary forms, with or without
11:  * modification, are permitted provided that the following conditions
12:  * are met:
13:  *
14:  * o Redistributions of source code must retain the above copyright
15:  *   notice, this list of conditions and the following disclaimer.
16:  * o Redistributions in binary form must reproduce the above copyright
17:  *   notice, this list of conditions and the following disclaimer in the
18:  *   documentation and/or other materials provided with the distribution.
19:  * o The names of the authors may not be used to endorse or promote
20:  *   products derived from this software without specific prior written
21:  *   permission.
22:  *
23:  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
24:  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
25:  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
26:  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
27:  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
28:  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
29:  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
30:  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
31:  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
32:  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
33:  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
34:  *
35:  * @category    Horde
36:  * @package     Mail
37:  * @author      Phil Kernick <philk@rotfl.com.au>
38:  * @copyright   2010 Phil Kernick
39:  * @license     http://www.horde.org/licenses/bsd New BSD License
40:  */
41: 
42: /**
43:  * Null implementation of the mail transport interface.
44:  *
45:  * @category Horde
46:  * @package  Mail
47:  */
48: class Horde_Mail_Transport_Null extends Horde_Mail_Transport
49: {
50:     /**
51:      * Send a message.
52:      *
53:      * @param mixed $recipients  Either a comma-seperated list of recipients
54:      *                           (RFC822 compliant), or an array of
55:      *                           recipients, each RFC822 valid. This may
56:      *                           contain recipients not specified in the
57:      *                           headers, for Bcc:, resending messages, etc.
58:      * @param array $headers     The headers to send with the mail, in an
59:      *                           associative array, where the array key is the
60:      *                           header name (ie, 'Subject'), and the array
61:      *                           value is the header value (ie, 'test'). The
62:      *                           header produced from those values would be
63:      *                           'Subject: test'.
64:      *                           If the '_raw' key exists, the value of this
65:      *                           key will be used as the exact text for
66:      *                           sending the message.
67:      * @param mixed $body        The full text of the message body, including
68:      *                           any Mime parts, etc. Either a string or a
69:      *                           stream resource.
70:      *
71:      * @throws Horde_Mail_Exception
72:      */
73:     public function send($recipients, array $headers, $body)
74:     {
75:     }
76: }
77: