Server : Apache System : Linux server2.corals.io 4.18.0-348.2.1.el8_5.x86_64 #1 SMP Mon Nov 15 09:17:08 EST 2021 x86_64 User : corals ( 1002) PHP Version : 7.4.33 Disable Function : exec,passthru,shell_exec,system Directory : /home/corals/old/vendor/magento/framework/Webapi/Rest/Response/ |
<?php
/**
* Copyright © Magento, Inc. All rights reserved.
* See COPYING.txt for license details.
*/
namespace Magento\Framework\Webapi\Rest\Response;
use Magento\Framework\Api\AbstractExtensibleObject;
use Magento\Framework\Api\AttributeInterface;
use Magento\Framework\Webapi\Rest\Request as RestRequest;
/**
* Class to handle partial service response
*/
class FieldsFilter
{
const FILTER_PARAMETER = 'fields';
/**
* @var \Magento\Framework\Webapi\Rest\Request
*/
protected $_request;
/**
* Initialize dependencies
*
* @param RestRequest $request
*/
public function __construct(RestRequest $request)
{
$this->_request = $request;
}
/**
* Process filter from the request and apply over response to get the partial results
*
* @param array $response
* @return array partial response array or empty array if invalid filter criteria is provided
*/
public function filter($response)
{
$filter = $this->_request->getParam(self::FILTER_PARAMETER);
if (!is_string($filter)) {
return [];
}
$filterArray = $this->parse($filter);
if ($filterArray === null) {
return [];
}
$partialResponse = $this->applyFilter($response, $filterArray);
return $partialResponse;
}
/**
* Parse filter string into associative array. Field names are returned as keys with values for scalar fields as 1.
*
* @param string $filterString
* <pre>
* ex. customer[id,email],addresses[city,postcode,region[region_code,region]]
* </pre>
* @return array|null
* <pre>
* ex.
* array(
* 'customer' =>
* array(
* 'id' => 1,
* 'email' => 1,
* ),
* 'addresses' =>
* array(
* 'city' => 1,
* 'postcode' => 1,
* 'region' =>
* array(
* 'region_code' => 1,
* 'region' => 1,
* ),
* ),
* )
* </pre>
*
* @SuppressWarnings(PHPMD.CyclomaticComplexity)
*/
protected function parse($filterString)
{
$length = strlen($filterString);
//Permissible characters in filter string: letter, number, underscore, square brackets and comma
if ($length == 0 || preg_match('/[^\w\[\],]+/', $filterString)) {
return null;
}
$start = null;
$current = [];
$stack = [];
$parent = [];
$currentElement = null;
for ($position = 0; $position < $length; $position++) {
//Extracting field when encountering field separators
if (in_array($filterString[$position], ['[', ']', ','])) {
if ($start !== null) {
$currentElement = substr($filterString, $start, $position - $start);
$current[$currentElement] = 1;
}
$start = null;
}
switch ($filterString[$position]) {
case '[':
$parent[] = $currentElement;
// push current field in stack and initialize current
$stack[] = $current;
$current = [];
break;
case ']':
//cache current
$temp = $current;
//Initialize with previous
$current = array_pop($stack);
//Add from cache
$current[array_pop($parent)] = $temp;
break;
//Do nothing on comma. On the next iteration field will be extracted
case ',':
break;
default:
//Move position if no field separators found
if ($start === null) {
$start = $position;
}
}
}
//Check for wrongly formatted filter
if (!empty($stack)) {
return null;
}
//Check if there's any field remaining that's not added to response
if ($start !== null) {
$currentElement = substr($filterString, $start, $position - $start);
$current[$currentElement] = 1;
}
return $current;
}
/**
* Apply filter array
*
* @param array $responseArray
* @param array $filter
* @return array
*/
protected function applyFilter(array $responseArray, array $filter)
{
$arrayIntersect = null;
//Check if its a sequential array. Presence of sequential arrays mean that the filed is a collection
//and the filtering will be applied to all the collection items
if (!(bool)count(array_filter(array_keys($responseArray), 'is_string'))) {
foreach ($responseArray as $key => &$item) {
$arrayIntersect[$key] = $this->recursiveArrayIntersectKey($item, $filter);
}
} else {
$arrayIntersect = $this->recursiveArrayIntersectKey($responseArray, $filter);
}
return $arrayIntersect;
}
/**
* Recursively compute intersection of response and filter arrays
*
* @param array $array1
* @param array $array2
* @return array
*/
protected function recursiveArrayIntersectKey(array $array1, array $array2)
{
//If the field in array2 (filter) is not present in array1 (response) it will be removed after intersect
$arrayIntersect = array_intersect_key($array1, $array2);
foreach ($arrayIntersect as $key => &$value) {
if ($key == AbstractExtensibleObject::CUSTOM_ATTRIBUTES_KEY
&& is_array($array2[AbstractExtensibleObject::CUSTOM_ATTRIBUTES_KEY])
) {
$value = $this->filterCustomAttributes(
$value,
$array2[AbstractExtensibleObject::CUSTOM_ATTRIBUTES_KEY]
);
continue;
}
if (is_array($value) && is_array($array2[$key])) {
$value = $this->applyFilter($value, $array2[$key]);
}
}
return $arrayIntersect;
}
/**
* Filter for custom attributes.
*
* @param array $item
* @param array $filter
* @return array
*/
private function filterCustomAttributes(array $item, array $filter) : array
{
$fieldResult = [];
foreach ($item as $key => $field) {
$filterKeys = array_keys($filter);
if (in_array($field[AttributeInterface::ATTRIBUTE_CODE], $filterKeys)) {
$fieldResult[$key][AttributeInterface::ATTRIBUTE_CODE] = $field[AttributeInterface::ATTRIBUTE_CODE];
$fieldResult[$key][AttributeInterface::VALUE] = $field[AttributeInterface::VALUE];
} else {
if (isset($filter[AttributeInterface::ATTRIBUTE_CODE])) {
$fieldResult[$key][AttributeInterface::ATTRIBUTE_CODE] = $field[AttributeInterface::ATTRIBUTE_CODE];
}
if (isset($filter[AttributeInterface::VALUE])) {
$fieldResult[$key][AttributeInterface::VALUE] = $field[AttributeInterface::VALUE];
}
}
}
return $fieldResult;
}
}