Changeset 8 for trunk/Packages/Common/Mail.php

Timestamp:

Jun 1, 2023, 12:18:18 AM (12 months ago)

Author:

chronos

Message:

• Modified: Updated Common package.
• Modified: Form types made as separate FormManager package.
• Fixed: PHP 8.1 support.

File:

• trunk/Packages/Common/Mail.php (modified) (11 diffs)

trunk/Packages/Common/Mail.php

@@ -9 +9 @@
 class Mail
 {
-  var $Priorities;
-  var $Subject;
-  var $From;
-  var $Recipients;
-  var $Bodies;
-  var $Attachments;
-  var $AgentIdent;
-  var $Organization;
-  var $ReplyTo;
-  var $Headers;
+  public string $Subject;
+  public string $From;
+  public array $Recipients;
+  public array $Bodies;
+  public array $Attachments;
+  public string $AgentIdent;
+  public string $Organization;
+  public string $ReplyTo;
+  public array $Headers;
+  private array $Priorities;
+  private string $Boundary;
+  public bool $TestMode;
+  public string $SenderAddress;
+  public string $SenderName;
 
   function __construct()
@@ -25 +29 @@
     $this->Boundary = md5(date('r', time()));
     $this->AgentIdent = 'PHP/Mail';
+    $this->TestMode = false;
     $this->Clear();
   }
 
-  function Clear()
+  function Clear(): void
   {
     $this->Bodies = array();
@@ -41 +46 @@
   }
 
-  function AddToCombined($Address)
+  function AddToCombined(string $Address): void
   {
     $this->Recipients[] = array('Address' => $Address, 'Type' => 'SendCombined');
   }
 
-  function AddTo($Address, $Name)
+  function AddTo(string $Address, string $Name): void
   {
     $this->Recipients[] = array('Address' => $Address, 'Name' => $Name, 'Type' => 'Send');
   }
 
-  function AddCc($Address, $Name)
+  function AddCc(string $Address, string $Name): void
   {
     $this->Recipients[] = array('Address' => $Address, 'Name' => $Name, 'Type' => 'Copy');
   }
 
-  function AddBcc($Address, $Name)
+  function AddBcc(string $Address, string $Name): void
   {
     $this->Recipients[] = array('Address' => $Address, 'Name' => $Name, 'Type' => 'HiddenCopy');
   }
 
-  function AddBody($Content, $MimeType = 'text/plain', $Charset = 'utf-8')
+  function AddBody(string $Content, string $MimeType = 'text/plain', string $Charset = 'utf-8'): void
   {
     $this->Bodies[] = array('Content' => $Content, 'Type' => strtolower($MimeType),
@@ -67 +72 @@
   }
 
-  function Organization($org)
-  {
-    if (trim($org != '')) $this->xheaders['Organization'] = $org;
-  }
-
-  function Priority($Priority)
+  function Organization(string $org): void
+  {
+    if (trim($org != '')) $this->Headers['Organization'] = $org;
+  }
+
+  function Priority(int $Priority): bool
   {
     if (!intval($Priority)) return false;
 
-    if (!isset($this->priorities[$Priority - 1])) return false;
-
-    $this->xheaders['X-Priority'] = $this->priorities[$Priority - 1];
+    if (!isset($this->Priorities[$Priority - 1])) return false;
+
+    $this->Headers['X-Priority'] = $this->Priorities[$Priority - 1];
     return true;
   }
 
-  function AttachFile($FileName, $FileType, $Disposition = DISPOSITION_ATTACHMENT)
+  function AttachFile($FileName, $FileType, $Disposition = DISPOSITION_ATTACHMENT): void
   {
     $this->Attachments[] = array('FileName' => $FileName, 'FileType' => $FileType,
@@ -88 +93 @@
   }
 
-  function AttachData($FileName, $FileType, $Data, $Disposition = DISPOSITION_ATTACHMENT)
+  function AttachData($FileName, $FileType, $Data, $Disposition = DISPOSITION_ATTACHMENT): void
   {
     $this->Attachments[] = array('FileName' => $FileName, 'FileType' => $FileType,
@@ -94 +99 @@
   }
 
-  function Send()
+  function Send(): bool
   {
     if (count($this->Bodies) == 0) throw new Exception(T('Mail message need at least one text body'));
@@ -132 +137 @@
     if ($this->AgentIdent != '') $this->Headers['X-Mailer'] = $this->AgentIdent;
     if ($this->ReplyTo != '') $this->Headers['Reply-To'] = $this->ReplyTo;
-    if ($this->From != '') $this->Headers['From'] = $this->From;
+    if ($this->From != '')
+    {
+      $IndexStart = strpos($this->From, '<');
+      if ($IndexStart !== false)
+      {
+        $this->Headers['From'] = '=?utf-8?Q?'.quoted_printable_encode(trim(substr($this->From, 0, $IndexStart))).'?= '.substr($this->From, $IndexStart);
+      } else
+      {
+        $this->Headers['From'] = $this->From;
+      }
+    }
 
     $Headers = '';
@@ -144 +159 @@
     if ($this->Subject == '') throw new Exception(T('Mail message missing Subject'));
 
-
-    $res = mail($To, $this->Subject, $Body, $Headers);
+    if ($this->TestMode)
+    {
+      echo('to: '.$To.', subject: '.$this->Subject.', body: '.$Body.', headers: '.$Headers);
+      $res = true;
+    } else
+    {
+      $res = mail($To, $this->Subject, $Body, $Headers);
+    }
     return $res;
   }
 
-  function ValidEmail($Address)
-  {
-    if (ereg(".*<(.+)>", $Address, $regs)) $Address = $regs[1];
-    if (ereg("^[^@  ]+@([a-zA-Z0-9\-]+\.)+([a-zA-Z0-9\-]{2}|net|com|gov|mil|org|edu|int)\$", $Address))
+  function ValidEmail(string $Address): bool
+  {
+    if (preg_match(".*<(.+)>", $Address, $regs)) $Address = $regs[1];
+    if (preg_match("^[^@  ]+@([a-zA-Z0-9\-]+\.)+([a-zA-Z0-9\-]{2}|net|com|gov|mil|org|edu|int)\$", $Address))
       return true;
       else return false;
   }
 
-  function CheckAdresses($Addresses)
+  function CheckAdresses(array $Addresses): void
   {
     foreach ($Addresses as $Address)
     {
       if (!$this->ValidEmail($Address))
-  throw new Exception(sprintf(T('Mail message invalid address %s'), $Address));
-    }
-  }
-
-  private function ContentEncoding($Charset)
+      {
+        throw new Exception(sprintf(T('Mail message invalid address %s'), $Address));
+      }
+    }
+  }
+
+  private function ContentEncoding($Charset): string
   {
     if ($Charset != CHARSET_ASCII) return '8bit';
@@ -172 +195 @@
   }
 
-  private function BuildAttachment($Body)
+  private function BuildAttachment($Body): string
   {
     if (count($this->Attachments) > 0)
@@ -206 +229 @@
   }
 
-  private function BuildBody()
+  private function BuildBody(): string
   {
     $Result = '';
@@ -219 +242 @@
       $this->Headers['Content-Transfer-Encoding'] = $this->ContentEncoding($this->Bodies[0]['Charset']);
     }
-
 
     foreach ($this->Bodies as $Body)