mrbs-equbao-2026/lib/MRBS/User.php

<?php
declare(strict_types=1);
namespace MRBS;


// This is a class for a general MRBS user, regardless of the authentication type.  Once authenticated each
// user is converted into a standard MRBS user object with defined properties.  (Do not confuse this user
// with a user in the users table: the 'db' authentication method is just one of many that MRBS supports.)
use PHPMailer\PHPMailer\PHPMailer;

class User
{
  // Standard properties
  public $username;
  public $display_name;
  public $email;
  public $level;

  // Extra properties held here, accessed through magic methods
  protected  $data = array();


  public function __construct($username=null)
  {
    $this->username = $username;

    // Set some default properties
    $this->display_name = $username;
    $this->setDefaultEmail();
    $this->level = 0; // Play it safe
  }


  public function __get($name)
  {
    return (array_key_exists($name, $this->data)) ? $this->data[$name] : null;
  }


  public function __set($name, $value)
  {
    $this->data[$name] = $value;
  }


  public function __isset($name)
  {
    return (array_key_exists($name, $this->data) && isset($this->data[$name]));
  }


  public function __unset($name)
  {
    unset($this->data[$name]);
  }


  // Checks whether the user appears somewhere in the bookings as (a) the creator
  // of a booking, (b) the modifier of a booking or (c) a registrant.
  public function isInBookings() : bool
  {
    $sql_params = [':username' => $this->username];

    foreach (['entry', 'repeat'] as $table)
    {
      $sql = "SELECT COUNT(id)
                FROM ". _tbl($table) . "
               WHERE (create_by = :username)
                  OR (modified_by = :username)
               LIMIT 1";
      if (db()->query1($sql, $sql_params) > 0)
      {
        return true;
      }
    }

    $sql = "SELECT COUNT(id)
              FROM ". _tbl('participants') . "
             WHERE username = :username
             LIMIT 1";

    return (db()->query1($sql, $sql_params) > 0);
  }


  public function load(array $data)
  {
    foreach ($data as $key => $value)
    {
      $this->$key = $value;
    }
  }


  // Returns an RFC 5322 mailbox address, ie an address in the format
  // "Display name <email address>"
  public function mailbox()
  {
    if (!isset($this->email))
    {
      return null;
    }

    if (!isset($this->display_name) || ($this->display_name === ''))
    {
      return $this->email;
    }

    $mailer = new PHPMailer();
    $mailer->CharSet = Language::MAIL_CHARSET;

    // Note that addrFormat() returns a MIME-encoded address
    return $mailer->addrFormat(array($this->email, $this->display_name));
  }

  // Sets the default email address for the user (null if one can't be found)
  private function setDefaultEmail()
  {
    global $mail_settings;

    if (!isset($this->username) || $this->username === '')
    {
      $this->email = null;
    }
    else
    {
      $this->email = $this->username;

      // Remove the suffix, if there is one
      if (isset($mail_settings['username_suffix']) && ($mail_settings['username_suffix'] !== ''))
      {
        $suffix = $mail_settings['username_suffix'];
        if (mb_substr($this->email, -mb_strlen($suffix)) === $suffix)
        {
          $this->email = mb_substr($this->email, 0, -mb_strlen($suffix));
        }
      }

      // Add on the domain, if there is one
      if (isset($mail_settings['domain']) && ($mail_settings['domain'] !== ''))
      {
        // Trim any leading '@' character. Older versions of MRBS required the '@' character
        // to be included in $mail_settings['domain'], and we still allow this for backwards
        // compatibility.
        $domain = ltrim($mail_settings['domain'], '@');
        $this->email .= '@' . $domain;
      }

      // Validate the resulting email address
      if (!validate_email($this->email))
      {
        $this->email = null;
      }
    }
  }

}