https://github.com/tmilos/scim-filter-parser

SCIM AST filter parser PHP library
https://github.com/tmilos/scim-filter-parser

php scim scim-2 scim-filter

Last synced: 9 months ago
JSON representation

SCIM AST filter parser PHP library

• Host: GitHub
• URL: https://github.com/tmilos/scim-filter-parser
• Owner: tmilos
• License: mit
• Created: 2016-12-20T10:14:27.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2023-01-31T17:43:56.000Z (almost 3 years ago)
• Last Synced: 2024-04-24T09:25:44.672Z (over 1 year ago)
• Topics: php, scim, scim-2, scim-filter
• Language: PHP
• Homepage:
• Size: 24.4 KB
• Stars: 11
• Watchers: 3
• Forks: 5
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# SCIM filter parser

The PHP parser for SCIM filter. SCIM stands for System for Cross-domain Identity Management and more details can be

found on http://www.simplecloud.info/ website.

[![Author](http://img.shields.io/badge/author-@tmilos-blue.svg?style=flat-square)](https://twitter.com/tmilos77)

[![Build Status](https://travis-ci.org/tmilos/scim-filter-parser.svg?branch=master)](https://travis-ci.org/tmilos/scim-filter-parser)

[![Coverage Status](https://coveralls.io/repos/github/tmilos/scim-filter-parser/badge.svg?branch=master)](https://coveralls.io/github/tmilos/scim-filter-parser?branch=master)

[![Quality Score](https://img.shields.io/scrutinizer/g/tmilos/scim-filter-parser.svg?style=flat-square)](https://scrutinizer-ci.com/g/tmilos/scim-filter-parser)

[![License](https://img.shields.io/packagist/l/tmilos/scim-filter-parser.svg)](https://packagist.org/packages/tmilos/scim-filter-parser)

[![Packagist Version](https://img.shields.io/packagist/v/tmilos/scim-filter-parser.svg?style=flat-square)](https://packagist.org/packages/tmilos/scim-filter-parser)

[![SensioLabsInsight](https://insight.sensiolabs.com/projects/cc1043a0-daa9-481b-9840-109bdb43543b/mini.png)](https://insight.sensiolabs.com/projects/cc1043a0-daa9-481b-9840-109bdb43543b)

# Usage

### Filter mode

```php

parse('userType eq "Employee" and (emails co "example.com" or emails.value co "example.org")');

/*

walk the node...

Conjunction = {

    ComparisonExpression => userType eq Employee

    Disjunction => {

        ComparisonExpression => emails co example.com

        ComparisonExpression => emails.value co example.org

    }

}

*/

```

### Path mode

```php

parse('members[value eq "2819c223-7f76-453a-919d-413861904646"].displayName');

/*

walk the node...

Path = {

    ValuePath = {

        AttributePath = 'members'

        ComparisonExpression = value eq 2819c223-7f76-453a-919d-413861904646

    }

    AttributePath = displayName,

}

*/

```

For more details look at the [filter mode](tests/ParserFilterModeTest.php) and [path mode](tests/ParserPathModeTest.php) unit tests.

# Filter and path mode

SCIM v2 for ``PATCH`` operations defines parsable path with different grammar than for the retrieving resources filter expressions.

The parser by default is in the FILTER mode, but you can switch it to PATH mode either with optional constructor argument or

with a ``Parser::setMode(Mode $mode)`` setter method.

**Note**: Path mode is valid only for SCIM v2 version.

```php

parse('username'); // OK

$parser->parse('username eq "xxx"'); // throws ParseException - Col 8: Expected end of input, but got ' '

```

# SCIM filter version

SCIM filter between versions v1 and v2 remained almost the same, with the difference that v2 introduced new ValuePath syntax.

Parser is by default in v2 mode, and you can switch it to v1 with ``Parser::setVersion(Version::V1())`` setter or with optional

constructor argument. In v1 mode it will throw syntax errors when brackets are encountered.

```php

parse('emails[type eq "work"]'); // throws ParseException - Col 6: Expected SP, got '['

```