errormail.i

<?php
/**
 * @var ErrorMail
 * It hardly has anything to do with errors...
 * It is the generic class for sending emails.
 * All in-house PHP at this point should be using it.
 * That is Monitor, Admin, and Banking.
 */
class ErrorMail {

   var $logmode;
   var $logfile;
   var $header;
   var $mailcmd;
   var $mailto;
   var $mailfrom;
   var $mailfromname;
   var $replyto;
   var $script;
   var $subject;
   var $msgbody;
   var $line;
   var $file;
   var $callingfunction;
   var $physfile;
   var $error;
   var $server_id;
   var $sql;
   var $errdate;
   var $cu;
   var $member;

  function __construct() {
      /*
       * changed name of function from ErrorMail to __construct
       * in response to this PHP7 error
       * Deprecated: Methods with the same name as their class will not be constructors in a future version of PHP
       */

    #-----------------------------------------
    #   EDITABLE CONFIGURATION VARIABLES

    $this->header = "";                                  # any headers, delimited with semi-colon
    $this->mailto = "cuerror@homecu.net";                           # recipient id
    $this->hideto = false;                                # if true, to is bcc instead of to
    $this->mailfrom = "noreply@homecu.net";               # default sender id  ** NOTE: This should be JUST an email address with NO NAME somebody@email.com NOT "SomeBody" <somebody@email.com>
    $this->mailfromname = '';                          // ** SET the name to be empty
    // * START the replyto off as empty.  IF set by a script then I will send it in the header
    $this->replyto = "";
    $this->subject = "Digital Banking Message";             # default subject
    $this->msgbody = "";                                 # default empty message
    $this->htmlMsgbody = "";
    $this->plainMsgbody = ""; // Allow the option of directly setting these parts.
    $this->executeQuietly = false; // add `--quiet` option to a email sending python script
    $this->bulk = false; // send bulk emails

    // When called from scheduler scripts such as sCalendarNotify.i and schedliveproc.php, these attributes are not defined.
    $this->script = HCU_array_key_value("SCRIPT_NAME", $_SERVER);  # What script?
    $this->server = HCU_array_key_value("SERVER_NAME", $_SERVER); # What Server?
    $this->query = HCU_array_key_value("REQUEST_URL", $_SERVER); # How was it called
    $this->errdate = `date +"%a, %d %b %Y %T %Z"`;

    #------------------------------------------

  }

    /**
     *  Obtain a python file that will send the email.
     */
    private function getPyFileLocation() {
        # Goal is to default it with a script with more generalized functionality
        # added in sendSESEmailBulk.py script
        if ($this->bulk) {
            return dirname(__FILE__) . "/../scripts/sendSESEmailBulk.py";
        } else {
            return dirname(__FILE__) . "/../scripts/sendSESEmail.py";
        }
    }

    /**
     * Prepare a a dictionary of {context: "json ob"}
     * --context option for Python Email Sending Script
     */
    private function getAwsSesLoggingContextJsonString() {

        $context = array();

        // these attributes are expected to be set on the calling
        // side before invoking SendMail and SendErr
        $context["cucode"] = $this->cu;
        $context["callingScript"] = $this->file;
        $context["callingFunction"] = $this->callingfunction;
        $context["serverName"] = $this->server;
        $context["ServerScript"] = $this->script;

        return HCU_JsonEncode($context);
    }


