HEX
Server: Apache/2.4.58 (Ubuntu)
System: Linux bsx-1-dev 6.8.0-101-generic #101-Ubuntu SMP PREEMPT_DYNAMIC Mon Feb 9 10:15:05 UTC 2026 x86_64
User: www-data (33)
PHP: 8.3.6
Disabled: NONE
Upload Files
File: /var/www/html/wp-content/plugins/memberpress/app/lib/MeprBaseModel.php
<?php

if (!defined('ABSPATH')) {
    die('You are not allowed to call this page directly.');
}

#[AllowDynamicProperties]
abstract class MeprBaseModel
{
    /**
     * The record object
     *
     * @var object
     */
    protected $rec;

    /**
     * The attributes
     *
     * @var array
     */
    protected $attrs;

    /**
     * The defaults
     *
     * @var array
     */
    protected $defaults;

    /**
     * Get the value of a property.
     *
     * @param  string $name The name of the property.
     * @return mixed
     */
    public function __get($name)
    {
        $value = null;

        if ($this->magic_method_handler_exists($name)) {
            $value = $this->call_magic_method_handler('get', $name);
        }

        $object_vars = array_keys(get_object_vars($this));
        $rec_array   = (array)$this->rec;

        if (in_array($name, $object_vars, true)) {
            $value = $this->$name;
        } elseif (array_key_exists($name, $rec_array)) {
            if (is_array($this->rec)) {
                $value = $this->rec[$name];
            } else {
                $value = $this->rec->$name;
            }
        }

        // Alternative way to filter results through an sub class method.
        $extend_fn = "get_extend_{$name}";
        if (method_exists($this, $extend_fn)) {
            $value = call_user_func([$this,$extend_fn], $value);
        }

        $value = apply_filters_deprecated(
            'mepr-get-model-attribute-' . $name,
            [$value, $this],
            '1.12.7',
            'mepr_get_model_attribute_' . $name
        );

        return MeprHooks::apply_filters('mepr_get_model_attribute_' . $name, $value, $this);
    }

    /**
     * Set the value of a property.
     *
     * @param  string $name  The name of the property.
     * @param  mixed  $value The value of the property.
     * @return mixed
     */
    public function __set($name, $value)
    {
        $value = apply_filters_deprecated(
            'mepr-set-model-attribute-' . $name,
            [$value, $this],
            '1.12.7',
            'mepr_set_model_attribute_' . $name
        );

        $value = MeprHooks::apply_filters('mepr_set_model_attribute_' . $name, $value, $this);

        // Alternative way to filter results through an sub class method.
        $extend_fn = "set_extend_{$name}";
        if (method_exists($this, $extend_fn)) {
            $value = call_user_func([$this,$extend_fn], $value);
        }

        if ($this->magic_method_handler_exists($name)) {
            return $this->call_magic_method_handler('set', $name, $value);
        }

        $object_vars = array_keys(get_object_vars($this));
        $rec_array   = (array)$this->rec;

        if (in_array($name, $object_vars, true)) {
            $this->$name = $value;
        } elseif (array_key_exists($name, $rec_array)) {
            if (is_array($this->rec)) {
                $this->rec[$name] = $value;
            } else {
                $this->rec->$name = $value;
            }
        } else {
            $this->$name = $value;
        }
    }

    /**
     * Check if a property is set.
     *
     * @param  string $name The name of the property.
     * @return boolean
     */
    public function __isset($name)
    {
        if ($this->magic_method_handler_exists($name)) {
            return $this->call_magic_method_handler('isset', $name);
        }

        if (is_array($this->rec)) {
            return isset($this->rec[$name]);
        } elseif (is_object($this->rec)) {
            return isset($this->rec->$name);
        } else {
            return false;
        }
    }

    /**
     * Unset a property.
     *
     * @param  string $name The name of the property.
     * @return mixed
     */
    public function __unset($name)
    {
        if ($this->magic_method_handler_exists($name)) {
            return $this->call_magic_method_handler('unset', $name);
        }

        if (is_array($this->rec)) {
            unset($this->rec[$name]);
        } elseif (is_object($this->rec)) {
            unset($this->rec->$name);
        }
    }

