Fix two typos "squirrelmai" -> "squirrelmail". Sheesh.
[squirrelmail.git] / functions / imap_asearch.php
index a4eeb6a5d0195f0cede9c4b31ed403cedf5cd566..f3dc5676533690801f0fde3ee4e1309ff2109bae 100644 (file)
@@ -7,15 +7,17 @@
  * Licensed under the GNU GPL. For full terms see the file COPYING.
  *
  * IMAP asearch routines
- * Alex Lemaresquier - Brainstorm - alex at brainstorm.fr
+ * @author Alex Lemaresquier - Brainstorm - alex at brainstorm.fr
  * See README file for infos.
+ * @package squirrelmail
  *
  */
 
-require_once(SM_PATH . 'functions/imap.php');
+/** This functionality requires the IMAP and date functions */
+require_once(SM_PATH . 'functions/imap_general.php');
 require_once(SM_PATH . 'functions/date.php');
 
-/* Set to TRUE to dump the imap dialogue */
+/** Set to TRUE to dump the imap dialogue */
 $imap_asearch_debug_dump = FALSE;
 
 $imap_asearch_opcodes = array(
@@ -72,6 +74,40 @@ $imap_asearch_months = array(
        '12' => 'dec'
 );
 
+$imap_error_titles = array(
+       'OK' => '',
+       'NO' => _("ERROR : Could not complete request."),
+       'BAD' => _("ERROR : Bad or malformed request."),
+       'BYE' => _("ERROR : Imap server closed the connection.")
+);
+
+function sqimap_asearch_error_box($response, $query, $message)
+{
+       global $imap_error_titles;
+
+       //if (!array_key_exists($response, $imap_error_titles)) //php 4.0.6 compatibility
+       if (!in_array($response, array_keys($imap_error_titles)))
+               $title = _("ERROR : Unknown imap response.");
+       else
+               $title = $imap_error_titles[$response];
+       $message_title = _("Reason Given: ");
+       if (function_exists('sqimap_error_box'))
+               sqimap_error_box($title, $query, $message_title, $message);
+       else {  //Straight copy of 1.5 imap_general.php:sqimap_error_box(). Can be removed at a later time
+               global $color;
+    require_once(SM_PATH . 'functions/display_messages.php');
+    $string = "<font color=$color[2]><b>\n" . $title . "</b><br>\n";
+    if ($query != '')
+        $string .= _("Query:") . ' ' . htmlspecialchars($query) . '<br>';
+    if ($message_title != '')
+        $string .= $message_title;
+    if ($message != '')
+        $string .= htmlspecialchars($message);
+    $string .= "</font><br>\n";
+    error_box($string,$color);
+       }
+}
+
 /* This is to avoid the E_NOTICE warnings signaled by marc AT squirrelmail.org. Thanks Marc! */
 function asearch_nz(&$var)
 {
@@ -80,7 +116,7 @@ function asearch_nz(&$var)
        return '';
 }
 
-/* This should give the same results as PHP 4 >= 4.3.0's html_entity_decode() */
+/* This should give the same results as PHP 4 >= 4.3.0's html_entity_decode(), except it doesn't handle hex constructs */
 function asearch_unhtmlentities($string) {
        $trans_tbl = array_flip(get_html_translation_table(HTML_ENTITIES));
        for ($i=127; $i<255; $i++)      /* Add &#<dec>; entities */
@@ -92,47 +128,51 @@ function asearch_unhtmlentities($string) {
 */
 }
 
-function s_dump($var_name, $var_var, $compact = FALSE)
-{
-       if (!$compact)
-               echo '<PRE>';
-       echo htmlentities($var_name) . '=';
-       print_r($var_var);
-       if ($compact)
-               echo "<BR>\n";
-       else
-               echo "</PRE>\n";
-}
-
-function s_debug_dump($var_name, $var_var, $compact = FALSE)
+function s_debug_dump($var_name, $var_var)
 {
        global $imap_asearch_debug_dump;
-       if ($imap_asearch_debug_dump)
-               s_dump($var_name, $var_var, $compact);
+       if ($imap_asearch_debug_dump) {
+               if (function_exists('sm_print_r'))      //Only exists since 1.4.2
+                       sm_print_r($var_name, $var_var);        //Better be the 'varargs' version ;)
+               else {
+                       echo '<pre>';
+                       echo htmlentities($var_name);
+                       print_r($var_var);
+                       echo '</pre>';
+               }
+       }
 }
 
-function sqimap_asearch_encode_string($what, $search_charset)
+/*
+4.3 String:
+       A quoted string is a sequence of zero or more 7-bit characters,
+        excluding CR and LF, with double quote (<">) characters at each end.
+9. Formal Syntax:
+       quoted-specials = DQUOTE / "\"
+*/
+function sqimap_asearch_encode_string($what, $charset)
 {
-       if (strtoupper($search_charset) == 'ISO-2022-JP')
+       if (strtoupper($charset) == 'ISO-2022-JP')      // This should be now handled in imap_utf7_local?
                $what = mb_convert_encoding($what, 'JIS', 'auto');
-       if (strpos($what,'"') > -1)
-               return '{' . strlen($what) . "}\r\n" . $what;   /* 4.3 literal form */
-       return '"' . $what . '"';       /* 4.3 quoted string form */
+//if (ereg("[\"\\\r\n\x80-\xff]", $what))
+       if (preg_match('/["\\\\\r\n\x80-\xff]/', $what))
+               return '{' . strlen($what) . "}\r\n" . $what;   // 4.3 literal form
+       return '"' . $what . '"';       // 4.3 quoted string form
 }
 
 /*
  Parses a user date string into an rfc2060 date string (<day number>-<US month TLA>-<4 digit year>)
  Returns a preg_match-style array: [0]: fully formatted date, [1]: day, [2]: month, [3]: year
- Handles space, slash, dot and comma as separators (and dash of course ;=)
+ Handles space, slash, backslash, dot and comma as separators (and dash of course ;=)
 */
 function sqimap_asearch_parse_date($what)
 {
        global $imap_asearch_months;
 
        $what = trim($what);
-       $what = ereg_replace('[ :,:/:.]+', '-', $what);
+       $what = ereg_replace('[ /\\.,]+', '-', $what);
        if ($what) {
-               preg_match('/^([0-9]+)-([^\-]+)-([0-9]+)$/', $what, $what_parts);
+               preg_match('/^([0-9]+)-+([^\-]+)-+([0-9]+)$/', $what, $what_parts);
                if (count($what_parts) == 4) {
                        $what_month = strtolower(asearch_unhtmlentities($what_parts[2]));
 /*             if (!in_array($what_month, $imap_asearch_months)) {*/
@@ -155,10 +195,11 @@ function sqimap_asearch_parse_date($what)
        return $what_parts;
 }
 
-function sqimap_asearch_build_criteria($opcode, $what, $search_charset)
+function sqimap_asearch_build_criteria($opcode, $what, $charset)
 {
        global $imap_asearch_opcodes;
 
+       $criteria = '';
        switch ($imap_asearch_opcodes[$opcode]) {
                default:
                case 'anum':
@@ -174,17 +215,17 @@ function sqimap_asearch_build_criteria($opcode, $what, $search_charset)
                        preg_match('/^([^:]+):(.*)$/', $what, $what_parts);
                        if (count($what_parts) == 3)
                                $criteria = $opcode . ' ' . 
-                                       sqimap_asearch_encode_string($what_parts[1], $search_charset) . ' ' .
-                                       sqimap_asearch_encode_string($what_parts[2], $search_charset) . ' ';
+                                       sqimap_asearch_encode_string($what_parts[1], $charset) . ' ' .
+                                       sqimap_asearch_encode_string($what_parts[2], $charset) . ' ';
                break;
                case 'adate':
                        $what_parts = sqimap_asearch_parse_date($what);
-                       if ($what_parts[0] != '')
+                       if (isset($what_parts[0]))
                                $criteria = $opcode . ' ' . $what_parts[0] . ' ';
                break;
                case 'akeyword':
                case 'astring':
-                       $criteria = $opcode . ' ' . sqimap_asearch_encode_string($what, $search_charset) . ' ';
+                       $criteria = $opcode . ' ' . sqimap_asearch_encode_string($what, $charset) . ' ';
                break;
                case 'asequence':
                        $what = ereg_replace('[^0-9:\(\)]+', '', $what);
@@ -197,48 +238,53 @@ function sqimap_asearch_build_criteria($opcode, $what, $search_charset)
 
 function sqimap_run_search($imapConnection, $search_string, $search_charset)
 {
-       global $allow_charset_search, $uid_support;
+       global $uid_support;
 
        /* 6.4.4 try OPTIONAL [CHARSET] specification first */
-       if ($allow_charset_search && (!empty($search_charset)))
-               $ss = 'SEARCH CHARSET ' . strtoupper($search_charset) . ' ALL ' . $search_string;
+       if ($search_charset != '')
+               $query = 'SEARCH CHARSET "' . strtoupper($search_charset) . '" ALL ' . $search_string;
        else
-               $ss = 'SEARCH ALL ' . $search_string;
-       s_debug_dump('O', $ss);
+               $query = 'SEARCH ALL ' . $search_string;
+       s_debug_dump('C:', $query);
+       $readin = sqimap_run_command($imapConnection, $query, false, $response, $message, $uid_support);
 
-       /* read data back from IMAP */
-       $readin = sqimap_run_command($imapConnection, $ss, false, $result, $message, $uid_support);
-
-       /* 6.4.4 try US-ASCII charset if we receive a tagged NO response */
-       if (!empty($charset)  && strtolower($result) == 'no') {
-               $ss = 'SEARCH CHARSET "US-ASCII" ALL ' . $search_string;
-               s_debug_dump('O', $ss);
-               $readin = sqimap_run_command ($imapConnection, $ss, true, $result, $message);   /* no $uid_support? */
+       /* 6.4.4 try US-ASCII charset if we tried an OPTIONAL [CHARSET] and received a tagged NO response (SHOULD be [BADCHARSET]) */
+       if (($search_charset != '')  && (strtoupper($response) == 'NO')) {
+               $query = 'SEARCH CHARSET US-ASCII ALL ' . $search_string;
+               s_debug_dump('C:', $query);
+               $readin = sqimap_run_command($imapConnection, $query, false, $response, $message, $uid_support);
+       }
+       if (strtoupper($response) != 'OK') {
+               sqimap_asearch_error_box($response, $query, $message);
+               return array();
        }
 
        unset($messagelist);
 
        /* Keep going till we find the SEARCH response */
        foreach ($readin as $readin_part) {
-               s_debug_dump('I', $readin_part);
+               s_debug_dump('S:', $readin_part);
                /* Check to see if a SEARCH response was received */
                if (substr($readin_part, 0, 9) == '* SEARCH ') {
                        $messagelist = preg_split("/ /", substr($readin_part, 9));
-               } else if (isset($errors)) {
-                       $errors = $errors . $readin_part;
-               } else {
-                       $errors = $readin_part;
+                       break;  // Should be the last anyway
                }
+/*     else {
+                       if (isset($errors))
+                               $errors = $errors . $readin_part;
+                       else
+                               $errors = $readin_part;
+               }*/
        }
 
        /* If nothing is found * SEARCH should be the first error else echo errors */
-       if (isset($errors)) {
+/*if (isset($errors)) {
                if (strstr($errors,'* SEARCH'))
                        return array();
                echo '<!-- ' . htmlspecialchars($errors) . ' -->';
-       }
+       }*/
 
-       if (empty($messagelist))
+       if (empty($messagelist))        //Empty search response, ie '* SEARCH'
                return array();
 
        $cnt = count($messagelist);
@@ -247,6 +293,15 @@ function sqimap_run_search($imapConnection, $search_string, $search_charset)
        return $id;
 }
 
+function sqimap_asearch_get_charset()
+{
+       global $allow_charset_search, $languages, $squirrelmail_language;
+
+       if ($allow_charset_search)
+               return $languages[$squirrelmail_language]['CHARSET'];
+       return '';
+}
+
 /* replaces $mbox_msgs[$search_mailbox] = array_values(array_unique(array_merge($mbox_msgs[$search_mailbox], sqimap_run_search($imapConnection, $search_string, $search_charset))));*/
 function sqimap_array_merge_unique($to, $from)
 {
@@ -261,13 +316,8 @@ function sqimap_array_merge_unique($to, $from)
 
 function sqimap_asearch($imapConnection, $mailbox_array, $biop_array, $unop_array, $where_array, $what_array, $exclude_array, $mboxes_array)
 {
-       global $languages, $squirrelmail_language;
-
-/* ??? what are those for ?? */
-/*     $pos = $search_position;*/
-
+       $search_charset = sqimap_asearch_get_charset();
        $mbox_msgs = array();
-       $search_charset = $languages[$squirrelmail_language]['CHARSET'];
        $search_string = '';
        $cur_mailbox = $mailbox_array[0];
        $cur_biop = ''; /* Start with ALL */
@@ -282,8 +332,8 @@ function sqimap_asearch($imapConnection, $mailbox_array, $biop_array, $unop_arra
                                else
                                        $search_mboxes = array($cur_mailbox);
                                foreach ($search_mboxes as $cur_mailbox) {
+                                       s_debug_dump('C:SELECT:', $cur_mailbox);
                                        sqimap_mailbox_select($imapConnection, $cur_mailbox);
-                                       s_debug_dump('SELECT',$cur_mailbox);
                                        if (isset($mbox_msgs[$cur_mailbox])) {
                                                if ($cur_biop == 'OR')  /* Merge with previous results */
                                                        $mbox_msgs[$cur_mailbox] = sqimap_array_merge_unique($mbox_msgs[$cur_mailbox], sqimap_run_search($imapConnection, $search_string, $search_charset));
@@ -324,4 +374,4 @@ function sqimap_asearch($imapConnection, $mailbox_array, $biop_array, $unop_arra
        return $mbox_msgs;
 }
 
-?>
\ No newline at end of file
+?>