PHPackages                             chkt/ash - 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. chkt/ash

ActiveLibrary

chkt/ash
========

A basic expression solver

v1.4.1(5y ago)015MITPHPPHP ^7.0CI failing

Since Dec 7Pushed 5y ago1 watchersCompare

[ Source](https://github.com/chkt/ash)[ Packagist](https://packagist.org/packages/chkt/ash)[ RSS](/packages/chkt-ash/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (6)Dependencies (3)Versions (7)Used By (0)

ash
===

[](#ash)

A basic expression solver
-------------------------

[](#a-basic-expression-solver)

Ash is an expression solver using basic arithmetic expressions in a sandboxed environment. It is meant to offer a convenient way to programmatically access properties in hierarchical data.

### Install

[](#install)

#### Composer

[](#composer)

Ash is available through [composer](https://getcomposer.org/).

##### Command line

[](#command-line)

```
$ php composer.phar install chkt/ash
```

##### composer.json

[](#composerjson)

```
{
  "require" : {
    "chkt/eve" : ""
  }
}
```

#### Manual installation

[](#manual-installation)

Alternatively you can clone the [github repository](https://github.com/chkt/ash) into a location of your liking. Afterwards you will have to register the [PSR-4](https://www.php-fig.org/psr/psr-4/) namespace `ash`within php yourself.

```
$ git clone https://github.com/chkt/ash.git
```

Ash depends on [chkt/eve](https://github.com/chkt/eve). When cloning manually you will have to ensure that package is also available and it's PSR-4 namespace is registered yourself.

### Creating a solver

[](#creating-a-solver)

```
  $baseFactory = new \eve\common\factory\BaseFactory();
  $parserFactory = new \ash\ParserFactory($baseFactory);
```

The parserFactory requires an instance of [\\eve\\common\\factory\\IBaseFactory](https://github.com/chkt/eve/blob/master/source/common/factory/IBaseFactory.php). You can use the [bundled factory](https://github.com/chkt/eve/blob/master/source/common/factory/BaseFactory.php)or implement your own.

```
  $parser = $parserFactory->produce();
  $solver = $parser->parse('a + b');
```

Parsing the expression `a + b` will return the solver object for this expression.

```
  $result = $solver->resolve([
    'a' => 1,
    'b' => 2
  ]);
```

The solver will resolve this expression for any data provided to it's `->resolve()` method.

Supported syntax
----------------

[](#supported-syntax)

The expression syntax broadly follows c-style syntax conventions, with strong nods to the functional paradigm of javascript.

Ash is not meant to be comprehensive and is therefore deliberately limited to evaluating expressions. There are no statements, no assignments, no way to define functions or compose data, and no way to mutate any data within its scope through the syntax.

Everything accessible within the solver's scope needs to be provided by the host program, making it impossible to access any part of the host system within an expression when that access has not been deliberately provided.

#### Scalar values

[](#scalar-values)

Currently supported are floating point numbers in basic `1.0` and exponent notation `1.0e-1`, integers in basic `1`, binary `0b1` and hexadecimal `0x1` notation and basic strings `'foo'`,`"foo"`.

Any number starting with `0x` or `0b` will be treated as an integer, any other number containing a dot `0.0` will be treated as a float. All remaining numbers will be treated as integers.

Strings can be delimited with the quotation `"` and apostrophe `'` characters and the delimiter can be escaped with the backslash `\ ` character.

Support for booleans, nan, +/-infinity and typecasting is planned.

#### Arithmetic operations

[](#arithmetic-operations)

Currently ash supports arithmetic expressions for addition `a + b`, substraction `a - b`, multiplication `a * b`, division `a / b` and modulo `a % b` as well as bracketed expressions `a * (b + c)`.

All arithmetic operations will convert boolean arguments to the integer values `0` and `1`. Integers will be cast to `float` if at least one operand is a floating point number. Divisions by zero `1 / 0` will return `INF` and `-INF` respectively, modulo zero `1 % 0` will return `NAN` irrespective of input types.

Support for comparisons, prefix `+` and `-`, `typeof`, the exponentiation operator and logic operations is planned.

#### Property accesses

[](#property-accesses)

Property accesses are done using the `.` operator for static access `foo.bar`, and square brackets for computed access `foo[bar]`.

Static and computed accesses can be freely mixed `foo[bar].baz[qux][qux]` and computed accesses can resolve to either integers `foo[ 1 ]` or strings `foo[ 'bar' ]`.

#### Calls

[](#calls)

Anything that resolves to a `callable` within php can be called through the solver using the round brackets `foo()`.

```
  $solver = $parser->parse('baz[ foo() ]');

  $context = [
      'foo' : function() : string { return 'bar'; },
      'baz' => [ 'bar' => 'qux' ]]
    ];
  $result = $solver->resolve($context);
```

Arguments are separated by commas `foo(bar, baz)`.

Nested `foo(bar(), baz())` and chained calls `foo()()` are allowed. The return values of calls can be freely used in any subsequent operation `foo().bar + baz()`.

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity60

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 ~113 days

Recently: every ~139 days

Total

6

Last Release

2150d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f2e52b90c6e2fba71654e5a77e791164e526007e42badc85a240bd8280fff08a?d=identicon)[chkt](/maintainers/chkt)

---

Top Contributors

[![chkt](https://avatars.githubusercontent.com/u/2528779?v=4)](https://github.com/chkt "chkt (82 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/chkt-ash/health.svg)

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

PHPackages © 2026

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