PHPackages                             ckr/fiql-parser - 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. [Parsing & Serialization](/categories/parsing)
4. /
5. ckr/fiql-parser

ActiveLibrary[Parsing & Serialization](/categories/parsing)

ckr/fiql-parser
===============

Library to parse a FIQL string into an abstract syntax tree

v0.1.0(11y ago)264MITPHPPHP >=5.4

Since May 2Pushed 11y ago2 watchersCompare

[ Source](https://github.com/ckressibucher/fiql-parser-php)[ Packagist](https://packagist.org/packages/ckr/fiql-parser)[ RSS](/packages/ckr-fiql-parser/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (1)Versions (2)Used By (0)

FIQL Parser for php
===================

[](#fiql-parser-for-php)

This library provides a parser for the Feed Item Query Language. The parser creates a syntax tree from a string expression in the Feed Item Query Language ()

*Note that this library is not yet stable enough for production usage*. If you find a bug, please help by creating an issue on github.

Requirements
------------

[](#requirements)

This library currently does not use any third party dependencies. A PHP version >= 5.4 is required. For testing, phpspec is used.

[![Build Status](https://camo.githubusercontent.com/22aaa2b5b27c49615b208d5588e84f42a805291b2f610f45b3a3fade60cbde3c/68747470733a2f2f7472617669732d63692e6f72672f636b72657373696275636865722f6669716c2d7061727365722d7068702e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/ckressibucher/fiql-parser-php)

Basic Usage
-----------

[](#basic-usage)

```
// autoloading is psr-4 compliant, so we can use composer
require 'vendor/autoload.php';

// initialize scanner and parser
$scanner = new \Ckr\Fiql\Scanner();
$parser = new \Ckr\Fiql\Parser($scanner);

// parse expression to a syntax tree
$syntaxTree = $parser->parse('field==value,second=lt=val;requiredField');

// example visitor usage
$visitor = new \Ckr\Fiql\Visitor\Printer();
$visitor->visit($syntaxTree);

echo 'The syntax tree visualized:' . PHP_EOL;
echo $visitor->getText();
echo PHP_EOL;
```

Syntax Tree
-----------

[](#syntax-tree)

The syntax tree is composed of nodes implementing `\Ckr\Fiql\Tree\Node`.

Visitor
-------

[](#visitor)

You can implement a custom visitor class (implementing `\Ckr\Fiql\Tree\Visitor`) to process the syntax tree for your purposes, e.g. to check for matching feeds items. This library provides only one visitor, `\Ckr\Fiql\Visitor\Printer`, which is mainly used to visualize and compare syntax trees.

References
----------

[](#references)

- FIQL definition:
- FIQL parser python: [https://github.com/sergedomk/fiql\_parser](https://github.com/sergedomk/fiql_parser)

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 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

Unknown

Total

1

Last Release

4034d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/81e52f2fb24def14cbf90069f298696540f5268e48efff17ab0d53df1ac41137?d=identicon)[ckressibucher](/maintainers/ckressibucher)

---

Top Contributors

[![ckressibucher](https://avatars.githubusercontent.com/u/3111098?v=4)](https://github.com/ckressibucher "ckressibucher (6 commits)")

### Embed Badge

![Health badge](/badges/ckr-fiql-parser/health.svg)

```
[![Health](https://phpackages.com/badges/ckr-fiql-parser/health.svg)](https://phpackages.com/packages/ckr-fiql-parser)
```

###  Alternatives

[masterminds/html5

An HTML5 parser and serializer.

1.8k242.8M229](/packages/masterminds-html5)[sabberworm/php-css-parser

Parser for CSS Files written in PHP

1.8k191.2M65](/packages/sabberworm-php-css-parser)[jms/metadata

Class/method/property metadata management in PHP

1.8k152.8M88](/packages/jms-metadata)[jms/serializer-bundle

Allows you to easily serialize, and deserialize data of any complexity

1.8k89.3M627](/packages/jms-serializer-bundle)[hassankhan/config

Lightweight configuration file loader that supports PHP, INI, XML, JSON, and YAML files

97513.5M170](/packages/hassankhan-config)[meyfa/php-svg

Read, edit, write, and render SVG files with PHP

54613.9M42](/packages/meyfa-php-svg)

PHPackages © 2026

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