woothemes/woocommerce

View on GitHub
includes/abstracts/abstract-wc-session.php

Summary

Maintainability
A
0 mins
Test Coverage
<?php
/**
 * Handle data for the current customers session
 *
 * @class       WC_Session
 * @version     2.0.0
 * @package     WooCommerce\Abstracts
 */

if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

/**
 * WC_Session
 */
abstract class WC_Session {

    /**
     * Customer ID.
     *
     * @var int $_customer_id Customer ID.
     */
    protected $_customer_id;

    /**
     * Session Data.
     *
     * @var array $_data Data array.
     */
    protected $_data = array();

    /**
     * Dirty when the session needs saving.
     *
     * @var bool $_dirty When something changes
     */
    protected $_dirty = false;

    /**
     * Init hooks and session data. Extended by child classes.
     *
     * @since 3.3.0
     */
    public function init() {}

    /**
     * Cleanup session data. Extended by child classes.
     */
    public function cleanup_sessions() {}

    /**
     * Magic get method.
     *
     * @param mixed $key Key to get.
     * @return mixed
     */
    public function __get( $key ) {
        return $this->get( $key );
    }

    /**
     * Magic set method.
     *
     * @param mixed $key Key to set.
     * @param mixed $value Value to set.
     */
    public function __set( $key, $value ) {
        $this->set( $key, $value );
    }

    /**
     * Magic isset method.
     *
     * @param mixed $key Key to check.
     * @return bool
     */
    public function __isset( $key ) {
        return isset( $this->_data[ sanitize_title( $key ) ] );
    }

    /**
     * Magic unset method.
     *
     * @param mixed $key Key to unset.
     */
    public function __unset( $key ) {
        if ( isset( $this->_data[ $key ] ) ) {
            unset( $this->_data[ $key ] );
            $this->_dirty = true;
        }
    }

    /**
     * Get a session variable.
     *
     * @param string $key Key to get.
     * @param mixed  $default used if the session variable isn't set.
     * @return array|string value of session variable
     */
    public function get( $key, $default = null ) {
        $key = sanitize_key( $key );
        return isset( $this->_data[ $key ] ) ? maybe_unserialize( $this->_data[ $key ] ) : $default;
    }

    /**
     * Set a session variable.
     *
     * @param string $key Key to set.
     * @param mixed  $value Value to set.
     */
    public function set( $key, $value ) {
        if ( $value !== $this->get( $key ) ) {
            $this->_data[ sanitize_key( $key ) ] = maybe_serialize( $value );
            $this->_dirty                        = true;
        }
    }

    /**
     * Get customer ID.
     *
     * @return int
     */
    public function get_customer_id() {
        return $this->_customer_id;
    }
}