  /**
   * function SendMail()
   * Send an email through AWS SES.
   * Like the previous implemention, the email is sent in the background.
   * That means that there is no checking to see if the email has failed.
   * For AWS SES fails are:
   *  1) Invalid syntax of either from or to emails (should be checked before),
   *  2) The From email is not verified
   *    (at this point in time, the default of noreply@homecu.net is not verified.),
   * For more information, @see the sendSESEmail.py script.
   */
  function SendMail() {
    $pyFile = $this->getPyFileLocation();

    // Set up from
    $from = $this->mailfromname != '' ? "{$this->mailfromname} <{$this->mailfrom}>" : $this->mailfrom;
    $fromString = "--efrom " . escapeshellarg($from);

    // Set up reply to
    $replyToString = $this->replyto != "" ? "--replyto " . escapeshellarg($this->replyto) : "";

    // Set up subject
    $subjectString = "--subject " . escapeshellarg($this->subject);

    // Now HTML emails are set up using the header declaration (legacy).
    // Also allow direct setting of the plaintext and htmltext parts of the email.
    $plainTextBody = "";
    $htmlTextBody = "";
    if ($this->htmlMsgbody != "") {
      $htmlTextBody = $this->htmlMsgbody;
    }
    if ($this->plainMsgbody != "") {
      $plainTextBody = $this->plainMsgbody;
    }
    if ($this->msgbody != "") {
      if (trim(strtolower($this->header)) == "content-type: text/html") { // For the most part, they have the same case except for a couple.
        $htmlTextBody = $this->msgbody;
      } else {
        $plainTextBody = $this->msgbody;
      }
    }

    // Need to escape newlines.  They cause the email to fail.
    $plainTextString = "";
    $htmlTextString = "";
    if ($plainTextBody != "") {
      // Requires some finagling: if newline is literal \n then bash line doesn't work but with \\n, it shows up in the email as "\n."
      $plainTextBody = str_replace("\n", "\\n", str_replace("\r\n", "\\r\\n", $plainTextBody));
      $plainTextString = "--plaintext \"`echo " . escapeshellarg($plainTextBody) . "`\"";
    }
    if ($htmlTextBody != "") {
      // Do not replace newlines with breaks.  Script is responsible for displaying correctly; also breaks image data (in the case of billing/workflow emails.)
      $htmlTextString = "--htmltext " . escapeshellarg($htmlTextBody);
    }

    if ($plainTextString == "" && $htmlTextString == "") {
      $plainTextString = "--plaintext ''";
    }

    // Set up to.  Amazon has a limit of 50 recipients so parse at this point.
    $toArray = is_array($this->mailto) ? $this->mailto : explode(";", str_replace(",", ";", strval($this->mailto)));
    $toSwitch = $this->hideto ? "--bcc" : "--to";
    $executeQuietly = $this->executeQuietly ? "--quiet" : "";

    // sanitize list of emails
    $toArray = array_map("trim", $toArray);
    $toArray = array_map("escapeshellarg", $toArray);

    $toString = "$toSwitch " . implode(" ", $toArray);

    $awsSesLoggingContext = "--context " . escapeshellarg($this->getAwsSesLoggingContextJsonString());

    $cmd = "(python3 $pyFile $toString $fromString $subjectString $plainTextString \
            $htmlTextString $replyToString $executeQuietly $awsSesLoggingContext) > /dev/null &";

    exec($cmd);
  }

  /**
   * function SendErr()
   * This sends an email pointing out an error.
   * At this point in time, all references in Odyssey have not been updated.
   * No, this is not the email in Mammoth which comes from the error handler.
   */
  function SendErr() {
    $pyFile = $this->pyFile;

    $msg = "";
    $msg .= "Error in $this->script on Server $this->server\\n";
    $msg .= "Called as $this->query\\n\\n";
    $msg .= $this->line == ""   ? "" :  "LINE: $this->line\\n";
    $msg .= $this->file == ""   ? "" :  "FILE: $this->file\\n";
    $msg .= $this->error == ""  ? "" :  "ERROR: $this->error\\n";
    $msg .= $this->sql == ""    ? "" :  "SQL: $this->sql\\n";
    $msg .= $this->cu == ""     ? "" :  "CU: $this->cu\\n";
    $msg .= $this->member == "" ? "" :  "MEMBER: $this->member\\n";

    // Set up message
    // Requires some finagling: if newline is literal \n then bash line doesn't work but with \\n, it shows up in the email as "\n."
    $plainTextString = "--plaintext \"`echo " . escapeshellarg($msg) . "`\"";

    // Set up subject
    $subject = "Error in $this->script";
    $subjectString = "--subject " . escapeshellarg($subject);

    // Set up from
    $fromString = "--efrom " . escapeshellarg($this->mailfrom);

    // Set up to.  Amazon has a limit of 50 recipients so parse at this point.
    $toArray = is_array($this->mailto) ? $this->mailto : explode(";", str_replace(",", ";", strval($this->mailto)));
    $toSwitch = $this->hideto ? "--bcc" : "--to";
    $toList = array();

    $awsSesLoggingContext = "--context " . escapeshellarg($this->getAwsSesLoggingContextJsonString());

    foreach($toArray as $toEmail) {
      if (trim($toEmail) != "") {
        $toList[] = escapeshellarg($toEmail);

        if (count($toList) >= 50) {
          $toString = "$toSwitch " . implode(" ", $toList);
          $cmd = "(python3 $pyFile $toString $fromString $subjectString $plainTextString $awsSesLoggingContext) &";
          exec($cmd);
          $toList = array();
        }
      }
    }

    $toString = "$toSwitch " . implode(" ", $toList);
    $cmd = "(python3 $pyFile $toString $fromString $subjectString $plainTextString $awsSesLoggingContext) &";
    exec($cmd);
  }

}