2 /********************************************************************************
3 * banana/protocoleinterface.inc.php : interface for box access
4 * ------------------------
6 * This file is part of the banana distribution
7 * Copyright: See COPYING files that comes with this distribution
8 ********************************************************************************/
10 require_once dirname(__FILE__
) . '/banana.inc.php';
11 require_once dirname(__FILE__
) . '/protocoleinterface.inc.php';
12 require_once dirname(__FILE__
) . '/message.inc.php';
14 class BananaMBox
implements BananaProtocoleInterface
16 private $debug = false
;
17 private $bt = array();
19 private $_lasterrno = 0;
20 private $_lasterror = null
;
22 public function __construct()
24 $this->debug
= Banana
::$debug_mbox;
27 public function isValid()
30 //!Banana::$group || $this->file;
33 /** Indicate last error n°
35 public function lastErrNo()
37 return $this->_lasterrno
;;
40 /** Indicate last error text
42 public function lastError()
44 return $this->_lasterror
;
47 /** Return the description of the current box
49 public function getDescription()
54 /** Return the list of the boxes
55 * @param mode Kind of boxes to list
56 * @param since date of last check (for new boxes and new messages)
57 * @param withstats Indicated whether msgnum and unread must be set in the result
58 * @return Array(boxname => array(desc => boxdescripton, msgnum => number of message, unread =>number of unread messages)
60 public function getBoxList($mode = Banana
::BOXES_ALL
, $since = 0, $withstats = false
)
62 return array(Banana
::$group => array('desc' => '', 'msgnum' => 0, 'unread' => 0));
65 private function &getRawMessage($id)
68 if (!is_numeric($id)) {
69 if (!Banana
::$spool) {
72 $id = Banana
::$spool->ids
[$id];
74 $options = array ('-m ' . $id);
75 if (Banana
::$spool->overview
) {
76 if (Banana
::$spool->overview
[$id]) {
77 $options[] = '-p ' . $id . ':' . Banana
::$spool->overview
[$id]->storage
['offset'];
79 $key = max(array_keys(Banana
::$spool->overview
));
81 $options[] = '-p ' . $key . ':' . Banana
::$spool->overview
[$key]->storage
['offset'];
85 return $this->callHelper('-b', $options);
89 * @param id Id of the emssage (can be either an Message-id or a message index)
90 * @return A BananaMessage or null if the given id can't be retreived
92 public function &getMessage($id)
94 $messages =& $this->getRawMessage($id);
96 $messages = new BananaMessage($messages);
101 /** Return the sources of the given message
103 public function getMessageSource($id)
105 $message =& $this->getRawMessage($id);
107 $message = implode("\n", $message);
112 /** Compute the number of messages of the box
114 private function getCount()
117 if (Banana
::$spool->overview
) {
118 $key = max(array_keys(Banana
::$spool->overview
));
119 $options[] = '-p ' . $key . ':' . Banana
::$spool->overview
[$key]->storage
['offset'];
121 $val =& $this->callHelper('-c', $options);
125 return intval(trim($val[0]));
128 /** Return the indexes of the messages presents in the Box
129 * @return Array(number of messages, MSGNUM of the first message, MSGNUM of the last message)
131 public function getIndexes()
133 $count = $this->getCount();
134 return array($count, 0, $count - 1);
137 /** Return the message headers (in BananaMessage) for messages from firstid to lastid
138 * @return Array(id => array(headername => headervalue))
140 public function &getMessageHeaders($firstid, $lastid, array $msg_headers = array())
144 $options[] = "-m $firstid:$lastid";
145 if (Banana
::$spool->overview
) {
146 if (isset(Banana
::$spool->overview
[$firstid])) {
147 $options[] = '-p ' . $firstid . ':' . Banana
::$spool->overview
[$firstid]->storage
['offset'];
149 $key = max(array_keys(Banana
::$spool->overview
));
150 if ($key < $firstid) {
151 $options[] = '-p ' . $key . ':' . Banana
::$spool->overview
[$key]->storage
['offset'];
155 $lines =& $this->callHelper('-d', $options, $msg_headers);
161 $id = array_shift($lines);
165 $offset = array_shift($lines);
166 if ($offset === '') {
170 $headers[$id] = array('beginning' => intval($offset));
172 $hname = array_shift($lines);
176 $hval = array_shift($lines);
180 if ($hname == 'date') {
181 $headers[$id][$hname] = @strtotime
($hval);
183 $headers[$id][$hname] = $hval;
186 if (!isset($headers[$id]['date'])) {
189 print_r($headers[$id]);
192 array_walk_recursive($headers, array('BananaMimePart', 'decodeHeader'));
196 /** Add storage data in spool overview
198 public function updateSpool(array &$messages)
200 foreach ($messages as $id=>&$data) {
201 if (isset(Banana
::$spool->overview
[$id])) {
202 Banana
::$spool->overview
[$id]->storage
['offset'] = $data['beginning'];
207 /** Return the indexes of the new messages since the give date
208 * @return Array(MSGNUM of new messages)
210 public function getNewIndexes($since)
213 if (is_null($this->file
)) {
216 if (is_null($this->new_messages
)) {
219 return range($this->count
- $this->new_messages
, $this->count
- 1);
222 /** Return wether or not the protocole can be used to add new messages
224 public function canSend()
229 /** Return false because we can't cancel a mail
231 public function canCancel()
236 /** Return the list of requested headers
237 * @return Array('header1', 'header2', ...) with the key 'dest' for the destination header
238 * and 'reply' for the reply header, eg:
239 * * for a mail: Array('From', 'Subject', 'dest' => 'To', 'Cc', 'Bcc', 'reply' => 'Reply-To')
240 * * for a post: Array('From', 'Subject', 'dest' => 'Newsgroups', 'reply' => 'Followup-To')
242 public function requestedHeaders()
244 return Array('From', 'Subject', 'dest' => 'To', 'Cc', 'Bcc', 'reply' => 'Reply-To');
248 * @return true if it was successfull
250 public function send(BananaMessage
&$message)
252 $headers = $message->getHeaders();
253 $to = $headers['To'];
254 $subject = $headers['Subject'];
255 unset($headers['To']);
256 unset($headers['Subject']);
258 foreach ($headers as $key=>$value) {
259 if (!empty($value)) {
260 $hdrs .= "$key: $value\r\n";
263 $body = $message->get(false
);
264 return mail($to, $subject, $body, $hdrs);
268 * @return true if it was successfull
270 public function cancel(BananaMessage
&$message)
275 /** Return the protocole name
277 public function name()
282 /** Return the spool filename
284 public function filename()
286 @list
($mail, $domain) = explode('@', Banana
::$group);
288 if (isset($domain)) {
289 $file = $domain . '_';
291 return $file . $mail;
294 /** Return the execution backtrace
296 public function backtrace()
306 # Filesystem functions
309 protected function getFileName()
311 if (is_null(Banana
::$group)) {
314 @list
($mail, $domain) = explode('@', Banana
::$group);
315 return Banana
::$mbox_path . '/' . $mail;
322 private function &callHelper($action, array $options = array(), array $headers = array())
324 $action .= ' -f ' . $this->getFileName();
325 $cmd = Banana
::$mbox_helper . " $action " . implode(' ', $options) . ' ' . implode(' ', $headers);
327 $start = microtime(true
);
329 exec($cmd, $out, $return);
331 $this->bt
[] = array('action' => $cmd, 'time' => (microtime(true
) - $start),
332 'code' => $return, 'response' => count($out));
335 $this->_lasterrorno
= 1;
336 $this->_lasterrorcode
= "Helper failed";
343 // vim:set et sw=4 sts=4 ts=4 enc=utf-8: