[ Index ]

PHP Cross Reference of DokuWiki

title

Body

[close]

/inc/ -> mail.php (source)

   1  <?php
   2  
   3  /**
   4   * Mail functions
   5   *
   6   * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
   7   * @author     Andreas Gohr <andi@splitbrain.org>
   8   */
   9  
  10  /**
  11   * Patterns for use in email detection and validation
  12   *
  13   * NOTE: there is an unquoted '/' in RFC2822_ATEXT, it must remain unquoted to be used in the parser
  14   * the pattern uses non-capturing groups as captured groups aren't allowed in the parser
  15   * select pattern delimiters with care!
  16   *
  17   * May not be completly RFC conform!
  18   * @link http://www.faqs.org/rfcs/rfc2822.html (paras 3.4.1 & 3.2.4)
  19   *
  20   * @author Chris Smith <chris@jalakai.co.uk>
  21   * Check if a given mail address is valid
  22   */
  23  if (!defined('RFC2822_ATEXT')) define('RFC2822_ATEXT', "0-9a-zA-Z!#$%&'*+/=?^_`{|}~-");
  24  if (!defined('PREG_PATTERN_VALID_EMAIL')) define(
  25      'PREG_PATTERN_VALID_EMAIL',
  26      '[' . RFC2822_ATEXT . ']+(?:\.[' . RFC2822_ATEXT . ']+)*@(?i:[0-9a-z][0-9a-z-]*\.)+(?i:[a-z]{2,63})'
  27  );
  28  
  29  /**
  30   * Prepare mailfrom replacement patterns
  31   *
  32   * Also prepares a mailfromnobody config that contains an autoconstructed address
  33   * if the mailfrom one is userdependent and this might not be wanted (subscriptions)
  34   *
  35   * @author Andreas Gohr <andi@splitbrain.org>
  36   */
  37  function mail_setup()
  38  {
  39      global $conf;
  40      global $USERINFO;
  41      /** @var Input $INPUT */
  42      global $INPUT;
  43  
  44      // auto constructed address
  45      $host = @parse_url(DOKU_URL, PHP_URL_HOST);
  46      if (!$host) $host = 'example.com';
  47      $noreply = 'noreply@' . $host;
  48  
  49      $replace = [];
  50      if (!empty($USERINFO['mail'])) {
  51          $replace['@MAIL@'] = $USERINFO['mail'];
  52      } else {
  53          $replace['@MAIL@'] = $noreply;
  54      }
  55  
  56      // use 'noreply' if no user
  57      $replace['@USER@'] = $INPUT->server->str('REMOTE_USER', 'noreply', true);
  58  
  59      if (!empty($USERINFO['name'])) {
  60          $replace['@NAME@'] = $USERINFO['name'];
  61      } else {
  62          $replace['@NAME@'] = '';
  63      }
  64  
  65      // apply replacements
  66      $from = str_replace(
  67          array_keys($replace),
  68          array_values($replace),
  69          $conf['mailfrom']
  70      );
  71  
  72      // any replacements done? set different mailfromnone
  73      if ($from != $conf['mailfrom']) {
  74          $conf['mailfromnobody'] = $noreply;
  75      } else {
  76          $conf['mailfromnobody'] = $from;
  77      }
  78      $conf['mailfrom'] = $from;
  79  }
  80  
  81  /**
  82   * Check if a given mail address is valid
  83   *
  84   * @param   string $email the address to check
  85   * @return  bool          true if address is valid
  86   */
  87  function mail_isvalid($email)
  88  {
  89      return EmailAddressValidator::checkEmailAddress($email, true);
  90  }
  91  
  92  /**
  93   * Quoted printable encoding
  94   *
  95   * @author umu <umuAThrz.tu-chemnitz.de>
  96   * @link   http://php.net/manual/en/function.imap-8bit.php#61216
  97   *
  98   * @param string $sText
  99   * @param int $maxlen
 100   * @param bool $bEmulate_imap_8bit
 101   *
 102   * @return string
 103   */
 104  function mail_quotedprintable_encode($sText, $maxlen = 74, $bEmulate_imap_8bit = true)
 105  {
 106      // split text into lines
 107      $aLines = preg_split("/(?:\r\n|\r|\n)/", $sText);
 108      $cnt = count($aLines);
 109  
 110      for ($i = 0; $i < $cnt; $i++) {
 111          $sLine =& $aLines[$i];
 112          if ($sLine === '') continue; // do nothing, if empty
 113  
 114          $sRegExp = '/[^\x09\x20\x21-\x3C\x3E-\x7E]/e';
 115  
 116          // imap_8bit encodes x09 everywhere, not only at lineends,
 117          // for EBCDIC safeness encode !"#$@[\]^`{|}~,
 118          // for complete safeness encode every character :)
 119          if ($bEmulate_imap_8bit)
 120              $sRegExp = '/[^\x20\x21-\x3C\x3E-\x7E]/';
 121  
 122          $sLine = preg_replace_callback($sRegExp, 'mail_quotedprintable_encode_callback', $sLine);
 123  
 124          // encode x09,x20 at lineends
 125          {
 126              $iLength = strlen($sLine);
 127              $iLastChar = ord($sLine[$iLength - 1]);
 128  
 129              //              !!!!!!!!
 130              // imap_8_bit does not encode x20 at the very end of a text,
 131              // here is, where I don't agree with imap_8_bit,
 132              // please correct me, if I'm wrong,
 133              // or comment next line for RFC2045 conformance, if you like
 134          if (!($bEmulate_imap_8bit && ($i == count($aLines) - 1))) {
 135              if (($iLastChar == 0x09) || ($iLastChar == 0x20)) {
 136                  $sLine[$iLength - 1] = '=';
 137                  $sLine .= ($iLastChar == 0x09) ? '09' : '20';
 138              }
 139          }
 140          }    // imap_8bit encodes x20 before chr(13), too
 141          // although IMHO not requested by RFC2045, why not do it safer :)
 142          // and why not encode any x20 around chr(10) or chr(13)
 143          if ($bEmulate_imap_8bit) {
 144              $sLine = str_replace(' =0D', '=20=0D', $sLine);
 145              //$sLine=str_replace(' =0A','=20=0A',$sLine);
 146              //$sLine=str_replace('=0D ','=0D=20',$sLine);
 147              //$sLine=str_replace('=0A ','=0A=20',$sLine);
 148          }
 149  
 150          // finally split into softlines no longer than $maxlen chars,
 151          // for even more safeness one could encode x09,x20
 152          // at the very first character of the line
 153          // and after soft linebreaks, as well,
 154          // but this wouldn't be caught by such an easy RegExp
 155          if ($maxlen) {
 156              preg_match_all('/.{1,' . ($maxlen - 2) . '}([^=]{0,2})?/', $sLine, $aMatch);
 157              $sLine = implode('=' . MAILHEADER_EOL, $aMatch[0]); // add soft crlf's
 158          }
 159      }
 160  
 161      // join lines into text
 162      return implode(MAILHEADER_EOL, $aLines);
 163  }
 164  
 165  function mail_quotedprintable_encode_callback($matches)
 166  {
 167      return sprintf("=%02X", ord($matches[0])) ;
 168  }