    /**
     * We just return a JSON encoding of the attributes in the model when we
     * try to get a string for the model.
     */
    public function __toString()
    {
        return json_encode((array)$this->rec);
    }

    /**
     * Initialize the model.
     *
     * @param  array   $defaults The defaults.
     * @param  integer $obj      The object.
     * @return void
     */
    public function initialize($defaults, $obj = null)
    {
        $this->rec   = (object)$defaults;
        $this->attrs = array_keys($defaults);

        if (!is_null($obj)) {
            if (is_numeric($obj) && $obj > 0) {
                $class = get_class($this);

                // $fetched_obj = $class::get_one((int)$obj);
                // $fetched_obj = call_user_func("{$class}::get_one",(int)$obj);
                // ReflectionMethod is less error prone than the other two methods above
                $rm          = new ReflectionMethod($class, 'get_one');
                $fetched_obj = $rm->invoke(null, (int)$obj);

                $this->load_from_array($fetched_obj);
            } elseif (is_array($obj)) {
                $this->load_from_array($obj);
            }
        }

        MeprHooks::do_action('mepr_model_initialized', $this);
    }

    /**
     * Get the values of the model.
     *
     * @return array
     */
    public function get_values()
    {
        return MeprUtils::filter_array_keys((array)$this->rec, (array)$this->attrs);
    }

    /**
     * Get the attributes of the model.
     *
     * @return array
     */
    public function get_attrs()
    {
        return (array)$this->attrs;
    }

    /**
     * Duplicate the model without an id.
     *
     * @return array
     */
    public function duplicate()
    {
        $values = (array)$this->rec;

        if (isset($values['id'])) {
            unset($values['id']);
        }
        if (isset($values['ID'])) {
            unset($values['ID']);
        }

        $class = get_class($this);

        $r   = new ReflectionClass($class);
        $obj = $r->newInstance();

        $obj->load_from_array($values);

        return $obj;
    }

    /**
     * Load the model from an array.
     *
     * @param  array $values The values.
     * @return void
     */
    public function load_from_array($values)
    {
        $unserialized_values = [];
        $values              = (array)$values;
        $defaults            = (array)$this->defaults;

        foreach ($values as $key => $value) {
            // Try to detect the type appropriately.
            if (isset($defaults[$key])) {
                if (is_bool($defaults[$key])) {
                    $value = (bool)$value;
                } elseif (is_float($defaults[$key])) {
                    $value = (float)$value;
                } elseif (is_integer($defaults[$key])) {
                    $value = (int)$value;
                }
            }
            $unserialized_values[$key] = maybe_unserialize($value);
        }

        $this->rec = (object)array_merge((array)$this->rec, (array)$unserialized_values);
    }

    /**
     * Alias for load_from_array().
     *
     * @param  array $values The values.
     * @return void
     */
    public function load_by_array($values)
    {
        $this->load_from_array($values);
    }

    /**
     * Alias for load_from_array().
     *
     * @param  array $values The values.
     * @return void
     */
    public function load_data($values)
    {
        $this->load_from_array($values);
    }

    /**
     * Ensure that the object validates.
     *
     * @return boolean
     */
    public function validate()
    {
        return true;
    }

    /**
     * Store the object in the database.
     *
     * @return boolean
     */
    abstract public function store();

    /**
     * This is an alias of store()
     *
     * @return boolean
     */
    public function save()
    {
        return $this->store();
    }

    /**
     * Destroy the object.
     *
     * @return boolean
     */
    abstract public function destroy();

    /**
     * This is an alias of destroy()
     */
    public function delete()
    {
        return $this->destroy();
    }

    /**
     * If this function exists it will override the default behavior of looking in the rec object
     *
     * @param  string $name The name of the method.
     * @return boolean
     */
    protected function magic_method_handler_exists($name)
    {
        return in_array("mgm_{$name}", get_class_methods($this), true);
    }

    /**
     * Call the magic method handler.
     *
     * @param  string $mgm   The magic method.
     * @param  string $name  The name of the method.
     * @param  string $value The value of the method.
     * @return boolean
     */
    protected function call_magic_method_handler($mgm, $name, $value = '')
    {
        return call_user_func_array([$this, "mgm_{$name}"], [$mgm, $value]);
    }

