oont-contents/plugins/woocommerce-square/includes/Framework/Api/API_JSON_Request.php
2025-02-08 15:10:23 +01:00

123 lines
2.5 KiB
PHP

<?php
/**
* WooCommerce Plugin Framework
*
* This source file is subject to the GNU General Public License v3.0
* that is bundled with this package in the file license.txt.
* It is also available through the world-wide-web at this URL:
* http://www.gnu.org/licenses/gpl-3.0.html GNU General Public License v3.0 or later
* If you did not receive a copy of the license and are unable to
* obtain it through the world-wide-web, please send an email
* to license@skyverge.com so we can send you a copy immediately.
*
* @since 3.0.0
* @author WooCommerce / SkyVerge
* @copyright Copyright (c) 2013-2019, SkyVerge, Inc.
* @license http://www.gnu.org/licenses/gpl-3.0.html GNU General Public License v3.0 or later
*
* Modified by WooCommerce on 01 December 2021.
*/
namespace WooCommerce\Square\Framework\Api;
defined( 'ABSPATH' ) or exit;
/**
* Base JSON API request class.
*
* @since 3.0.0
*/
abstract class API_JSON_Request implements API_Request {
/** @var string The request method, one of HEAD, GET, PUT, PATCH, POST, DELETE */
protected $method;
/** @var string The request path */
protected $path;
/** @var array The request parameters, if any */
protected $params = array();
/** @var array the request data */
protected $data = array();
/**
* Get the request method.
*
* @since 3.0.0
* @see API_Request::get_method()
* @return string
*/
public function get_method() {
return $this->method;
}
/**
* Get the request path.
*
* @since 3.0.0
* @see API_Request::get_path()
* @return string
*/
public function get_path() {
return $this->path;
}
/**
* Get the request parameters.
*
* @since 3.0.0
* @see API_Request::get_params()
* @return array
*/
public function get_params() {
return $this->params;
}
/**
* Get the request data.
*
* @since 3.0.0
* @return array
*/
public function get_data() {
return $this->data;
}
/** API Helper Methods ******************************************************/
/**
* Get the string representation of this request.
*
* @since 3.0.0
* @see API_Request::to_string()
* @return string
*/
public function to_string() {
$data = $this->get_data();
return ! empty( $data ) ? wp_json_encode( $data ) : '';
}
/**
* Get the string representation of this request with any and all sensitive elements masked
* or removed.
*
* @since 3.0.0
* @see API_Request::to_string_safe()
* @return string
*/
public function to_string_safe() {
return $this->to_string();
}
}