PHPackages                             erickjmenezes/resrap - 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. erickjmenezes/resrap

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

erickjmenezes/resrap
====================

parser utils

v0.8.0(7mo ago)07mitPHPPHP ^8.4

Since Sep 27Pushed 7mo agoCompare

[ Source](https://github.com/ErickJMenezes/resrap)[ Packagist](https://packagist.org/packages/erickjmenezes/resrap)[ RSS](/packages/erickjmenezes-resrap/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (1)Versions (14)Used By (0)

Resrap — Parser and scanner utils
=================================

[](#resrap--parser-and-scanner-utils)

*WARNING: This package is not intended for serious usage.*

It's not a framework, but it's a good starting point for building your own parser and a regexp-based scanner.

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

[](#requirements)

- PHP ^8.4

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

[](#installation)

```
composer require erickjmenezes/resrap
```

Examples
--------

[](#examples)

Two runnable examples are included.

### Math calculator (toy) example

[](#math-calculator-toy-example)

- [examples/Math/main.php](./examples/Math/main.php) — entry point

Run it:

```
composer install
php examples/Math/main.php
```

### JSON Parser example

[](#json-parser-example)

- [examples/Json/main.php](./examples/Json/main.php)

Run it:

```
composer install
php examples/Json/main.php
```

Quickstart
----------

[](#quickstart)

### 1. Declare the tokens your program needs

[](#1-declare-the-tokens-your-program-needs)

```
enum MathToken
{
    case NUMBER;
    case PLUS;
    case MINUS;
    case TIMES;
    case DIV;
}
```

### 2. Create a Scanner

[](#2-create-a-scanner)

```
use Resrap\Component\Scanner\{Scanner, ScannerBuilder, Pattern, ScannerToken};

function create_scanner(): Scanner
{
    return new ScannerBuilder(
        // skip whitespace
        new Pattern('[\s\t\n\r]+', ScannerToken::SKIP),
        // tokens
        new Pattern('{NUMBER}', MathToken::NUMBER),
        new Pattern('\+', MathToken::PLUS),
        new Pattern('-', MathToken::MINUS),
        new Pattern('\*', MathToken::TIMES),
        new Pattern('\\/', MathToken::DIV),
    )
        ->aliases([
            'NUMBER' => '[0-9]+',
        ])
        ->build();
}
```

### 3. Create grammar rules to parse your tokens

[](#3-create-grammar-rules-to-parse-your-tokens)

```
%class MathParser;

%use Whatever\Namespace\Of\MathToken;

%start calculator;

number := MathToken::NUMBER { return $1; }
        ;

operator := MathToken::PLUS     { return $1; }
          | MathToken::MINUS    { return $1; }
          | MathToken::TIMES    { return $1; }
          | MathToken::DIV      { return $1; }
          ;

expression := number                     { return $1; }
            | number operator expression { return "{$1} {$2} {$3}"; }
            ;

calculator := expression { return eval("return {$1};"); }
            ;

```

### 4. Generate the parser

[](#4-generate-the-parser)

```
php bin/resrap compile my-grammar.rr > MathParser.php
```

### 5. Use the parser

[](#5-use-the-parser)

```
$parser = new MathParser(create_scanner());

echo $parser->parse('1 + 2 + 3'); // 6
```

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance65

Regular maintenance activity

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity50

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

Every ~1 days

Total

11

Last Release

210d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4c4d7b81b04cad437d9e4579d02e2a96c62320da264c82be0f5fb784034b49c2?d=identicon)[ErickJMenezes](/maintainers/ErickJMenezes)

---

Top Contributors

[![ErickJMenezes](https://avatars.githubusercontent.com/u/49132967?v=4)](https://github.com/ErickJMenezes "ErickJMenezes (56 commits)")

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/erickjmenezes-resrap/health.svg)

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

###  Alternatives

[mtdowling/jmespath.php

Declaratively specify how to extract elements from a JSON document

2.0k472.8M135](/packages/mtdowling-jmespathphp)[opis/closure

A library that can be used to serialize closures (anonymous functions) and arbitrary data.

2.6k230.0M284](/packages/opis-closure)[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)[michelf/php-markdown

PHP Markdown

3.5k52.4M344](/packages/michelf-php-markdown)[jms/metadata

Class/method/property metadata management in PHP

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

PHPackages © 2026

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