    /**
     * Validate that the variable is not null.
     *
     * @param  string $var   The variable.
     * @param  string $field The field.
     * @return void
     * @throws MeprCreateException If the variable is null.
     */
    protected function validate_not_null($var, $field = '')
    {
        if (is_null($var)) {
            throw new MeprCreateException(sprintf(
                // Translators: %s: field name.
                esc_html__('%s must not be empty', 'memberpress'),
                esc_html($field)
            ));
        }
    }

    /**
     * Validate that the variable is not empty.
     *
     * @param  string $var   The variable.
     * @param  string $field The field.
     * @return void
     * @throws MeprCreateException If the variable is empty.
     */
    protected function validate_not_empty($var, $field = '')
    {
        if (empty($var)) {
            throw new MeprCreateException(sprintf(
                // Translators: %s: field name.
                esc_html__('%s must not be empty', 'memberpress'),
                esc_html($field)
            ));
        }
    }

    /**
     * Validate that the variable is a boolean.
     *
     * @param  string $var   The variable.
     * @param  string $field The field.
     * @return void
     * @throws MeprCreateException If the variable is not a boolean.
     */
    protected function validate_is_bool($var, $field = '')
    {
        // phpcs:ignore Universal.Operators.StrictComparisons.LooseNotEqual
        if (!is_bool($var) && $var != 0 && $var != 1) {
            throw new MeprCreateException(sprintf(
                // Translators: %s: field name.
                esc_html__('%s must be true or false', 'memberpress'),
                esc_html($field)
            ));
        }
    }

    /**
     * Validate that the variable is an array.
     *
     * @param  string $var   The variable.
     * @param  string $field The field.
     * @return void
     * @throws MeprCreateException If the variable is not an array.
     */
    protected function validate_is_array($var, $field = '')
    {
        if (!is_array($var)) {
            throw new MeprCreateException(sprintf(
                // Translators: %s: field name.
                esc_html__('%s must be an array', 'memberpress'),
                esc_html($field)
            ));
        }
    }

    /**
     * Validate that the variable is in the array.
     *
     * @param  string $var    The variable.
     * @param  string $lookup The lookup.
     * @param  string $field  The field.
     * @return void
     * @throws MeprCreateException If the variable is not in the lookup array.
     */
    protected function validate_is_in_array($var, $lookup, $field = '')
    {
        if (is_array($lookup) && !in_array($var, $lookup, true)) {
            throw new MeprCreateException(sprintf(
                // Translators: %1$s: field name, %2$s: lookup array.
                esc_html__('%1$s must be %2$s', 'memberpress'),
                esc_html($field),
                esc_html(implode(' ' . esc_html__('or', 'memberpress') . ' ', $lookup))
            ));
        }
    }

    /**
     * Validate that the variable is a valid URL.
     *
     * @param  string $var   The variable.
     * @param  string $field The field.
     * @return void
     * @throws MeprCreateException If the variable is not a valid URL.
     */
    protected function validate_is_url($var, $field = '')
    {
        if (!MeprUtils::is_url($var)) {
            throw new MeprCreateException(sprintf(
                // Translators: %1$s: field name, %2$s: field value.
                esc_html__('%1$s (%2$s) must be a valid url', 'memberpress'),
                esc_html($field),
                esc_html($var)
            ));
        }
    }

    /**
     * Validate that the variable is a valid currency.
     *
     * @param  string $var   The variable.
     * @param  string $min   The minimum.
     * @param  string $max   The maximum.
     * @param  string $field The field.
     * @return void
     * @throws MeprCreateException If the variable is not a valid currency.
     */
    protected function validate_is_currency($var, $min = 0.00, $max = null, $field = '')
    {
        if (!is_numeric($var) || $var < $min || (!is_null($max) && $var > $max)) {
            throw new MeprCreateException(sprintf(
                // Translators: %1$s: field name, %2$s: field value.
                esc_html__('%1$s (%2$s) must be a valid representation of currency', 'memberpress'),
                esc_html($field),
                esc_html($var)
            ));
        }
    }

