vendor/zendframework/zend-mail/src/Header/HeaderName.php

   1 <?php
   2 /**
   3  * @see       https://github.com/zendframework/zend-mail for the canonical source repository
   4  * @copyright Copyright (c) 2005-2018 Zend Technologies USA Inc. (https://www.zend.com)
   5  * @license   https://github.com/zendframework/zend-mail/blob/master/LICENSE.md New BSD License
   6  */
   7
   8 namespace Zend\Mail\Header;
   9
  10 final class HeaderName
  11 {
  12     /**
  13      * No public constructor.
  14      */
  15     private function __construct()
  16     {
  17     }
  18
  19     /**
  20      * Filter the header name according to RFC 2822
  21      *
  22      * @see    http://www.rfc-base.org/txt/rfc-2822.txt (section 2.2)
  23      * @param  string $name
  24      * @return string
  25      */
  26     public static function filter($name)
  27     {
  28         $result = '';
  29         $tot    = strlen($name);
  30         for ($i = 0; $i < $tot; $i += 1) {
  31             $ord = ord($name[$i]);
  32             if ($ord > 32 && $ord < 127 && $ord !== 58) {
  33                 $result .= $name[$i];
  34             }
  35         }
  36         return $result;
  37     }
  38
  39     /**
  40      * Determine if the header name contains any invalid characters.
  41      *
  42      * @param string $name
  43      * @return bool
  44      */
  45     public static function isValid($name)
  46     {
  47         $tot = strlen($name);
  48         for ($i = 0; $i < $tot; $i += 1) {
  49             $ord = ord($name[$i]);
  50             if ($ord < 33 || $ord > 126 || $ord === 58) {
  51                 return false;
  52             }
  53         }
  54         return true;
  55     }
  56
  57     /**
  58      * Assert that the header name is valid.
  59      *
  60      * Raises an exception if invalid.
  61      *
  62      * @param string $name
  63      * @throws Exception\RuntimeException
  64      * @return void
  65      */
  66     public static function assertValid($name)
  67     {
  68         if (! self::isValid($name)) {
  69             throw new Exception\RuntimeException('Invalid header name detected');
  70         }
  71     }
  72 }