275 lines
9.4 KiB
PHP
275 lines
9.4 KiB
PHP
<?php
|
||
|
||
/**
|
||
* The MIT License
|
||
*
|
||
* Copyright (c) 2023 "YooMoney", NBСO LLC
|
||
*
|
||
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
||
* of this software and associated documentation files (the "Software"), to deal
|
||
* in the Software without restriction, including without limitation the rights
|
||
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||
* copies of the Software, and to permit persons to whom the Software is
|
||
* furnished to do so, subject to the following conditions:
|
||
*
|
||
* The above copyright notice and this permission notice shall be included in
|
||
* all copies or substantial portions of the Software.
|
||
*
|
||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
||
* THE SOFTWARE.
|
||
*/
|
||
|
||
namespace YooKassa\Common;
|
||
|
||
if (!defined('YOOKASSA_DATE')) {
|
||
if (version_compare(PHP_VERSION, '7.0') >= 0) {
|
||
define('YOOKASSA_DATE', "Y-m-d\TH:i:s.vP");
|
||
} else {
|
||
define('YOOKASSA_DATE', "Y-m-d\TH:i:s.uP");
|
||
}
|
||
}
|
||
|
||
if (!interface_exists('JsonSerializable')) {
|
||
require_once dirname(__FILE__) . '/legacy_json_serializable.php';
|
||
}
|
||
|
||
/**
|
||
* Базовый класс генерируемых объектов
|
||
*
|
||
* @package YooKassa
|
||
*/
|
||
abstract class AbstractObject implements \ArrayAccess, \JsonSerializable
|
||
{
|
||
/**
|
||
* @var array Свойства установленные пользователем
|
||
*/
|
||
private $unknownProperties = array();
|
||
|
||
/**
|
||
* AbstractObject constructor.
|
||
* @param array $data
|
||
*/
|
||
public function __construct($data = array())
|
||
{
|
||
if (!empty($data) && is_array($data)) {
|
||
$this->fromArray($data);
|
||
}
|
||
}
|
||
|
||
#[\ReturnTypeWillChange]
|
||
/**
|
||
* Проверяет наличие свойства
|
||
* @param string $offset Имя проверяемого свойства
|
||
* @return bool True если свойство имеется, false если нет
|
||
*/
|
||
public function offsetExists($offset)
|
||
{
|
||
$method = 'get' . ucfirst($offset);
|
||
if (method_exists($this, $method)) {
|
||
return true;
|
||
}
|
||
$method = 'get' . self::matchPropertyName($offset);
|
||
if (method_exists($this, $method)) {
|
||
return true;
|
||
}
|
||
return array_key_exists($offset, $this->unknownProperties);
|
||
}
|
||
|
||
#[\ReturnTypeWillChange]
|
||
/**
|
||
* Возвращает значение свойства
|
||
* @param string $offset Имя свойства
|
||
* @return mixed Значение свойства
|
||
*/
|
||
public function offsetGet($offset)
|
||
{
|
||
$method = 'get' . ucfirst($offset);
|
||
if (method_exists($this, $method)) {
|
||
return $this->{$method}();
|
||
}
|
||
$method = 'get' . self::matchPropertyName($offset);
|
||
if (method_exists($this, $method)) {
|
||
return $this->{$method}();
|
||
}
|
||
return array_key_exists($offset, $this->unknownProperties) ? $this->unknownProperties[$offset] : null;
|
||
}
|
||
|
||
#[\ReturnTypeWillChange]
|
||
/**
|
||
* Устанавливает значение свойства
|
||
* @param string $offset Имя свойства
|
||
* @param mixed $value Значение свойства
|
||
* @return void
|
||
*/
|
||
public function offsetSet($offset, $value)
|
||
{
|
||
$method = 'set' . ucfirst($offset);
|
||
if (method_exists($this, $method)) {
|
||
$this->{$method}($value);
|
||
} else {
|
||
$method = 'set' . self::matchPropertyName($offset);
|
||
if (method_exists($this, $method)) {
|
||
$this->{$method}($value);
|
||
} else {
|
||
$this->unknownProperties[$offset] = $value;
|
||
}
|
||
}
|
||
}
|
||
|
||
#[\ReturnTypeWillChange]
|
||
/**
|
||
* Удаляет свойство
|
||
* @param string $offset Имя удаляемого свойства
|
||
* @return void
|
||
*/
|
||
public function offsetUnset($offset)
|
||
{
|
||
$method = 'set' . ucfirst($offset);
|
||
if (method_exists($this, $method)) {
|
||
$this->{$method}(null);
|
||
} else {
|
||
$method = 'set' . self::matchPropertyName($offset);
|
||
if (method_exists($this, $method)) {
|
||
$this->{$method}(null);
|
||
} else {
|
||
unset($this->unknownProperties[$offset]);
|
||
}
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Возвращает значение свойства
|
||
* @param string $propertyName Имя свойства
|
||
* @return mixed Значение свойства
|
||
*/
|
||
public function __get($propertyName)
|
||
{
|
||
return $this->offsetGet($propertyName);
|
||
}
|
||
|
||
/**
|
||
* Устанавливает значение свойства
|
||
* @param string $propertyName Имя свойства
|
||
* @param mixed $value Значение свойства
|
||
*/
|
||
public function __set($propertyName, $value)
|
||
{
|
||
$this->offsetSet($propertyName, $value);
|
||
}
|
||
|
||
/**
|
||
* Проверяет наличие свойства
|
||
* @param string $propertyName Имя проверяемого свойства
|
||
* @return bool True если свойство имеется, false если нет
|
||
*/
|
||
public function __isset($propertyName)
|
||
{
|
||
return $this->offsetExists($propertyName);
|
||
}
|
||
|
||
/**
|
||
* Удаляет свойство
|
||
* @param string $propertyName Имя удаляемого свойства
|
||
*/
|
||
public function __unset($propertyName)
|
||
{
|
||
$this->offsetUnset($propertyName);
|
||
}
|
||
|
||
/**
|
||
* Устанавливает значения свойств текущего объекта из массива
|
||
* @param array|\Traversable $sourceArray Ассоциативный массив с настройками
|
||
*/
|
||
public function fromArray($sourceArray)
|
||
{
|
||
foreach ($sourceArray as $key => $value) {
|
||
$this->offsetSet($key, $value);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Возвращает ассоциативный массив со свойствами текущего объекта для его дальнейшей JSON сериализации
|
||
* Является алиасом метода AbstractObject::jsonSerialize()
|
||
* @return array Ассоциативный массив со свойствами текущего объекта
|
||
*/
|
||
public function toArray()
|
||
{
|
||
return $this->jsonSerialize();
|
||
}
|
||
|
||
#[\ReturnTypeWillChange]
|
||
/**
|
||
* Возвращает ассоциативный массив со свойствами текущего объекта для его дальнейшей JSON сериализации
|
||
* @return array Ассоциативный массив со свойствами текущего объекта
|
||
*/
|
||
public function jsonSerialize()
|
||
{
|
||
$result = array();
|
||
foreach (get_class_methods($this) as $method) {
|
||
if (strncmp('get', $method, 3) === 0) {
|
||
if ($method === 'getUnknownProperties') {
|
||
continue;
|
||
}
|
||
if ($method === 'getIterator') {
|
||
continue;
|
||
}
|
||
$property = strtolower(preg_replace('/[A-Z]/', '_\0', lcfirst(substr($method, 3))));
|
||
$value = $this->serializeValueToJson($this->{$method}());
|
||
if ($value !== null) {
|
||
$result[$property] = $value;
|
||
}
|
||
}
|
||
}
|
||
if (!empty($this->unknownProperties)) {
|
||
foreach ($this->unknownProperties as $property => $value) {
|
||
if (!array_key_exists($property, $result)) {
|
||
$result[$property] = $this->serializeValueToJson($value);
|
||
}
|
||
}
|
||
}
|
||
return $result;
|
||
}
|
||
|
||
private function serializeValueToJson($value)
|
||
{
|
||
if ($value === null || is_scalar($value)) {
|
||
return $value;
|
||
} elseif (is_array($value)) {
|
||
$array = array();
|
||
foreach ($value as $key => $item) {
|
||
$array[$key] = $this->serializeValueToJson($item);
|
||
}
|
||
return $array;
|
||
} elseif (is_object($value) && $value instanceof \JsonSerializable) {
|
||
return $value->jsonSerialize();
|
||
} elseif (is_object($value) && $value instanceof \DateTime) {
|
||
return $value->format(YOOKASSA_DATE);
|
||
}
|
||
return $value;
|
||
}
|
||
|
||
/**
|
||
* Возвращает массив свойств которые не существуют, но были заданы у объекта
|
||
* @return array Ассоциативный массив с не существующими у текущего объекта свойствами
|
||
*/
|
||
protected function getUnknownProperties()
|
||
{
|
||
return $this->unknownProperties;
|
||
}
|
||
|
||
/**
|
||
* Преобразует имя свойства из snake_case в camelCase
|
||
* @param string $property Преобразуемое значение
|
||
* @return string Значение в камэл кейсе
|
||
*/
|
||
private static function matchPropertyName($property)
|
||
{
|
||
return preg_replace('/_(\w)/', '\1', $property);
|
||
}
|
||
}
|