PHPackages                             fjonathan/q-file - 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. fjonathan/q-file

ActiveLibrary

fjonathan/q-file
================

Query simple flat file

v0.2(7y ago)19PHPPHP &gt;=7.0.0

Since Apr 13Pushed 7y agoCompare

[ Source](https://github.com/dev-fjonathan/q-file)[ Packagist](https://packagist.org/packages/fjonathan/q-file)[ RSS](/packages/fjonathan-q-file/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependenciesVersions (2)Used By (0)

📝 Q-File!
---------

[](#-q-file)

Query File is basicaly a lightweight PHP class for queries (retrieve/select/where/order) custom data from a flat file. File is pretty to learn, not like JSON, or ARRAY, or SQL, all level of developers can learn easy that type of files.

Installation
------------

[](#installation)

### Composer

[](#composer)

Install with a command:

```
composer require fjonathan/q-file
```

Configuration
-------------

[](#configuration)

Buil the 'table' for using data to output and filter. Create a file like `table.ay` and build your own custom data

That's a example:

```
new "groups"

    (Google)
        [id: 1]

    (Whatsapp)
        [id: 2]

new "contact_list"

    (Jean Doe)
        [group: 2]
        [email: jeandoe@email.com]
        [avatar: user1.png]
        [address: 2722 Retreat Avenue]
        [city: Los Angeles]
        [phone: 562-567-3643]

    (Michel Doe)
        [group: 1]
        [email: micheldoe@email.com]
        [avatar: user2.png]
        [address: 577 Carolina Avenue]
        [city: Fort Collins]
        [phone: 808-933-9356]

```

Usage
-----

[](#usage)

Init package to starting using it

```
use File\Q;
$f = new Q;
$table = 'table.ay';
```

Return all data organized by keys

```
$data = $f
        ->table($table)
        ->record();
```

Options
-------

[](#options)

These light class has many options to filter data, like:

- `searchAll` - search by primary table content - `->searchAll('groups')`
- `searchby` - search by key group - `->searchBy('contact_list', 'group', 1)`
- `orderBy` - order by asc/desc the results data -&gt; `orderBy('id', 'ASC')`

### Notes

[](#notes)

This tool has been retrieved from an old project, and may not be constant updates, so use with care.

###  Health Score

21

—

LowBetter than 19% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity44

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

2588d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/7a9e351b6e65fc1b476481aaa105e4045dc7ccd949e6b520fdf3f78f42e70ef0?d=identicon)[dev.fjonathan](/maintainers/dev.fjonathan)

---

Top Contributors

[![fj-onathan](https://avatars.githubusercontent.com/u/47660890?v=4)](https://github.com/fj-onathan "fj-onathan (4 commits)")

### Embed Badge

![Health badge](/badges/fjonathan-q-file/health.svg)

```
[![Health](https://phpackages.com/badges/fjonathan-q-file/health.svg)](https://phpackages.com/packages/fjonathan-q-file)
```

PHPackages © 2026

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