    /**
     * Validate that the variable is a valid number.
     *
     * @param  string $var   The variable.
     * @param  string $min   The minimum.
     * @param  string $max   The maximum.
     * @param  string $field The field.
     * @return void
     * @throws MeprCreateException If the variable is not a valid number.
     */
    protected function validate_is_numeric($var, $min = 0, $max = null, $field = '')
    {
        if (!is_numeric($var) || $var < $min || (!is_null($max) && $var > $max)) {
            throw new MeprCreateException(sprintf(
                // Translators: %1$s: field name, %2$s: field value.
                esc_html__('%1$s (%2$s) must be a valid number', 'memberpress'),
                esc_html($field),
                esc_html($var)
            ));
        }
    }

    /**
     * Validate that the variable is a valid email.
     *
     * @param  string $var   The variable.
     * @param  string $field The field.
     * @return void
     * @throws MeprCreateException If the variable is not a valid email.
     */
    protected function validate_is_email($var, $field = '')
    {
        if (!MeprUtils::is_email($var)) {
            throw new MeprCreateException(sprintf(
                // Translators: %1$s: field name, %2$s: field value.
                esc_html__('%1$s (%2$s) must be a valid email', 'memberpress'),
                esc_html($field),
                esc_html($var)
            ));
        }
    }

    /**
     * Validate that the variable is a valid phone number.
     *
     * @param  string $var   The variable.
     * @param  string $field The field.
     * @return void
     * @throws MeprCreateException If the variable is not a valid phone number.
     */
    protected function validate_is_phone($var, $field = '')
    {
        if (!MeprUtils::is_phone($var)) {
            throw new MeprCreateException(sprintf(
                // Translators: %1$s: field name, %2$s: field value.
                esc_html__('%1$s (%2$s) must be a valid phone number', 'memberpress'),
                esc_html($field),
                esc_html($var)
            ));
        }
    }

    /**
     * Validate that the variable is a valid IP address.
     *
     * @param  string $var   The variable.
     * @param  string $field The field.
     * @return void
     * @throws MeprCreateException If the variable is not a valid IP address.
     */
    protected function validate_is_ip_addr($var, $field = '')
    {
        if (!MeprUtils::is_ip($var)) {
            throw new MeprCreateException(sprintf(
                // Translators: %1$s: field name, %2$s: field value.
                esc_html__('%1$s (%2$s) must be a valid IP Address', 'memberpress'),
                esc_html($field),
                esc_html($var)
            ));
        }
    }

    /**
     * Validate that the variable is a valid date.
     *
     * @param  string $var   The variable.
     * @param  string $field The field.
     * @return void
     * @throws MeprCreateException If the variable is not a valid date.
     */
    protected function validate_is_date($var, $field = '')
    {
        if (!MeprUtils::is_date($var)) {
            throw new MeprCreateException(sprintf(
                // Translators: %1$s: field name, %2$s: field value.
                esc_html__('%1$s (%2$s) must be a valid date', 'memberpress'),
                esc_html($field),
                esc_html($var)
            ));
        }
    }

    /**
     * Validate that the variable is a valid timestamp.
     *
     * @param  string $var   The variable.
     * @param  string $field The field.
     * @return void
     * @throws MeprCreateException If the variable is not a valid timestamp.
     */
    protected function validate_is_timestamp($var, $field = '')
    {
        if (empty($var) || !is_numeric($var)) {
            throw new MeprCreateException(sprintf(
                // Translators: %1$s: field name, %2$s: field value.
                esc_html__('%1$s (%2$s) must be a valid timestamp', 'memberpress'),
                esc_html($field),
                esc_html($var)
            ));
        }
    }

    /**
     * Validate that the variable matches the regex pattern.
     *
     * @param  string $pattern The pattern.
     * @param  string $var     The variable.
     * @param  string $field   The field.
     * @return void
     * @throws MeprCreateException If the variable doesn't match the regex pattern.
     */
    protected function validate_regex($pattern, $var, $field = '')
    {
        if (!preg_match($pattern, $var)) {
            throw new MeprCreateException(sprintf(
                // Translators: %1$s: field name, %2$s: field value, %3$s: regex pattern.
                esc_html__('%1$s (%2$s) must match the regex pattern: %3$s', 'memberpress'),
                esc_html($field),
                esc_html($var),
                esc_html($pattern)
            ));
        }
    }
}