Ð¤Ð°Ð¹Ð»Ð¾Ð²Ñ‹Ð¹ Ð¼ÐµÐ½ÐµÐ´Ð¶ÐµÑ€

Ð¤Ð°Ð¹Ð»Ð¾Ð²Ñ‹Ð¹ Ð¼ÐµÐ½ÐµÐ´Ð¶ÐµÑ€ - Ð ÐµÐ´Ð°ÐºÑ‚Ð¸Ñ€Ð¾Ð²Ð°Ñ‚ÑŒ - /home/easybachat/hisabat365.com/4a7891/fractal.zip

ÐÐ°Ð·Ð°Ð´
PK��1[��v�� .editorconfignu��[��root = true [] charset = utf-8 end_of_line = lf indent_size = 4 indent_style = space insert_final_newline = true trim_trailing_whitespace = true PK��1[��ZV��V��psalm.baseline.xmlnu��[��<?xml version="1.0" encoding="UTF-8"?> <files psalm-version="4.22.0@fc2c6ab4d5fa5d644d8617089f012f3bb84b8703"> <file src="src/Pagination/DoctrinePaginatorAdapter.php"> <InvalidNullableReturnType occurrences="1"> <code>int</code> </InvalidNullableReturnType> <NullableReturnStatement occurrences="1"> <code>$this->paginator->getQuery()->getMaxResults()</code> </NullableReturnStatement> </file> <file src="src/Pagination/IlluminatePaginatorAdapter.php"> <UndefinedInterfaceMethod occurrences="1"> <code>count</code> </UndefinedInterfaceMethod> </file> <file src="src/Scope.php"> <UndefinedInterfaceMethod occurrences="1"> <code>getMeta</code> </UndefinedInterfaceMethod> <UndefinedMethod occurrences="1"> <code>transform</code> </UndefinedMethod> </file> </files> PK��1[F w��w��phpstan.neon.distnu��[��includes: - ./phpstan-baseline.neon parameters: level: 5 reportUnmatchedIgnoredErrors: false paths: - src PK��1[�8:��&��src/Serializer/DataArraySerializer.phpnu��[��<?php / * This file is part of the League\Fractal package. * * (c) Phil Sturgeon <me@philsturgeon.uk> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace League\Fractal\Serializer; class DataArraySerializer extends ArraySerializer { /* * {@inheritDoc} / public function collection(?string $resourceKey, array $data): array { return ['data' => $data]; } /* * {@inheritDoc} / public function item(?string $resourceKey, array $data): array { return ['data' => $data]; } /* * {@inheritDoc} / public function null(): ?array { return ['data' => []]; } } PK��1[��src/Serializer/Serializer.phpnu��[��<?php namespace League\Fractal\Serializer; use League\Fractal\Pagination\CursorInterface; use League\Fractal\Pagination\PaginatorInterface; use League\Fractal\Resource\ResourceInterface; interface Serializer { /** * Serialize a collection. / public function collection(?string $resourceKey, array $data): array; /* * Serialize an item. / public function item(?string $resourceKey, array $data): array; /* * Serialize null resource. / public function null(): ?array; /* * Serialize the included data. / public function includedData(ResourceInterface $resource, array $data): array; /* * Serialize the meta. / public function meta(array $meta): array; /* * Serialize the paginator. / public function paginator(PaginatorInterface $paginator): array; /* * Serialize the cursor. / public function cursor(CursorInterface $cursor): array; public function mergeIncludes(array $transformedData, array $includedData): array; public function injectAvailableIncludeData(array $data, array $availableIncludes): array; /* * Indicates if includes should be side-loaded. / public function sideloadIncludes(): bool; /* * Hook for the serializer to inject custom data based on the relationships of the resource. / public function injectData(array $data, array $rawIncludedData): array; /* * Hook for the serializer to modify the final list of includes. / public function filterIncludes(array $includedData, array $data): array; /* * Get the mandatory fields for the serializer / public function getMandatoryFields(): array; } PK��1[_]q� �� "��src/Serializer/ArraySerializer.phpnu��[��<?php /* * This file is part of the League\Fractal package. * * (c) Phil Sturgeon <me@philsturgeon.uk> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace League\Fractal\Serializer; use League\Fractal\Pagination\CursorInterface; use League\Fractal\Pagination\PaginatorInterface; use League\Fractal\Resource\ResourceInterface; class ArraySerializer extends SerializerAbstract { /* * {@inheritDoc} / public function collection(?string $resourceKey, array $data): array { return [$resourceKey ?: 'data' => $data]; } /* * {@inheritDoc} / public function item(?string $resourceKey, array $data): array { return $data; } /* * {@inheritDoc} / public function null(): ?array { return []; } /* * {@inheritDoc} / public function includedData(ResourceInterface $resource, array $data): array { return $data; } /* * {@inheritDoc} / public function meta(array $meta): array { if (empty($meta)) { return []; } return ['meta' => $meta]; } /* * {@inheritDoc} / public function paginator(PaginatorInterface $paginator): array { $currentPage = $paginator->getCurrentPage(); $lastPage = $paginator->getLastPage(); $pagination = [ 'total' => $paginator->getTotal(), 'count' => $paginator->getCount(), 'per_page' => $paginator->getPerPage(), 'current_page' => $currentPage, 'total_pages' => $lastPage, ]; $pagination['links'] = []; if ($currentPage > 1) { $pagination['links']['previous'] = $paginator->getUrl($currentPage - 1); } if ($currentPage < $lastPage) { $pagination['links']['next'] = $paginator->getUrl($currentPage + 1); } if (empty($pagination['links'])) { $pagination['links'] = (object) []; } return ['pagination' => $pagination]; } /* * {@inheritDoc} / public function cursor(CursorInterface $cursor): array { $cursor = [ 'current' => $cursor->getCurrent(), 'prev' => $cursor->getPrev(), 'next' => $cursor->getNext(), 'count' => $cursor->getCount(), ]; return ['cursor' => $cursor]; } } PK��1[f=^:X��X��%��src/Serializer/SerializerAbstract.phpnu��[��<?php /* * This file is part of the League\Fractal package. * * (c) Phil Sturgeon <me@philsturgeon.uk> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace League\Fractal\Serializer; use League\Fractal\Pagination\CursorInterface; use League\Fractal\Pagination\PaginatorInterface; use League\Fractal\Resource\ResourceInterface; abstract class SerializerAbstract implements Serializer { /* * {@inheritDoc} / public function mergeIncludes(array $transformedData, array $includedData): array { // If the serializer does not want the includes to be side-loaded then // the included data must be merged with the transformed data. if (! $this->sideloadIncludes()) { return array_merge($transformedData, $includedData); } return $transformedData; } /* * {@inheritDoc} / public function sideloadIncludes(): bool { return false; } /* * {@inheritDoc} / public function injectData(array $data, array $rawIncludedData): array { return $data; } /* * {@inheritDoc} / public function injectAvailableIncludeData(array $data, array $availableIncludes): array { return $data; } /* * {@inheritDoc} / public function filterIncludes(array $includedData, array $data): array { return $includedData; } /* * {@inheritDoc} / public function getMandatoryFields(): array { return []; } } PK��1[g�{��:��:��$��src/Serializer/JsonApiSerializer.phpnu��[��<?php /* * This file is part of the League\Fractal package. * * (c) Phil Sturgeon <me@philsturgeon.uk> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace League\Fractal\Serializer; use InvalidArgumentException; use League\Fractal\Pagination\PaginatorInterface; use League\Fractal\Resource\ResourceInterface; class JsonApiSerializer extends ArraySerializer { protected ?string $baseUrl = null; protected array $rootObjects = []; public function __construct(?string $baseUrl = null) { $this->baseUrl = $baseUrl; } /* * {@inheritDoc} / public function collection(?string $resourceKey, array $data): array { $resources = []; foreach ($data as $resource) { $resources[] = $this->item($resourceKey, $resource)['data']; } return ['data' => $resources]; } /* * {@inheritDoc} / public function item(?string $resourceKey, array $data): array { $id = $this->getIdFromData($data); $resource = [ 'data' => [ 'type' => $resourceKey, 'id' => "$id", 'attributes' => $data, ], ]; unset($resource['data']['attributes']['id']); if (isset($resource['data']['attributes']['links'])) { $custom_links = $data['links']; unset($resource['data']['attributes']['links']); } if (isset($resource['data']['attributes']['meta'])) { $resource['data']['meta'] = $data['meta']; unset($resource['data']['attributes']['meta']); } if (empty($resource['data']['attributes'])) { $resource['data']['attributes'] = (object) []; } if ($this->shouldIncludeLinks()) { $resource['data']['links'] = [ 'self' => "{$this->baseUrl}/$resourceKey/$id", ]; if (isset($custom_links)) { $resource['data']['links'] = array_merge($resource['data']['links'], $custom_links); } } return $resource; } /* * {@inheritDoc} / public function paginator(PaginatorInterface $paginator): array { $currentPage = $paginator->getCurrentPage(); $lastPage = $paginator->getLastPage(); $pagination = [ 'total' => $paginator->getTotal(), 'count' => $paginator->getCount(), 'per_page' => $paginator->getPerPage(), 'current_page' => $currentPage, 'total_pages' => $lastPage, ]; $pagination['links'] = []; $pagination['links']['self'] = $paginator->getUrl($currentPage); $pagination['links']['first'] = $paginator->getUrl(1); if ($currentPage > 1) { $pagination['links']['prev'] = $paginator->getUrl($currentPage - 1); } if ($currentPage < $lastPage) { $pagination['links']['next'] = $paginator->getUrl($currentPage + 1); } $pagination['links']['last'] = $paginator->getUrl($lastPage); return ['pagination' => $pagination]; } /* * {@inheritDoc} / public function meta(array $meta): array { if (empty($meta)) { return []; } $result['meta'] = $meta; if (array_key_exists('pagination', $result['meta'])) { $result['links'] = $result['meta']['pagination']['links']; unset($result['meta']['pagination']['links']); } return $result; } /* * {@inheritDoc} / public function null(): ?array { return [ 'data' => null, ]; } /* * {@inheritDoc} / public function includedData(ResourceInterface $resource, array $data): array { list($serializedData, $linkedIds) = $this->pullOutNestedIncludedData($data); foreach ($data as $value) { foreach ($value as $includeObject) { if ($this->isNull($includeObject) \|\| $this->isEmpty($includeObject)) { continue; } $includeObjects = $this->createIncludeObjects($includeObject); list($serializedData, $linkedIds) = $this->serializeIncludedObjectsWithCacheKey( $includeObjects, $linkedIds, $serializedData ); } } return empty($serializedData) ? [] : ['included' => $serializedData]; } /* * {@inheritDoc} / public function sideloadIncludes(): bool { return true; } /* * {@inheritDoc} / public function injectData(array $data, array $rawIncludedData): array { $relationships = $this->parseRelationships($rawIncludedData); if (!empty($relationships)) { $data = $this->fillRelationships($data, $relationships); } return $data; } /* * {@inheritDoc} * * Hook to manipulate the final sideloaded includes. * The JSON API specification does not allow the root object to be included * into the sideloaded `included`-array. We have to make sure it is * filtered out, in case some object links to the root object in a * relationship. / public function filterIncludes(array $includedData, array $data): array { if (!isset($includedData['included'])) { return $includedData; } // Create the RootObjects $this->createRootObjects($data); // Filter out the root objects $filteredIncludes = array_filter($includedData['included'], [$this, 'filterRootObject']); // Reset array indizes $includedData['included'] = array_merge([], $filteredIncludes); return $includedData; } /* * {@inheritDoc} / public function getMandatoryFields(): array { return ['id']; } /* * Filter function to delete root objects from array. / protected function filterRootObject(array $object): bool { return !$this->isRootObject($object); } /* * Set the root objects of the JSON API tree. / protected function setRootObjects(array $objects = []): void { $this->rootObjects = array_map(function ($object) { return "{$object['type']}:{$object['id']}"; }, $objects); } /* * Determines whether an object is a root object of the JSON API tree. / protected function isRootObject(array $object): bool { $objectKey = "{$object['type']}:{$object['id']}"; return in_array($objectKey, $this->rootObjects); } protected function isCollection(array $data): bool { return array_key_exists('data', $data) && array_key_exists(0, $data['data']); } protected function isNull(array $data): bool { return array_key_exists('data', $data) && $data['data'] === null; } protected function isEmpty(array $data): bool { return array_key_exists('data', $data) && $data['data'] === []; } protected function fillRelationships(array $data, array $relationships): array { if ($this->isCollection($data)) { foreach ($relationships as $key => $relationship) { $data = $this->fillRelationshipAsCollection($data, $relationship, $key); } } else { // Single resource foreach ($relationships as $key => $relationship) { $data = $this->fillRelationshipAsSingleResource($data, $relationship, $key); } } return $data; } protected function parseRelationships(array $includedData): array { $relationships = []; foreach ($includedData as $key => $inclusion) { foreach ($inclusion as $includeKey => $includeObject) { $relationships = $this->buildRelationships($includeKey, $relationships, $includeObject, $key); if (isset($includedData[0][$includeKey]['meta'])) { $relationships[$includeKey][0]['meta'] = $includedData[0][$includeKey]['meta']; } } } return $relationships; } /* * @return mixed / #[\ReturnTypeWillChange] protected function getIdFromData(array $data) { if (!array_key_exists('id', $data)) { throw new InvalidArgumentException( 'JSON API resource objects MUST have a valid id' ); } return $data['id']; } /* * Keep all sideloaded inclusion data on the top level. / protected function pullOutNestedIncludedData(array $data): array { $includedData = []; $linkedIds = []; foreach ($data as $value) { foreach ($value as $includeObject) { if (isset($includeObject['included'])) { list($includedData, $linkedIds) = $this->serializeIncludedObjectsWithCacheKey( $includeObject['included'], $linkedIds, $includedData ); } } } return [$includedData, $linkedIds]; } /* * Whether or not the serializer should include `links` for resource objects. / protected function shouldIncludeLinks(): bool { return $this->baseUrl !== null; } /* * Check if the objects are part of a collection or not * * @param array\|object $includeObject / private function createIncludeObjects($includeObject): array { if ($this->isCollection($includeObject)) { $includeObjects = $includeObject['data']; return $includeObjects; } else { $includeObjects = [$includeObject['data']]; return $includeObjects; } } /* * Sets the RootObjects, either as collection or not. / private function createRootObjects(array $data): void { if ($this->isCollection($data)) { $this->setRootObjects($data['data']); } else { $this->setRootObjects([$data['data']]); } } /* * Loops over the relationships of the provided data and formats it / private function fillRelationshipAsCollection(array $data, array $relationship, string $key): array { foreach ($relationship as $index => $relationshipData) { $data['data'][$index]['relationships'][$key] = $relationshipData; } return $data; } private function fillRelationshipAsSingleResource(array $data, array $relationship, string $key): array { $data['data']['relationships'][$key] = $relationship[0]; return $data; } private function buildRelationships( string $includeKey, array $relationships, array $includeObject, string $key ): array { $relationships = $this->addIncludekeyToRelationsIfNotSet($includeKey, $relationships); if ($this->isNull($includeObject)) { $relationship = $this->null(); } elseif ($this->isEmpty($includeObject)) { $relationship = [ 'data' => [], ]; } elseif ($this->isCollection($includeObject)) { $relationship = ['data' => []]; $relationship = $this->addIncludedDataToRelationship($includeObject, $relationship); } else { $relationship = [ 'data' => [ 'type' => $includeObject['data']['type'], 'id' => $includeObject['data']['id'], ], ]; } $relationships[$includeKey][$key] = $relationship; return $relationships; } private function addIncludekeyToRelationsIfNotSet(string $includeKey, array $relationships): array { if (!array_key_exists($includeKey, $relationships)) { $relationships[$includeKey] = []; return $relationships; } return $relationships; } private function addIncludedDataToRelationship(array $includeObject, array $relationship): array { foreach ($includeObject['data'] as $object) { $relationship['data'][] = [ 'type' => $object['type'], 'id' => $object['id'], ]; } return $relationship; } /* * {@inheritdoc} / public function injectAvailableIncludeData(array $data, array $availableIncludes): array { if (!$this->shouldIncludeLinks()) { return $data; } if ($this->isCollection($data)) { $data['data'] = array_map(function ($resource) use ($availableIncludes) { foreach ($availableIncludes as $relationshipKey) { $resource = $this->addRelationshipLinks($resource, $relationshipKey); } return $resource; }, $data['data']); } else { foreach ($availableIncludes as $relationshipKey) { $data['data'] = $this->addRelationshipLinks($data['data'], $relationshipKey); } } return $data; } /* * Adds links for all available includes to a single resource. * * @param array $resource The resource to add relationship links to * @param string $relationshipKey The resource key of the relationship / private function addRelationshipLinks(array $resource, string $relationshipKey): array { if (!isset($resource['relationships']) \|\| !isset($resource['relationships'][$relationshipKey])) { $resource['relationships'][$relationshipKey] = []; } $resource['relationships'][$relationshipKey] = array_merge( [ 'links' => [ 'self' => "{$this->baseUrl}/{$resource['type']}/{$resource['id']}/relationships/{$relationshipKey}", 'related' => "{$this->baseUrl}/{$resource['type']}/{$resource['id']}/{$relationshipKey}", ] ], $resource['relationships'][$relationshipKey] ); return $resource; } private function serializeIncludedObjectsWithCacheKey( array $includeObjects, array $linkedIds, array $serializedData ): array { foreach ($includeObjects as $object) { $includeType = $object['type']; $includeId = $object['id']; $cacheKey = "$includeType:$includeId"; if (!array_key_exists($cacheKey, $linkedIds)) { $serializedData[] = $object; $linkedIds[$cacheKey] = $object; } } return [$serializedData, $linkedIds]; } } PK��1[��vsm��m��+��src/Pagination/DoctrinePaginatorAdapter.phpnu��[��<?php /* * This file is part of the League\Fractal package. * * (c) Phil Sturgeon <me@philsturgeon.uk> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace League\Fractal\Pagination; use Doctrine\ORM\Tools\Pagination\Paginator; /* * A paginator adapter for doctrine pagination. * * @author Fraser Stockley <fraser.stockley@gmail.com> / class DoctrinePaginatorAdapter implements PaginatorInterface { /* * The paginator instance. * @var Paginator / private $paginator; /* * The route generator. * * @var callable / private $routeGenerator; /* * Create a new DoctrinePaginatorAdapter. * @param Paginator $paginator * @param callable $routeGenerator * / public function __construct(Paginator $paginator, callable $routeGenerator) { $this->paginator = $paginator; $this->routeGenerator = $routeGenerator; } /* * {@inheritDoc} / public function getCurrentPage(): int { return (int) ($this->paginator->getQuery()->getFirstResult() / $this->paginator->getQuery()->getMaxResults()) + 1; } /* * {@inheritDoc} / public function getLastPage(): int { return (int) ceil($this->getTotal() / $this->paginator->getQuery()->getMaxResults()); } /* * {@inheritDoc} / public function getTotal(): int { return count($this->paginator); } /* * {@inheritDoc} / public function getCount(): int { return $this->paginator->getIterator()->count(); } /* * {@inheritDoc} / public function getPerPage(): int { return $this->paginator->getQuery()->getMaxResults(); } /* * {@inheritDoc} / public function getUrl(int $page): string { return call_user_func($this->getRouteGenerator(), $page); } /* * Get the the route generator. / private function getRouteGenerator(): callable { return $this->routeGenerator; } } PK��1[b��%��src/Pagination/PaginatorInterface.phpnu��[��<?php /* * This file is part of the League\Fractal package. * * (c) Phil Sturgeon <me@philsturgeon.uk> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace League\Fractal\Pagination; /* * A common interface for paginators to use * * @author Marc Addeo <marcaddeo@gmail.com> / interface PaginatorInterface { /* * Get the current page. / public function getCurrentPage(): int; /* * Get the last page. / public function getLastPage(): int; /* * Get the total. / public function getTotal(): int; /* * Get the count. / public function getCount(): int; /* * Get the number per page. / public function getPerPage(): int; /* * Get the url for the given page. / public function getUrl(int $page): string; } PK��1[&�- W��W��0��src/Pagination/ZendFrameworkPaginatorAdapter.phpnu��[��<?php /* * This file is part of the League\Fractal package. * * (c) Phil Sturgeon <me@philsturgeon.uk> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace League\Fractal\Pagination; use Zend\Paginator\Paginator; /* * A paginator adapter for zendframework/zend-paginator. * * @author Abdul Malik Ikhsan <samsonasik@gmail.com> / class ZendFrameworkPaginatorAdapter implements PaginatorInterface { protected Paginator $paginator; /* * The route generator. * * @var callable / protected $routeGenerator; public function __construct(Paginator $paginator, callable $routeGenerator) { $this->paginator = $paginator; $this->routeGenerator = $routeGenerator; } /* * {@inheritDoc} / public function getCurrentPage(): int { return $this->paginator->getCurrentPageNumber(); } /* * {@inheritDoc} / public function getLastPage(): int { return $this->paginator->count(); } /* * {@inheritDoc} / public function getTotal(): int { return $this->paginator->getTotalItemCount(); } /* * {@inheritDoc} / public function getCount(): int { return $this->paginator->getCurrentItemCount(); } /* * {@inheritDoc} / public function getPerPage(): int { return $this->paginator->getItemCountPerPage(); } /* * {@inheritDoc} / public function getUrl(int $page): string { return call_user_func($this->routeGenerator, $page); } public function getPaginator(): Paginator { return $this->paginator; } public function getRouteGenerator(): callable { return $this->routeGenerator; } } PK��1[�'�]��"��src/Pagination/CursorInterface.phpnu��[��<?php /* * This file is part of the League\Fractal package. * * (c) Phil Sturgeon <me@philsturgeon.uk> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace League\Fractal\Pagination; /* * A common interface for cursors to use. * * @author Isern Palaus <ipalaus@ipalaus.com> / interface CursorInterface { /* * Get the current cursor value. * * @return mixed / #[\ReturnTypeWillChange] public function getCurrent(); /* * Get the prev cursor value. * * @return mixed / #[\ReturnTypeWillChange] public function getPrev(); /* * Get the next cursor value. * * @return mixed / #[\ReturnTypeWillChange] public function getNext(); /* * Returns the total items in the current cursor. / public function getCount(): ?int; } PK��1[�Y�]��3��src/Pagination/PhalconFrameworkPaginatorAdapter.phpnu��[��<?php /* * This file is part of the League\Fractal package. * * (c) Phil Sturgeon <me@philsturgeon.uk> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace League\Fractal\Pagination; /* * A paginator adapter for PhalconPHP/pagination. * * @author Thien Tran <fcduythien@gmail.com> * @author Nikolaos Dimopoulos <nikos@phalconphp.com> / class PhalconFrameworkPaginatorAdapter implements PaginatorInterface { /* * A slice of the result set to show in the pagination / private \stdClass $paginator; public function __construct(\stdClass $paginator) { $this->paginator = $paginator; } /* * {@inheritDoc} / public function getCurrentPage(): int { return $this->paginator->current; } /* * {@inheritDoc} / public function getLastPage(): int { return $this->paginator->last; } /* * {@inheritDoc} / public function getTotal(): int { return $this->paginator->total_items; } /* * {@inheritDoc} / public function getCount(): int { return $this->paginator->total_pages; } /* * {@inheritDoc} / public function getPerPage(): int { // $this->paginator->items->count() // Because when we use raw sql have not this method return count($this->paginator->items); } /* * {@inheritDoc} / public function getNext(): int { return $this->paginator->next; } /* * {@inheritDoc} / public function getUrl(int $page): string { return (string) $page; } } PK��1[��\��-��src/Pagination/IlluminatePaginatorAdapter.phpnu��[��<?php /* * This file is part of the League\Fractal package. * * (c) Phil Sturgeon <me@philsturgeon.uk> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace League\Fractal\Pagination; use Illuminate\Contracts\Pagination\LengthAwarePaginator; /* * A paginator adapter for illuminate/pagination. * * @author Maxime Beaudoin <firalabs@gmail.com> * @author Marc Addeo <marcaddeo@gmail.com> / class IlluminatePaginatorAdapter implements PaginatorInterface { protected LengthAwarePaginator $paginator; /* * Create a new illuminate pagination adapter. / public function __construct(LengthAwarePaginator $paginator) { $this->paginator = $paginator; } /* * {@inheritDoc} / public function getCurrentPage(): int { return $this->paginator->currentPage(); } /* * {@inheritDoc} / public function getLastPage(): int { return $this->paginator->lastPage(); } /* * {@inheritDoc} / public function getTotal(): int { return $this->paginator->total(); } /* * {@inheritDoc} / public function getCount(): int { return $this->paginator->count(); } /* * {@inheritDoc} / public function getPerPage(): int { return $this->paginator->perPage(); } /* * {@inheritDoc} / public function getUrl(int $page): string { return $this->paginator->url($page); } /* * Get the paginator instance. / public function getPaginator(): LengthAwarePaginator { return $this->paginator; } } PK��1[a �E��E��-��src/Pagination/PagerfantaPaginatorAdapter.phpnu��[��<?php /* * This file is part of the League\Fractal package. * * (c) Phil Sturgeon <me@philsturgeon.uk> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace League\Fractal\Pagination; use Pagerfanta\Pagerfanta; /* * A paginator adapter for pagerfanta/pagerfanta. * * @author Márk Sági-Kazár <mark.sagikazar@gmail.com> / class PagerfantaPaginatorAdapter implements PaginatorInterface { protected Pagerfanta $paginator; /* * The route generator. * * @var callable / protected $routeGenerator; public function __construct(Pagerfanta $paginator, callable $routeGenerator) { $this->paginator = $paginator; $this->routeGenerator = $routeGenerator; } /* * {@inheritDoc} / public function getCurrentPage(): int { return $this->paginator->getCurrentPage(); } /* * {@inheritDoc} / public function getLastPage(): int { return $this->paginator->getNbPages(); } /* * {@inheritDoc} / public function getTotal(): int { return count($this->paginator); } /* * {@inheritDoc} / public function getCount(): int { return count($this->paginator->getCurrentPageResults()); } /* * {@inheritDoc} / public function getPerPage(): int { return $this->paginator->getMaxPerPage(); } /* * {@inheritDoc} / public function getUrl(int $page): string { return call_user_func($this->routeGenerator, $page); } public function getPaginator(): Pagerfanta { return $this->paginator; } public function getRouteGenerator(): callable { return $this->routeGenerator; } } PK��1[A�c�� src/Pagination/Cursor.phpnu��[��<?php /* * This file is part of the League\Fractal package. * * (c) Phil Sturgeon <me@philsturgeon.uk> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace League\Fractal\Pagination; /* * A generic cursor adapter. * * @author Isern Palaus <ipalaus@ipalaus.com> * @author Michele Massari <michele@michelemassari.net> / class Cursor implements CursorInterface { /* * Current cursor value. * * @var mixed / protected $current; /* * Previous cursor value. * * @var mixed / protected $prev; /* * Next cursor value. * * @var mixed / protected $next; /* * Items being held for the current cursor position. / protected ?int $count; /* * Create a new Cursor instance. * * @param mixed $current * @param mixed $prev * @param mixed $next / public function __construct($current = null, $prev = null, $next = null, ?int $count = null) { $this->current = $current; $this->prev = $prev; $this->next = $next; $this->count = $count; } /* * {@inheritDoc} / #[\ReturnTypeWillChange] public function getCurrent() { return $this->current; } /* * Set the current cursor value. * * @param mixed $current / public function setCurrent($current): self { $this->current = $current; return $this; } /* * {@inheritDoc} / #[\ReturnTypeWillChange] public function getPrev() { return $this->prev; } /* * Set the prev cursor value. * * @param mixed $prev / public function setPrev($prev): self { $this->prev = $prev; return $this; } /* * {@inheritDoc} / #[\ReturnTypeWillChange] public function getNext() { return $this->next; } /* * Set the next cursor value. * * @param mixed $next / public function setNext($next): self { $this->next = $next; return $this; } /* * {@inheritDoc} / public function getCount(): ?int { return $this->count; } /* * Set the total items in the current cursor. / public function setCount(int $count): self { $this->count = $count; return $this; } } PK��1[��\|�5��5�� src/Scope.phpnu��[��<?php /* * This file is part of the League\Fractal package. * * (c) Phil Sturgeon <me@philsturgeon.uk> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace League\Fractal; use InvalidArgumentException; use League\Fractal\Resource\Collection; use League\Fractal\Resource\Item; use League\Fractal\Resource\Primitive; use League\Fractal\Resource\NullResource; use League\Fractal\Resource\ResourceInterface; use League\Fractal\Serializer\Serializer; / * Scope * * The scope class acts as a tracker, relating a specific resource in a specific * context. For example, the same resource could be attached to multiple scopes. * There are root scopes, parent scopes and child scopes. / class Scope implements \JsonSerializable { protected array $availableIncludes = []; protected ?string $scopeIdentifier; protected Manager $manager; protected ResourceInterface $resource; protected array $parentScopes = []; public function __construct(Manager $manager, ResourceInterface $resource, ?string $scopeIdentifier = null) { $this->manager = $manager; $this->resource = $resource; $this->scopeIdentifier = $scopeIdentifier; } /* * Embed a scope as a child of the current scope. * * @internal / public function embedChildScope(string $scopeIdentifier, ResourceInterface $resource): Scope { return $this->manager->createData($resource, $scopeIdentifier, $this); } /* * Get the current identifier. / public function getScopeIdentifier(): ?string { return $this->scopeIdentifier; } /* * Get the unique identifier for this scope. / public function getIdentifier(?string $appendIdentifier = null): string { $identifierParts = array_merge($this->parentScopes, [$this->scopeIdentifier, $appendIdentifier]); return implode('.', array_filter($identifierParts)); } /* * @return mixed / #[\ReturnTypeWillChange] public function getParentScopes() { return $this->parentScopes; } public function getResource(): ResourceInterface { return $this->resource; } public function getManager(): Manager { return $this->manager; } /* * Check if - in relation to the current scope - this specific segment is allowed. * That means, if a.b.c is requested and the current scope is a.b, then c is allowed. If the current * scope is a then c is not allowed, even if it is there and potentially transformable. * * @internal * * @return bool Returns the new number of elements in the array. / public function isRequested(string $checkScopeSegment): bool { if ($this->parentScopes) { $scopeArray = array_slice($this->parentScopes, 1); array_push($scopeArray, $this->scopeIdentifier, $checkScopeSegment); } else { $scopeArray = [$checkScopeSegment]; } $scopeString = implode('.', $scopeArray); return in_array($scopeString, $this->manager->getRequestedIncludes()); } /* * Check if - in relation to the current scope - this specific segment should * be excluded. That means, if a.b.c is excluded and the current scope is a.b, * then c will not be allowed in the transformation whether it appears in * the list of default or available, requested includes. * * @internal / public function isExcluded(string $checkScopeSegment): bool { if ($this->parentScopes) { $scopeArray = array_slice($this->parentScopes, 1); array_push($scopeArray, $this->scopeIdentifier, $checkScopeSegment); } else { $scopeArray = [$checkScopeSegment]; } $scopeString = implode('.', $scopeArray); return in_array($scopeString, $this->manager->getRequestedExcludes()); } /* * Push Parent Scope. * * Push a scope identifier into parentScopes * * @internal * * @return int Returns the new number of elements in the array. / public function pushParentScope(string $identifierSegment): int { return array_push($this->parentScopes, $identifierSegment); } /* * Set parent scopes. * * @internal * * @param string[] $parentScopes Value to set. / public function setParentScopes(array $parentScopes): self { $this->parentScopes = $parentScopes; return $this; } /* * Convert the current data for this scope to an array. / public function toArray(): ?array { list($rawData, $rawIncludedData) = $this->executeResourceTransformers(); $serializer = $this->manager->getSerializer(); $data = $this->serializeResource($serializer, $rawData); // If the serializer wants the includes to be side-loaded then we'll // serialize the included data and merge it with the data. if ($serializer->sideloadIncludes()) { //Filter out any relation that wasn't requested $rawIncludedData = array_map(array($this, 'filterFieldsets'), $rawIncludedData); $includedData = $serializer->includedData($this->resource, $rawIncludedData); // If the serializer wants to inject additional information // about the included resources, it can do so now. $data = $serializer->injectData($data, $rawIncludedData); if ($this->isRootScope()) { // If the serializer wants to have a final word about all // the objects that are sideloaded, it can do so now. $includedData = $serializer->filterIncludes( $includedData, $data ); } $data = $data + $includedData; } if (!empty($this->availableIncludes)) { $data = $serializer->injectAvailableIncludeData($data, $this->availableIncludes); } if ($this->resource instanceof Collection) { if ($this->resource->hasCursor()) { $pagination = $serializer->cursor($this->resource->getCursor()); } elseif ($this->resource->hasPaginator()) { $pagination = $serializer->paginator($this->resource->getPaginator()); } if (! empty($pagination)) { $this->resource->setMetaValue(key($pagination), current($pagination)); } } // Pull out all of OUR metadata and any custom meta data to merge with the main level data $meta = $serializer->meta($this->resource->getMeta()); // in case of returning NullResource we should return null and not to go with array_merge if (is_null($data)) { if (!empty($meta)) { return $meta; } return null; } return $data + $meta; } /* * @return mixed / #[\ReturnTypeWillChange] public function jsonSerialize() { return $this->toArray(); } /* * Convert the current data for this scope to JSON. / public function toJson(int $options = 0): string { return \json_encode($this, $options); } /* * Transformer a primitive resource * * @return mixed / #[\ReturnTypeWillChange] public function transformPrimitiveResource() { if (! ($this->resource instanceof Primitive)) { throw new InvalidArgumentException( 'Argument $resource should be an instance of League\Fractal\Resource\Primitive' ); } $transformer = $this->resource->getTransformer(); $data = $this->resource->getData(); if (null === $transformer) { $transformedData = $data; } elseif (is_callable($transformer)) { $transformedData = call_user_func($transformer, $data); } else { $transformer->setCurrentScope($this); $transformedData = $transformer->transform($data); } return $transformedData; } /* * Execute the resources transformer and return the data and included data. * * @internal / protected function executeResourceTransformers(): array { $transformer = $this->resource->getTransformer(); $data = $this->resource->getData(); $transformedData = $includedData = []; if ($this->resource instanceof Item) { list($transformedData, $includedData[]) = $this->fireTransformer($transformer, $data); } elseif ($this->resource instanceof Collection) { foreach ($data as $value) { list($transformedData[], $includedData[]) = $this->fireTransformer($transformer, $value); } } elseif ($this->resource instanceof NullResource) { $transformedData = null; $includedData = []; } else { throw new InvalidArgumentException( 'Argument $resource should be an instance of League\Fractal\Resource\Item' .' or League\Fractal\Resource\Collection' ); } return [$transformedData, $includedData]; } /* * Serialize a resource * * @internal * * @param mixed $data / protected function serializeResource(Serializer $serializer, $data): ?array { $resourceKey = $this->resource->getResourceKey(); if ($this->resource instanceof Collection) { if (!empty($resourceKey)) { return $serializer->collection($resourceKey, $data); } return $serializer->collection(null, $data); } if ($this->resource instanceof Item) { // this is where it breaks now. if (!empty($resourceKey)) { return $serializer->item($resourceKey, $data); } return $serializer->item(null, $data); } return $serializer->null(); } /* * Fire the main transformer. * * @internal * * @param TransformerAbstract\|callable $transformer * @param mixed $data / protected function fireTransformer($transformer, $data): array { $includedData = []; if (is_callable($transformer)) { $transformedData = call_user_func($transformer, $data); } else { $transformer->setCurrentScope($this); $transformedData = $transformer->transform($data); } if ($this->transformerHasIncludes($transformer)) { $includedData = $this->fireIncludedTransformers($transformer, $data); $transformedData = $this->manager->getSerializer()->mergeIncludes($transformedData, $includedData); } //Stick only with requested fields $transformedData = $this->filterFieldsets($transformedData); return [$transformedData, $includedData]; } /* * Fire the included transformers. * * @internal * * @param \League\Fractal\TransformerAbstract $transformer * @param mixed $data / protected function fireIncludedTransformers($transformer, $data): array { $this->availableIncludes = $transformer->getAvailableIncludes(); return $transformer->processIncludedResources($this, $data) ?: []; } /* * Determine if a transformer has any available includes. * * @internal * * @param TransformerAbstract\|callable $transformer / protected function transformerHasIncludes($transformer): bool { if (! $transformer instanceof TransformerAbstract) { return false; } $defaultIncludes = $transformer->getDefaultIncludes(); $availableIncludes = $transformer->getAvailableIncludes(); return ! empty($defaultIncludes) \|\| ! empty($availableIncludes); } /* * Check, if this is the root scope. / protected function isRootScope(): bool { return empty($this->parentScopes); } /* * Filter the provided data with the requested filter fieldset for * the scope resource * * @internal / protected function filterFieldsets(array $data): array { if (!$this->hasFilterFieldset()) { return $data; } $serializer = $this->manager->getSerializer(); $requestedFieldset = iterator_to_array($this->getFilterFieldset()); //Build the array of requested fieldsets with the mandatory serializer fields $filterFieldset = array_flip( array_merge( $serializer->getMandatoryFields(), $requestedFieldset ) ); return array_intersect_key($data, $filterFieldset); } /* * Return the requested filter fieldset for the scope resource * * @internal / protected function getFilterFieldset(): ?ParamBag { return $this->manager->getFieldset($this->getResourceType()); } /* * Check if there are requested filter fieldsets for the scope resource. * * @internal / protected function hasFilterFieldset(): bool { return $this->getFilterFieldset() !== null; } /* * Return the scope resource type. * * @internal / protected function getResourceType(): string { return $this->resource->getResourceKey(); } } PK��1[�kUs��src/Resource/NullResource.phpnu��[��<?php /* * This file is part of the League\Fractal package. * * (c) Phil Sturgeon <me@philsturgeon.uk> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace League\Fractal\Resource; /* * The Null Resource represents a resource that doesn't exist. This can be * useful to indicate that a certain relationship is null in some output * formats (e.g. JSON API), which require even a relationship that is null at * the moment to be listed. / class NullResource extends ResourceAbstract { /* * Get the data. * * @return mixed / #[\ReturnTypeWillChange] public function getData() { // Null has no data associated with it. return null; } } PK��1[(��src/Resource/Primitive.phpnu��[��<?php /* * This file is part of the League\Fractal package. * * (c) Phil Sturgeon <me@philsturgeon.uk> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace League\Fractal\Resource; /* * Primitive Resource * * The Primitive Resource can store any primitive data, like a string, integer, * float, double etc. / class Primitive extends ResourceAbstract { } PK��1[u�?d��src/Resource/Item.phpnu��[��<?php /* * This file is part of the League\Fractal package. * * (c) Phil Sturgeon <me@philsturgeon.uk> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace League\Fractal\Resource; /* * The Item Resource can store any mixed data, usually an ORM, ODM or * other sort of intelligent result, DataMapper model, etc but could * be a basic array, object, or whatever you like. / class Item extends ResourceAbstract { } PK��1[ u&%0��0��!��src/Resource/ResourceAbstract.phpnu��[��<?php /* * This file is part of the League\Fractal package. * * (c) Phil Sturgeon <me@philsturgeon.uk> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace League\Fractal\Resource; use League\Fractal\TransformerAbstract; abstract class ResourceAbstract implements ResourceInterface { /* * Any item to process. * * @var mixed / protected $data; /* * Array of meta data. / protected array $meta = []; /* * The resource key. / protected ?string $resourceKey; /* * A callable to process the data attached to this resource. * * @var callable\|TransformerAbstract\|null / protected $transformer; /* * @param mixed $data * @param callable\|TransformerAbstract\|null $transformer / public function __construct($data = null, $transformer = null, ?string $resourceKey = null) { $this->data = $data; $this->transformer = $transformer; $this->resourceKey = $resourceKey; } /* * Get the data. * * @return mixed / #[\ReturnTypeWillChange] public function getData() { return $this->data; } /* * Set the data. * * @param mixed $data / public function setData($data): self { $this->data = $data; return $this; } /* * Get the meta data. / public function getMeta(): array { return $this->meta; } /* * Get the meta data. * * @return mixed / #[\ReturnTypeWillChange] public function getMetaValue(string $metaKey) { return $this->meta[$metaKey]; } public function getResourceKey(): string { return $this->resourceKey ?? ''; } /* * Get the transformer. * * @return callable\|TransformerAbstract\|null / public function getTransformer() { return $this->transformer; } /* * Set the transformer. * * @param callable\|TransformerAbstract $transformer / public function setTransformer($transformer): self { $this->transformer = $transformer; return $this; } /* * Set the meta data. / public function setMeta(array $meta): self { $this->meta = $meta; return $this; } /* * Set one meta data value. * * @param mixed $metaValue / public function setMetaValue(string $metaKey, $metaValue): self { $this->meta[$metaKey] = $metaValue; return $this; } public function setResourceKey(string $resourceKey): self { $this->resourceKey = $resourceKey; return $this; } } PK��1[H��+ �� "��src/Resource/ResourceInterface.phpnu��[��<?php /* * This file is part of the League\Fractal package. * * (c) Phil Sturgeon <me@philsturgeon.uk> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace League\Fractal\Resource; interface ResourceInterface { /* * Get the resource key. / public function getResourceKey(): string; /* * Get the data. * * @return mixed / #[\ReturnTypeWillChange] public function getData(); /* * Get the transformer. * * @return callable\|\League\Fractal\TransformerAbstract\|null / public function getTransformer(); /* * Set the data. * * @param mixed $data / public function setData($data): self; /* * Set the transformer. * * @param callable\|\League\Fractal\TransformerAbstract $transformer / public function setTransformer($transformer): self; /* * Get the meta data. / public function getMeta(): array; } PK��1[�:�B��src/Resource/Collection.phpnu��[��<?php /* * This file is part of the League\Fractal package. * * (c) Phil Sturgeon <me@philsturgeon.uk> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace League\Fractal\Resource; use ArrayIterator; use League\Fractal\Pagination\CursorInterface; use League\Fractal\Pagination\PaginatorInterface; /* * Resource Collection * * The data can be a collection of any sort of data, as long as the * "collection" is either array or an object implementing ArrayIterator. / class Collection extends ResourceAbstract { /* * A collection of data. * * @var array\|ArrayIterator / protected $data; protected ?PaginatorInterface $paginator = null; protected ?CursorInterface $cursor = null; public function getPaginator(): ?PaginatorInterface { return $this->paginator; } /* * Determine if the resource has a paginator implementation. / public function hasPaginator(): bool { return $this->paginator !== null; } /* * Get the cursor instance. / public function getCursor(): ?CursorInterface { return $this->cursor; } /* * Determine if the resource has a cursor implementation. / public function hasCursor(): bool { return $this->cursor !== null; } public function setPaginator(PaginatorInterface $paginator): self { $this->paginator = $paginator; return $this; } public function setCursor(CursorInterface $cursor): self { $this->cursor = $cursor; return $this; } } PK��1[��X��src/TransformerAbstract.phpnu��[��<?php /* * This file is part of the League\Fractal package. * * (c) Phil Sturgeon <me@philsturgeon.uk> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace League\Fractal; use League\Fractal\Resource\Collection; use League\Fractal\Resource\Item; use League\Fractal\Resource\NullResource; use League\Fractal\Resource\Primitive; use League\Fractal\Resource\ResourceInterface; /* * All Transformer classes should extend this to utilize the convenience methods * collection() and item(), and make the self::$availableIncludes property available. * Extend it and add a `transform()` method to transform any default or included data * into a basic array. / abstract class TransformerAbstract { /* * Resources that can be included if requested. / protected array $availableIncludes = []; /* * Include resources without needing it to be requested. / protected array $defaultIncludes = []; /* * The transformer should know about the current scope, so we can fetch relevant params. / protected ?Scope $currentScope = null; /* * Getter for availableIncludes. / public function getAvailableIncludes(): array { return $this->availableIncludes; } /* * Getter for defaultIncludes. / public function getDefaultIncludes(): array { return $this->defaultIncludes; } /* * Getter for currentScope. / public function getCurrentScope(): ?Scope { return $this->currentScope; } /* * Figure out which includes we need. / private function figureOutWhichIncludes(Scope $scope): array { $includes = $this->getDefaultIncludes(); foreach ($this->getAvailableIncludes() as $include) { if ($scope->isRequested($include)) { $includes[] = $include; } } foreach ($includes as $include) { if ($scope->isExcluded($include)) { $includes = array_diff($includes, [$include]); } } return $includes; } /* * This method is fired to loop through available includes, see if any of * them are requested and permitted for this scope. * * @internal * * @param mixed $data * * @return array\|false / public function processIncludedResources(Scope $scope, $data) { $includedData = []; $includes = $this->figureOutWhichIncludes($scope); foreach ($includes as $include) { $includedData = $this->includeResourceIfAvailable( $scope, $data, $includedData, $include ); } return $includedData === [] ? false : $includedData; } /* * Include a resource only if it is available on the method. * * @param mixed $data / private function includeResourceIfAvailable( Scope $scope, $data, array $includedData, string $include ): array { if ($resource = $this->callIncludeMethod($scope, $include, $data)) { $childScope = $scope->embedChildScope($include, $resource); if ($childScope->getResource() instanceof Primitive) { $includedData[$include] = $childScope->transformPrimitiveResource(); } else { $includedData[$include] = $childScope->toArray(); } } return $includedData; } /* * Call Include Method. * * @internal * * @param mixed $data * * @throws \Exception * * @return \League\Fractal\Resource\ResourceInterface\|false / protected function callIncludeMethod(Scope $scope, string $includeName, $data) { $scopeIdentifier = $scope->getIdentifier($includeName); $params = $scope->getManager()->getIncludeParams($scopeIdentifier); // Check if the method name actually exists $methodName = 'include'.str_replace( ' ', '', ucwords(str_replace( '_', ' ', str_replace( '-', ' ', $includeName ) )) ); $resource = call_user_func([$this, $methodName], $data, $params); if ($resource === null) { return false; } if (! $resource instanceof ResourceInterface) { throw new \Exception(sprintf( 'Invalid return value from %s::%s(). Expected %s, received %s.', __CLASS__, $methodName, 'League\Fractal\Resource\ResourceInterface', is_object($resource) ? get_class($resource) : gettype($resource) )); } return $resource; } /* * Setter for availableIncludes. / public function setAvailableIncludes(array $availableIncludes): self { $this->availableIncludes = $availableIncludes; return $this; } /* * Setter for defaultIncludes. / public function setDefaultIncludes(array $defaultIncludes): self { $this->defaultIncludes = $defaultIncludes; return $this; } /* * Setter for currentScope. / public function setCurrentScope(Scope $currentScope): self { $this->currentScope = $currentScope; return $this; } /* * Create a new primitive resource object. * * @param mixed $data * @param callable\|null $transformer / protected function primitive($data, ?callable $transformer = null, ?string $resourceKey = null): Primitive { return new Primitive($data, $transformer, $resourceKey); } /* * Create a new item resource object. * * @param mixed $data * @param TransformerAbstract\|callable $transformer / protected function item($data, $transformer, ?string $resourceKey = null): Item { return new Item($data, $transformer, $resourceKey); } /* * Create a new collection resource object. * * @param mixed $data * @param TransformerAbstract\|callable $transformer / protected function collection($data, $transformer, ?string $resourceKey = null): Collection { return new Collection($data, $transformer, $resourceKey); } /* * Create a new null resource object. / protected function null(): NullResource { return new NullResource(); } } PK��1[�?t�O��O��src/ParamBag.phpnu��[��<?php /* * This file is part of the League\Fractal package. * * (c) Phil Sturgeon <me@philsturgeon.uk> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace League\Fractal; /* * A handy interface for getting at include parameters. / class ParamBag implements \ArrayAccess, \IteratorAggregate { protected array $params = []; /* * Create a new parameter bag instance. / public function __construct(array $params) { $this->params = $params; } /* * Get parameter values out of the bag. * * @return mixed / #[\ReturnTypeWillChange] public function get(string $key) { return $this->__get($key); } /* * Get parameter values out of the bag via the property access magic method. * * @return mixed / #[\ReturnTypeWillChange] public function __get(string $key) { return isset($this->params[$key]) ? $this->params[$key] : null; } /* * Check if a param exists in the bag via an isset() check on the property. / public function __isset(string $key): bool { return isset($this->params[$key]); } /* * Disallow changing the value of params in the data bag via property access. * * @param mixed $value * * @throws \LogicException / public function __set(string $key, $value): void { throw new \LogicException('Modifying parameters is not permitted'); } /* * Disallow unsetting params in the data bag via property access. * * @throws \LogicException * * @return void / public function __unset(string $key): void { throw new \LogicException('Modifying parameters is not permitted'); } /* * Check if a param exists in the bag via an isset() and array access. * * @param string $key / public function offsetExists($key): bool { return $this->__isset($key); } /* * Get parameter values out of the bag via array access. * * @param string $key * * @return mixed / #[\ReturnTypeWillChange] public function offsetGet($key) { return $this->__get($key); } /* * Disallow changing the value of params in the data bag via array access. * * @param string $key * @param mixed $value * * @throws \LogicException / public function offsetSet($key, $value): void { throw new \LogicException('Modifying parameters is not permitted'); } /* * Disallow unsetting params in the data bag via array access. * * @param string $key * * @throws \LogicException / public function offsetUnset($key): void { throw new \LogicException('Modifying parameters is not permitted'); } /* * IteratorAggregate for iterating over the object like an array. / public function getIterator(): \ArrayIterator { return new \ArrayIterator($this->params); } } PK��1[k�+��src/ScopeFactoryInterface.phpnu��[��<?php /* * This file is part of the League\Fractal package. * * (c) Phil Sturgeon <me@philsturgeon.uk> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace League\Fractal; use League\Fractal\Resource\ResourceInterface; /* * Creates Scope Instances for resources / interface ScopeFactoryInterface { public function createScopeFor( Manager $manager, ResourceInterface $resource, ?string $scopeIdentifier = null ): Scope; public function createChildScopeFor( Manager $manager, Scope $parentScope, ResourceInterface $resource, ?string $scopeIdentifier = null ): Scope; } PK��1[?��src/ScopeFactory.phpnu��[��<?php /* * This file is part of the League\Fractal package. * * (c) Phil Sturgeon <me@philsturgeon.uk> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace League\Fractal; use League\Fractal\Resource\ResourceInterface; class ScopeFactory implements ScopeFactoryInterface { public function createScopeFor( Manager $manager, ResourceInterface $resource, ?string $scopeIdentifier = null ): Scope { return new Scope($manager, $resource, $scopeIdentifier); } public function createChildScopeFor( Manager $manager, Scope $parentScope, ResourceInterface $resource, ?string $scopeIdentifier = null ): Scope { $scopeInstance = $this->createScopeFor($manager, $resource, $scopeIdentifier); // This will be the new children list of parents (parents parents, plus the parent) $scopeArray = $parentScope->getParentScopes(); $scopeArray[] = $parentScope->getScopeIdentifier(); $scopeInstance->setParentScopes($scopeArray); return $scopeInstance; } } PK��1[�Ccg"��g"��src/Manager.phpnu��[��<?php /* * This file is part of the League\Fractal package. * * (c) Phil Sturgeon <me@philsturgeon.uk> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace League\Fractal; use League\Fractal\Resource\ResourceInterface; use League\Fractal\Serializer\DataArraySerializer; use League\Fractal\Serializer\Serializer; /* * Manager * * Not a wildly creative name, but the manager is what a Fractal user will interact * with the most. The manager has various configurable options, and allows users * to create the "root scope" easily. / class Manager { /* * Array of scope identifiers for resources to include. / protected array $requestedIncludes = []; /* * Array of scope identifiers for resources to exclude. / protected array $requestedExcludes = []; /* * Array of requested fieldsets. / protected array $requestedFieldsets = []; /* * Array containing modifiers as keys and an array value of params. / protected array $includeParams = []; /* * The character used to separate modifier parameters. / protected string $paramDelimiter = '\|'; /* * Upper limit to how many levels of included data are allowed. / protected int $recursionLimit = 10; protected ?Serializer $serializer = null; /* * Factory used to create new configured scopes. / private ScopeFactoryInterface $scopeFactory; public function __construct(ScopeFactoryInterface $scopeFactory = null) { $this->scopeFactory = $scopeFactory ?: new ScopeFactory(); } /* * Main method to kick this all off. Make a resource then pass it over, and use toArray() / public function createData( ResourceInterface $resource, ?string $scopeIdentifier = null, Scope $parentScopeInstance = null ): Scope { if ($parentScopeInstance !== null) { return $this->scopeFactory->createChildScopeFor($this, $parentScopeInstance, $resource, $scopeIdentifier); } return $this->scopeFactory->createScopeFor($this, $resource, $scopeIdentifier); } public function getIncludeParams(string $include): ParamBag { $params = isset($this->includeParams[$include]) ? $this->includeParams[$include] : []; return new ParamBag($params); } public function getRequestedIncludes(): array { return $this->requestedIncludes; } public function getRequestedExcludes(): array { return $this->requestedExcludes; } public function getSerializer(): Serializer { if (! $this->serializer) { $this->serializer = new DataArraySerializer(); } return $this->serializer; } /* * @param array\|string $includes Array or csv string of resources to include / public function parseIncludes($includes): self { // Wipe these before we go again $this->requestedIncludes = $this->includeParams = []; $subRelations = ''; if (is_string($includes)) { $includes = explode(',', $includes); } if (! is_array($includes)) { throw new \InvalidArgumentException( 'The parseIncludes() method expects a string or an array. '.gettype($includes).' given' ); } foreach ($includes as $include) { list($includeName, $allModifiersStr) = array_pad(explode(':', $include, 2), 2, ''); $a = $allModifiersStr ? explode('.', $allModifiersStr, 2) : ['']; list($allModifiersStr, $subRelations) = array_pad($a, 2, null); // Trim it down to a cool level of recursion $includeName = $this->trimToAcceptableRecursionLevel($includeName); if (in_array($includeName, $this->requestedIncludes)) { continue; } $this->requestedIncludes[] = $includeName; // No Params? Bored if ($allModifiersStr === null) { continue; } // Matches multiple instances of 'something(foo\|bar\|baz)' in the string // I guess it ignores : so you could use anything, but probably don't do that preg_match_all('/([\w]+)($([^$]+)\))?/', $allModifiersStr, $allModifiersArr); // [0] is full matched strings... $modifierCount = count($allModifiersArr[0]); $modifierArr = []; for ($modifierIt = 0; $modifierIt < $modifierCount; $modifierIt++) { // [1] is the modifier $modifierName = $allModifiersArr[1][$modifierIt]; // and [3] is delimited params $modifierParamStr = $allModifiersArr[3][$modifierIt]; // Make modifier array key with an array of params as the value $modifierArr[$modifierName] = explode($this->paramDelimiter, $modifierParamStr); } $this->includeParams[$includeName] = $modifierArr; if ($subRelations) { $this->requestedIncludes[] = $this->trimToAcceptableRecursionLevel($includeName . '.' . $subRelations); } } // This should be optional and public someday, but without it includes would never show up $this->autoIncludeParents(); return $this; } /* * Parse field parameter. * * @param array $fieldsets Array of fields to include. It must be an array whose keys * are resource types and values an array or a string * of the fields to return, separated by a comma / public function parseFieldsets(array $fieldsets): self { $this->requestedFieldsets = []; foreach ($fieldsets as $type => $fields) { if (is_string($fields)) { $fields = explode(',', $fields); } //Remove empty and repeated fields $this->requestedFieldsets[$type] = array_unique(array_filter($fields)); } return $this; } public function getRequestedFieldsets(): array { return $this->requestedFieldsets; } /* * Get fieldset params for the specified type. / public function getFieldset(string $type): ?ParamBag { return !isset($this->requestedFieldsets[$type]) ? null : new ParamBag($this->requestedFieldsets[$type]); } /* * @param array\|string $excludes Array or csv string of resources to exclude / public function parseExcludes($excludes): self { $this->requestedExcludes = []; if (is_string($excludes)) { $excludes = explode(',', $excludes); } if (! is_array($excludes)) { throw new \InvalidArgumentException( 'The parseExcludes() method expects a string or an array. '.gettype($excludes).' given' ); } foreach ($excludes as $excludeName) { $excludeName = $this->trimToAcceptableRecursionLevel($excludeName); if (in_array($excludeName, $this->requestedExcludes)) { continue; } $this->requestedExcludes[] = $excludeName; } return $this; } public function setRecursionLimit(int $recursionLimit): self { $this->recursionLimit = $recursionLimit; return $this; } public function setSerializer(Serializer $serializer): self { $this->serializer = $serializer; return $this; } /* * Look at the requested includes and automatically include the parents if they * are not explicitly requested. E.g: [foo, bar.baz] becomes [foo, bar, bar.baz] * * @internal / protected function autoIncludeParents(): void { $parsed = []; foreach ($this->requestedIncludes as $include) { $nested = explode('.', $include); $part = array_shift($nested); $parsed[] = $part; while (count($nested) > 0) { $part .= '.'.array_shift($nested); $parsed[] = $part; } } $this->requestedIncludes = array_values(array_unique($parsed)); } /* * Strip off any requested resources that are too many levels deep, to avoid DiCaprio being chased * by trains or whatever the hell that movie was about. * * @internal / protected function trimToAcceptableRecursionLevel(string $includeName): string { return implode('.', array_slice(explode('.', $includeName), 0, $this->recursionLimit)); } } PK��1[6��.github/stale.ymlnu��[��daysUntilStale: 180 daysUntilClose: 28 exemptLabels: - keep-open # Label to use when marking an issue as stale staleLabel: stale # Comment to post when marking an issue as stale. Set to `false` to disable markComment: > This issue has been automatically marked as stale because it has not had recent activity. It will be closed after 4 weeks if no further activity occurs. Thank you for your contributions. # Comment to post when closing a stale issue. Set to `false` to disable closeComment: false PK��1[�M@��.github/workflows/.editorconfignu��[��[.yml] indent_size = 2 PK��1[��~�/��/��#��.github/workflows/style-checker.ymlnu��[��name: The PHP League Style Checks on: [push, pull_request] jobs: style: runs-on: ubuntu-latest name: The PHP League Style Checks steps: - name: Checkout Code uses: actions/checkout@v2 - name: Setup PHP uses: shivammathur/setup-php@v2 with: php-version: '7.4' - name: Cache Dependencies id: composer-cache-style uses: actions/cache@v2 with: path: vendor key: ubuntu-composer-cache-style-${{ hashFiles('/composer.lock') }} restore-keys: ubuntu-php-style - name: Install Dependencies if: steps.composer-cache.outputs.cache-hit != 'true' run: composer install --prefer-dist --no-progress --no-suggest - name: Check Coding Style run: vendor/bin/phpcs src/PK��1[n�X��.github/workflows/static.ymlnu��[��on: [ pull_request ] name: Static analysis jobs: phpstan: name: PHPStan runs-on: ubuntu-20.04 steps: - name: Checkout code uses: actions/checkout@v2 - name: Setup PHP uses: shivammathur/setup-php@v2 with: php-version: 8.1 extensions: apcu, redis coverage: none tools: phpstan:1.4.6, cs2pr - name: Download dependencies uses: ramsey/composer-install@v1 - name: PHPStan run: phpstan analyze --no-progress --error-format=checkstyle \| cs2pr psalm: name: Psalm runs-on: ubuntu-20.04 steps: - name: Checkout code uses: actions/checkout@v2 - name: Setup PHP uses: shivammathur/setup-php@v2 with: php-version: 8.1 extensions: apcu, redis coverage: none tools: vimeo/psalm:4.22.0 - name: Download dependencies uses: ramsey/composer-install@v1 - name: Psalm run: psalm --no-progress --output-format=github PK��1[��r��r��.github/workflows/run-tests.ymlnu��[��name: The PHP League Tests on: [push, pull_request] jobs: ci: runs-on: ${{ matrix.os }} strategy: fail-fast: true matrix: os: [ubuntu-20.04] php: [7.4, 8.0, 8.1] name: League - PHP ${{ matrix.php }} on ${{ matrix.os }} steps: - name: Checkout code uses: actions/checkout@v2 - name: Setup PHP uses: shivammathur/setup-php@v2 with: php-version: ${{ matrix.php }} tools: phpcs, phpunit - name: Download dependencies uses: ramsey/composer-install@v2 - name: Run Tests run: vendor/bin/phpunit PK��1[b# uc��c��phpcs.xml.distnu��[��<?xml version="1.0"?> <ruleset name="fractal"> <description>Fractal Coding Standards</description> <arg value="p" /> <config name="ignore_warnings_on_exit" value="1" /> <config name="ignore_errors_on_exit" value="1" /> <arg name="colors" /> <arg value="s" /> <!-- Use the PSR2 Standard--> <rule ref="PSR2" /> </ruleset> PK��1[�B<�� psalm.xmlnu��[��<?xml version="1.0"?> <psalm errorLevel="5" resolveFromConfigFile="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="https://getpsalm.org/schema/config" xsi:schemaLocation="https://getpsalm.org/schema/config vendor/vimeo/psalm/config.xsd" errorBaseline="psalm.baseline.xml" > <projectFiles> <directory name="src" /> <ignoreFiles> <directory name="vendor" /> </ignoreFiles> </projectFiles> </psalm> PK��1[�d�?�� composer.jsonnu��[��{ "name": "league/fractal", "description": "Handle the output of complex data structures ready for API output.", "keywords": [ "league", "api", "json", "rest" ], "homepage": "http://fractal.thephpleague.com/", "license": "MIT", "authors": [ { "name": "Phil Sturgeon", "email": "me@philsturgeon.uk", "homepage": "http://philsturgeon.uk/", "role": "Developer" } ], "config": { "sort-packages": true }, "require": { "php": ">=7.4" }, "require-dev": { "doctrine/orm": "^2.5", "illuminate/contracts": "~5.0", "mockery/mockery": "^1.3", "pagerfanta/pagerfanta": "~1.0.0", "phpstan/phpstan": "^1.4", "phpunit/phpunit": "^9.5", "squizlabs/php_codesniffer": "~3.4", "vimeo/psalm": "^4.22", "zendframework/zend-paginator": "~2.3" }, "suggest": { "illuminate/pagination": "The Illuminate Pagination component.", "pagerfanta/pagerfanta": "Pagerfanta Paginator", "zendframework/zend-paginator": "Zend Framework Paginator" }, "autoload": { "psr-4": { "League\\Fractal\\": "src" } }, "autoload-dev": { "psr-4": { "League\\Fractal\\Test\\": "test" } }, "scripts": { "check": "vendor/bin/phpcs src/", "test": "vendor/bin/phpunit --testdox --colors=always", "test:coverage": "vendor/bin/phpunit --coverage-html build/coverage" }, "extra": { "branch-alias": { "dev-master": "0.20.x-dev" } } } PK��1[��M��M��LICENSEnu��[��The MIT License (MIT) Copyright (c) 2013 Phil Sturgeon <me@philsturgeon.uk> 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. PK��1[�J��r ��r ��phpstan-baseline.neonnu��[��parameters: ignoreErrors: - message: "#^Parameter \\#1 \\$separator of function explode expects non\\-empty\\-string, string given\\.$#" count: 1 path: src/Manager.php - message: "#^Call to an undefined method Illuminate\\\\Contracts\\\\Pagination\\\\LengthAwarePaginator\\:\\:count\$\$\\.$#" count: 1 path: src/Pagination/IlluminatePaginatorAdapter.php - message: "#^Call to an undefined method League\\\\Fractal\\\\Resource\\\\ResourceInterface\\:\\:getMeta\$\$\\.$#" count: 1 path: src/Scope.php - message: "#^Call to an undefined method League\\\\Fractal\\\\TransformerAbstract\\:\\:transform\$\$\\.$#" count: 2 path: src/Scope.php - message: "#^Call to function is_null\$\$ with array will always evaluate to false\\.$#" count: 1 path: src/Scope.php - message: "#^PHPDoc tag @param has invalid value \$\\$includeKey\$\\: Unexpected token \"\\$includeKey\", expected type at offset 18$#" count: 2 path: src/Serializer/JsonApiSerializer.php - message: "#^PHPDoc tag @param has invalid value \$\\$includeObject\$\\: Unexpected token \"\\$includeObject\", expected type at offset 18$#" count: 1 path: src/Serializer/JsonApiSerializer.php - message: "#^PHPDoc tag @param has invalid value \$\\$includeObject\$\\: Unexpected token \"\\$includeObject\", expected type at offset 73$#" count: 1 path: src/Serializer/JsonApiSerializer.php - message: "#^PHPDoc tag @param has invalid value \$\\$includeObjects\$\\: Unexpected token \"\\$includeObjects\", expected type at offset 18$#" count: 1 path: src/Serializer/JsonApiSerializer.php - message: "#^PHPDoc tag @param has invalid value \$\\$key\$\\: Unexpected token \"\\$key\", expected type at offset 102$#" count: 1 path: src/Serializer/JsonApiSerializer.php - message: "#^PHPDoc tag @param has invalid value \$\\$linkedIds\$\\: Unexpected token \"\\$linkedIds\", expected type at offset 48$#" count: 1 path: src/Serializer/JsonApiSerializer.php - message: "#^PHPDoc tag @param has invalid value \$\\$relationship\$\\: Unexpected token \"\\$relationship\", expected type at offset 47$#" count: 1 path: src/Serializer/JsonApiSerializer.php - message: "#^PHPDoc tag @param has invalid value \$\\$relationships\$\\: Unexpected token \"\\$relationships\", expected type at offset 44$#" count: 2 path: src/Serializer/JsonApiSerializer.php - message: "#^PHPDoc tag @param has invalid value \$\\$serializedData\$\\: Unexpected token \"\\$serializedData\", expected type at offset 73$#" count: 1 path: src/Serializer/JsonApiSerializer.php PK��1[��v�� .editorconfignu��[��PK��1[��ZV��V��psalm.baseline.xmlnu��[��PK��1[F w��w��h��phpstan.neon.distnu��[��PK��1[�8:��&�� src/Serializer/DataArraySerializer.phpnu��[��PK��1[��k��src/Serializer/Serializer.phpnu��[��PK��1[_]q� �� "��src/Serializer/ArraySerializer.phpnu��[��PK��1[f=^:X��X��%��src/Serializer/SerializerAbstract.phpnu��[��PK��1[g�{��:��:��$��f ��src/Serializer/JsonApiSerializer.phpnu��[��PK��1[��vsm��m��+��[��src/Pagination/DoctrinePaginatorAdapter.phpnu��[��PK��1[b��%��Sd��src/Pagination/PaginatorInterface.phpnu��[��PK��1[&�- W��W��0��Fh��src/Pagination/ZendFrameworkPaginatorAdapter.phpnu��[��PK��1[�'�]��"��o��src/Pagination/CursorInterface.phpnu��[��PK��1[�Y�]��3��s��src/Pagination/PhalconFrameworkPaginatorAdapter.phpnu��[��PK��1[��\��-��.{��src/Pagination/IlluminatePaginatorAdapter.phpnu��[��PK��1[a �E��E��-��^��src/Pagination/PagerfantaPaginatorAdapter.phpnu��[��PK��1[A�c�� src/Pagination/Cursor.phpnu��[��PK��1[��\|�5��5�� src/Scope.phpnu��[��PK��1[�kUs��src/Resource/NullResource.phpnu��[��PK��1[(��src/Resource/Primitive.phpnu��[��PK��1[u�?d��src/Resource/Item.phpnu��[��PK��1[ u&%0��0��!��src/Resource/ResourceAbstract.phpnu��[��PK��1[H��+ �� "��a��src/Resource/ResourceInterface.phpnu��[��PK��1[�:�B��src/Resource/Collection.phpnu��[��PK��1[��X��src/TransformerAbstract.phpnu��[��PK��1[�?t�O��O��src/ParamBag.phpnu��[��PK��1[k�+��+�src/ScopeFactoryInterface.phpnu��[��PK��1[?��^�src/ScopeFactory.phpnu��[��PK��1[�Ccg"��g"��8�src/Manager.phpnu��[��PK��1[6��:�.github/stale.ymlnu��[��PK��1[�M@��=�.github/workflows/.editorconfignu��[��PK��1[��~�/��/��#��=�.github/workflows/style-checker.ymlnu��[��PK��1[n�X��A�.github/workflows/static.ymlnu��[��PK��1[��r��r��`E�.github/workflows/run-tests.ymlnu��[��PK��1[b# uc��c��!H�phpcs.xml.distnu��[��PK��1[�B<�� I�psalm.xmlnu��[��PK��1[�d�?�� K�composer.jsonnu��[��PK��1[��M��M��R�LICENSEnu��[��PK��1[�J��r ��r ��5W�phpstan-baseline.neonnu��[��PK��&�&�� a��

| ver. 1.4 | Github | . | PHP 8.2.29 | Ð“ÐµÐ½ÐµÑ€Ð°Ñ†Ð¸Ñ ÑÑ‚Ñ€Ð°Ð½Ð¸Ñ†Ñ‹: 0 | proxy | phpinfo | ÐÐ°ÑÑ‚Ñ€Ð¾Ð¹ÐºÐ°