woocommerce/includes/abstracts/abstract-wc-session.php

128 lines
2.3 KiB
PHP
Raw Normal View History

<?php
/**
2015-11-03 13:53:50 +00:00
* Handle data for the current customers session
*
* @class WC_Session
* @version 2.0.0
2020-08-05 16:36:24 +00:00
* @package WooCommerce\Abstracts
2017-12-15 14:38:00 +00:00
*/
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
/**
* WC_Session
*/
abstract class WC_Session {
2017-12-15 14:38:00 +00:00
/**
* Customer ID.
*
* @var int $_customer_id Customer ID.
*/
2013-01-27 18:54:37 +00:00
protected $_customer_id;
2017-12-15 14:38:00 +00:00
/**
* Session Data.
*
* @var array $_data Data array.
*/
protected $_data = array();
2017-12-15 14:38:00 +00:00
/**
* Dirty when the session needs saving.
*
* @var bool $_dirty When something changes
*/
protected $_dirty = false;
2012-11-27 16:22:47 +00:00
/**
2017-12-15 14:46:02 +00:00
* Init hooks and session data. Extended by child classes.
2017-12-15 14:38:00 +00:00
*
* @since 3.3.0
*/
public function init() {}
2017-12-15 14:46:02 +00:00
/**
* Cleanup session data. Extended by child classes.
*/
public function cleanup_sessions() {}
2017-12-15 14:38:00 +00:00
/**
* Magic get method.
*
2017-12-15 14:38:00 +00:00
* @param mixed $key Key to get.
* @return mixed
*/
public function __get( $key ) {
return $this->get( $key );
}
2012-11-27 16:22:47 +00:00
/**
2017-12-15 14:38:00 +00:00
* Magic set method.
*
2017-12-15 14:38:00 +00:00
* @param mixed $key Key to set.
* @param mixed $value Value to set.
*/
public function __set( $key, $value ) {
$this->set( $key, $value );
}
2012-11-27 16:22:47 +00:00
2017-12-15 14:38:00 +00:00
/**
* Magic isset method.
*
* @param mixed $key Key to check.
* @return bool
*/
public function __isset( $key ) {
return isset( $this->_data[ sanitize_title( $key ) ] );
}
2012-11-27 16:22:47 +00:00
/**
2017-12-15 14:38:00 +00:00
* Magic unset method.
*
2017-12-15 14:38:00 +00:00
* @param mixed $key Key to unset.
*/
public function __unset( $key ) {
if ( isset( $this->_data[ $key ] ) ) {
unset( $this->_data[ $key ] );
$this->_dirty = true;
}
}
2013-01-27 18:54:37 +00:00
/**
* Get a session variable.
*
2017-12-15 14:38:00 +00:00
* @param string $key Key to get.
* @param mixed $default used if the session variable isn't set.
2016-06-06 17:18:26 +00:00
* @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.
*
2017-12-15 14:38:00 +00:00
* @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 );
2017-12-15 14:38:00 +00:00
$this->_dirty = true;
}
}
/**
2017-12-15 14:38:00 +00:00
* Get customer ID.
2013-01-27 18:54:37 +00:00
*
2013-11-28 12:54:19 +00:00
* @return int
2013-01-27 18:54:37 +00:00
*/
public function get_customer_id() {
return $this->_customer_id;
}
}