functions/url_parser.php

   1 <?php
   2
   3 /**
   4  * url_parser.php
   5  *
   6  * This code provides various string manipulation functions that are
   7  * used by the rest of the SquirrelMail code.
   8  *
   9  * @copyright &copy; 1999-2005 The SquirrelMail Project Team
  10  * @license http://opensource.org/licenses/gpl-license.php GNU Public License
  11  * @version $Id$
  12  * @package squirrelmail
  13  */
  14
  15 /**
  16  * Undocumented - complain, then patch.
  17  */
  18 function replaceBlock (&$in, $replace, $start, $end) {
  19     $begin = substr($in,0,$start);
  20     $end   = substr($in,$end,strlen($in)-$end);
  21     $in    = $begin.$replace.$end;
  22 }
  23
  24 /* Having this defined in just one spot could help when changes need
  25  * to be made to the pattern
  26  * Make sure that the expression is evaluated case insensitively
  27  *
  28  * RFC2822 (and RFC822) defines the left side of an email address as (roughly):
  29  *  1*atext *("." 1*atext)
  30  * where atext is: a-zA-Z0-9!#$%&'*+-/=?^_`{|}~
  31  *
  32  * Here's pretty sophisticated IP matching:
  33  * $IPMatch = '(2[0-5][0-9]|1?[0-9]{1,2})';
  34  * $IPMatch = '\[?' . $IPMatch . '(\.' . $IPMatch . '){3}\]?';
  35  */
  36 /* Here's enough: */
  37 global $IP_RegExp_Match, $Host_RegExp_Match, $Email_RegExp_Match;
  38 $IP_RegExp_Match = '\\[?[0-9]{1,3}(\\.[0-9]{1,3}){3}\\]?';
  39 $Host_RegExp_Match = '(' . $IP_RegExp_Match .
  40     '|[0-9a-z]([-.]?[0-9a-z])*\\.[a-z][a-z]+)';
  41 $atext = '([a-z0-9!#$&%*+/=?^_`{|}~-]|&amp;)';
  42 $dot_atom = $atext . '+(\.' . $atext . '+)*';
  43 $Email_RegExp_Match = $dot_atom . '(%' . $Host_RegExp_Match . ')?@' .
  44                       $Host_RegExp_Match;
  45
  46 /**
  47  * Parses a body and converts all found email addresses to clickable links.
  48  *
  49  * @param string body the body to process, by ref
  50  * @return int the number of unique addresses found
  51  */
  52 function parseEmail (&$body) {
  53     global $Email_RegExp_Match;
  54     $sbody     = $body;
  55     $addresses = array();
  56
  57     /* Find all the email addresses in the body */
  58     while(eregi($Email_RegExp_Match, $sbody, $regs)) {
  59         $addresses[$regs[0]] = strtr($regs[0], array('&amp;' => '&'));
  60         $start = strpos($sbody, $regs[0]) + strlen($regs[0]);
  61         $sbody = substr($sbody, $start);
  62     }
  63
  64     /* Replace each email address with a compose URL */
  65     foreach ($addresses as $text => $email) {
  66         $comp_uri = makeComposeLink('src/compose.php?send_to='.urlencode($email), $text);
  67         $body = str_replace($text, $comp_uri, $body);
  68     }
  69
  70     /* Return number of unique addresses found */
  71     return count($addresses);
  72 }
  73
  74
  75 /* We don't want to re-initialize this stuff for every line.  Save work
  76  * and just do it once here.
  77  */
  78 global $url_parser_url_tokens;
  79 $url_parser_url_tokens = array(
  80     'http://',
  81     'https://',
  82     'ftp://',
  83     'telnet:',  // Special case -- doesn't need the slashes
  84     'mailto:',  // Special case -- doesn't use the slashes
  85     'gopher://',
  86     'news://');
  87
  88 global $url_parser_poss_ends;
  89 $url_parser_poss_ends = array(' ', "\n", "\r", '<', '>', ".\r", ".\n",
  90     '.&nbsp;', '&nbsp;', ')', '(', '&quot;', '&lt;', '&gt;', '.<',
  91     ']', '[', '{', '}', "\240", ', ', '. ', ",\n", ",\r");
  92
  93
  94 /**
  95  * rfc 2368 (mailto URL) preg_match() regexp
  96  * @link http://www.ietf.org/rfc/rfc2368.txt
  97  * @global string MailTo_PReg_Match the encapsulated regexp for preg_match()
  98  */
  99 global $MailTo_PReg_Match;
 100 $Mailto_Email_RegExp = '[0-9a-z%]([-_.+%]?[0-9a-z])*(%' . $Host_RegExp_Match . ')?@' . $Host_RegExp_Match;
 101 $MailTo_PReg_Match = '/((?:' . $Mailto_Email_RegExp . ')*)((?:\?(?:to|cc|bcc|subject|body)=[^\s\?&=,()]+)?(?:&amp;(?:to|cc|bcc|subject|body)=[^\s\?&=,()]+)*)/i';
 102
 103 /**
 104  * Parses a body and converts all found URLs to clickable links.
 105  *
 106  * @param string body the body to process, by ref
 107  * @return void
 108  */
 109 function parseUrl (&$body) {
 110     global $url_parser_poss_ends, $url_parser_url_tokens;
 111     $start      = 0;
 112     $blength    = strlen($body);
 113
 114     while ($start < $blength) {
 115         $target_token = '';
 116         $target_pos = $blength;
 117
 118         /* Find the first token to replace */
 119         foreach ($url_parser_url_tokens as $the_token) {
 120             $pos = strpos(strtolower($body), $the_token, $start);
 121             if (is_int($pos) && $pos < $target_pos) {
 122                 $target_pos   = $pos;
 123                 $target_token = $the_token;
 124             }
 125         }
 126
 127         /* Look for email addresses between $start and $target_pos */
 128         $check_str = substr($body, $start, $target_pos-$start);
 129
 130         if (parseEmail($check_str)) {
 131             replaceBlock($body, $check_str, $start, $target_pos);
 132             $blength    = strlen($body);
 133             $target_pos = strlen($check_str) + $start;
 134         }
 135
 136         /* If there was a token to replace, replace it */
 137         if ($target_token == 'mailto:') {    // rfc 2368 (mailto URL)
 138             $target_pos += 7;    //skip mailto:
 139             $end = $blength;
 140
 141             $mailto = substr($body, $target_pos, $end-$target_pos);
 142
 143             global $MailTo_PReg_Match;
 144             if ((preg_match($MailTo_PReg_Match, $mailto, $regs)) && ($regs[0] != '')) {
 145                 //sm_print_r($regs);
 146                 $mailto_before = $target_token . $regs[0];
 147                 $mailto_params = $regs[10];
 148                 if ($regs[1]) {    //if there is an email addr before '?', we need to merge it with the params
 149                     $to = 'to=' . $regs[1];
 150                     if (strpos($mailto_params, 'to=') > -1)    //already a 'to='
 151                         $mailto_params = str_replace('to=', $to . '%2C%20', $mailto_params);
 152                     else {
 153                         if ($mailto_params)    //already some params, append to them
 154                             $mailto_params .= '&amp;' . $to;
 155                         else
 156                             $mailto_params .= '?' . $to;
 157                     }
 158                 }
 159                 $url_str = preg_replace(array('/to=/i', '/(?<!b)cc=/i', '/bcc=/i'), array('send_to=', 'send_to_cc=', 'send_to_bcc='), $mailto_params);
 160                 $comp_uri = makeComposeLink('src/compose.php' . $url_str, $mailto_before);
 161                 replaceBlock($body, $comp_uri, $target_pos - 7, $target_pos + strlen($regs[0]));
 162                 $target_pos += strlen($comp_uri) - 7;
 163             }
 164         }
 165         else
 166         if ($target_token != '') {
 167             /* Find the end of the URL */
 168             $end = $blength;
 169             foreach ($url_parser_poss_ends as $val) {
 170                 $enda = strpos($body, $val, $target_pos);
 171                 if (is_int($enda) && $enda < $end) {
 172                     $end = $enda;
 173                 }
 174             }
 175
 176             /* Extract URL */
 177             $url = substr($body, $target_pos, $end-$target_pos);
 178
 179             /* Needed since lines are not passed with \n or \r */
 180             while ( ereg("[,\.]$", $url) ) {
 181                 $url = substr( $url, 0, -1 );
 182                 $end--;
 183             }
 184
 185             /* Replace URL with HyperLinked Url, requires 1 char in link */
 186             if ($url != '' && $url != $target_token) {
 187                 $url_str = "<a href=\"$url\" target=\"_blank\">$url</a>";
 188                 replaceBlock($body,$url_str,$target_pos,$end);
 189                 $target_pos += strlen($url_str);
 190             }
 191             else {
 192                 // Not quite a valid link, skip ahead to next chance
 193                 $target_pos += strlen($target_token);
 194             }
 195         }
 196
 197         /* Move forward */
 198         $start   = $target_pos;
 199         $blength = strlen($body);
 200     }
 201 }
 202
 203 /**
 204  * Parses a string and returns the first e-mail address found.
 205  *
 206  * @param string string the string to process
 207  * @return string the first e-mail address found
 208  */
 209 function getEmail($string) {
 210     global $Email_RegExp_Match;
 211     $addresses = array();
 212
 213     /* Find all the email addresses in the body */
 214     while (eregi($Email_RegExp_Match, $string, $regs)) {
 215         $addresses[$regs[0]] = strtr($regs[0], array('&amp;' => '&'));
 216         $start = strpos($string, $regs[0]) + strlen($regs[0]);
 217         $string = substr($string, $start);
 218     }
 219
 220     /* Return the first address, or an empty string if no address was found */
 221     $addresses = array_values($addresses);
 222     return (array_key_exists(0, $addresses) ? $addresses[0] : '');
 223 }
 224
 225 ?>