PHPackages                             yehiahamid/easyparse - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. yehiahamid/easyparse

ActivePackage[API Development](/categories/api)

yehiahamid/easyparse
====================

query sting parser for rest apis supports filterations, sorting, fields, embeds

v1.0.8(9y ago)2156[1 issues](https://github.com/yehiaa/easyparser/issues)PHPCI failing

Since Dec 16Pushed 9y ago2 watchersCompare

[ Source](https://github.com/yehiaa/easyparser)[ Packagist](https://packagist.org/packages/yehiahamid/easyparse)[ RSS](/packages/yehiahamid-easyparse/feed)WikiDiscussions master Synced 4w ago

READMEChangelog (8)Dependencies (1)Versions (11)Used By (0)

easyparser
==========

[](#easyparser)

[![Build Status](https://camo.githubusercontent.com/57f355ce91bc9deccdbe7a8b5193bf598fb71027626ff2c052c4dfa706bd0a76/68747470733a2f2f7472617669732d63692e6f72672f7965686961612f656173797061727365722e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/yehiaa/easyparser)

easyparser is a simple query string parser for rest api php.

it's simply convert the QS to structured types.

you can parse your query string to filter, sort, get certain fields and embed resources

installation using composer
===========================

[](#installation-using-composer)

composer require yehiahamid/easyparse

Usage
=====

[](#usage)

```
//values must be inside single or double quotes if it contains white spaces or special chars 'what ever' | "what ever"
$queryStringFilters = "@filters=name eq 'what ever',surname ne 'what ever'";
// otherwise you can use use the value without quotes
// ex :

$queryStringFilters = "@filters=id eq 12";
$queryStringFilters = "@filters=id eq anyWordsWithoutspacesOrSpecialChars";

//fields
$queryStringFields = "@fields=name,surname,code";

//name is assc , surname desc
$queryStringOrderBy = "@orderby=name,-surname";

//embed can contains fields,filters,sort and paging
$queryStringEmbed = "@embed=resourceOne(@fields=name,code)(@filters=nameembed eq 'what ever'),mobiles(@orderby=sortFieldOne)";

$queryString = $queryStringFilters . "&" . $queryStringFields . "&" . $queryStringOrderBy . "&" . $queryStringEmbed;

//in real app you would use $_SERVER['QUERY_STRING'];
//this is optional param if not set it will use server query string
$parser = new yehiaHamid\easyParse\QueryStringParser($queryString);

$parser->fields(); //return array of fields | null if empty

$parser->orderBy(); //return array of order by object | null if empty
//Or you can set default value
// use - before field for desc order

$parser->orderBy("fieldOne,-field");

$filtersResult = $parser->filters();
//the filter object has three fields
// the used query string in ex : "@filters=name eq 'what ever',surname ne 'what ever'"

$filtersResult[0]->field // name
$filtersResult[0]->operator // eq
$filtersResult[0]->getOperator() // "="
$filtersResult[0]->value // 'what ever'

$filtersResult[1]->field // surname
$filtersResult[1]->operator // ne
$filtersResult[1]->getOperator() // "!="
$filtersResult[1]->value // 'what ever'

//Or you can set default value for each of the following
$parser->offset();
$parser->limit();
$parser->perPage();
$parser->page();

// this new function return the value of required key , the key shouldn't be in reserved key words
// reserved key words "field", "fields", "embed", "embeds", "filter", "filters", "orderby", "orderBy", "direction", "search"
$parser->get("key");
// ex:

$qs = "@anthThing=the value";
$parser->get("anthThing"); //returns the value
// also you can pass second param for default value

$parser->search();

//embed
$embedResult = $parser->embed(); //return array of embed each object contains filters , sort , fields | empty array
// the used query string in ex :
//"@embed=resourceOne(@fields=name,code)(@filters=nameembed eq 'what ever'),mobiles(@orderby=sortFieldOne)"
$embedResult[0]->resource // resourceOne
$embedResult[0]->fields // array of fields  [name,code]
$embedResult[0]->filters // array of filters or empty array

$embedResult[1]->resource // mobiles
$embedResult[1]->orderBy // array of order by objects
```

available filtering operator
============================

[](#available-filtering-operator)

in Query stringin result objecteq=ne!=gt>lt<likelikeilikeilikele<=ge>=

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance10

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~70 days

Recently: every ~138 days

Total

9

Last Release

3285d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/4194262?v=4)[Yehia Abdulhamid](/maintainers/yehiaa)[@yehiaa](https://github.com/yehiaa)

---

Top Contributors

[![yehiaa](https://avatars.githubusercontent.com/u/4194262?v=4)](https://github.com/yehiaa "yehiaa (37 commits)")

---

Tags

apicomposer-packageembedfilteringpaginationparserphpquery-stringrest-apissorting

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/yehiahamid-easyparse/health.svg)

```
[![Health](https://phpackages.com/badges/yehiahamid-easyparse/health.svg)](https://phpackages.com/packages/yehiahamid-easyparse)
```

###  Alternatives

[exsyst/swagger

A php library to manipulate Swagger specifications

35816.3M7](/packages/exsyst-swagger)[hubspot/api-client

Hubspot API client

24015.5M18](/packages/hubspot-api-client)[pocketmine/bedrock-protocol

An implementation of the Minecraft: Bedrock Edition protocol in PHP

172437.8k11](/packages/pocketmine-bedrock-protocol)[botman/driver-telegram

Telegram driver for BotMan

94452.6k6](/packages/botman-driver-telegram)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)