quorum/dot-notation

Simple PHP Dot Notation Parser

v1.1.0 2025-04-12 22:50 UTC

Requires

• php: >=7.1

Requires (Dev)

• corpus/coding-standard: ~0.6.0
• friendsofphp/php-cs-fixer: ^2.17
• phpunit/phpunit: ~7.5 | ~9.5
• squizlabs/php_codesniffer: ^3.5

MIT

• Jesse Donat

README

DotNotationParser is a simple parser that will parse foo.bar.baz into [ 'foo', 'bar', 'baz' ] and foo."bar.baz" into [ 'foo', 'bar.baz' ].

Requirements

• php: >=7.1

Installing

Install the latest version with:

composer require 'quorum/dot-notation'

Documentation

Class: Quorum\DotNotation\DotNotationParser

Class DotPathParser

Parse strings like foo."bar.baz".quux into [ 'foo', 'bar.baz', 'quux' ]

Method: DotNotationParser->parse

function parse(string $path) : array

Parse a given dot notation path into it's parts

The path is expected to be a string of dot separated keys, where keys can be
quoted with double quotes. Backslashes are used to escape double quotes inside
quoted keys.

Examples

• 'foo.bar.baz' => [ 'foo', 'bar', 'baz' ]
• 'foo."bar.baz"' => [ 'foo', 'bar.baz' ]
• 'foo."bar.baz".quux' => [ 'foo', 'bar.baz', 'quux' ]
• 'foo."bar\"baz".quux' => [ 'foo', 'bar"baz', 'quux' ]

Throws: \Quorum\DotNotation\Exceptions\ParseException

Returns:

• string[]