PHP class for parsing a template into a regex, used for matching into name-value pairs. This is useful when you want to create a regex from a large amount of text without having to fiddle with all the details of the regex (such as escaping text).
Ex:
$template->parse_template('Some number: {{ number|digits }}');
$name_value = $template->match('Some number: 5678');
/*
Should result in:
$name_value = [
'number' => 5678
];
*/
Install with composer:
composer require magnusjt/regtemplate_php
See also examples in the examples folder.
$template = \RegTemplate\RegTemplate('some/dir');
# Parse a template from a file inside the base directory
$template->parse_template_from_file('file_inside_some_dir.txt');
# Or parse from a string:
# $template->parse_template('Some number: {{ number|digits }}');
# Match an output string against the template. Name=>value array returned.
$name_value = $template->match('Some number: 64');
# Match all. If the regex matches several times, return a list of list of name=>value arrays:
$match_list = $template->match_all('Some number: 64, Some number: 65');
Displaying numbers from index {{ index_name|word }}
Number of interesting events: {{ num_events|digits }}
Number of pages: {{ num_pages|digits }}
Status: {{ on_or_off|reg="(?:on|off)" }}
A rule is a name and a regex to match it. If the regex has capturing groups, ensure that they are non-capturing like this: (?:).
$template->set_rule('digits', '\d+');
$template->set_rule('on_or_off', '(?:on|off)');
# Default rule if no rule is given in the template
$template->set_default_rule('\S+');
You can use inline regexes instead of rules in your template. Remember to escape any double quotes with backslash.
$template->parse_template('{{ number|reg="\d\d\d" }}
Ignore any excess whitespace by replacing all whitespace with a single space. You can turn this feature on/off like this:
$template->set_ignore_whitespace(true);
If the string you want to match contains the default variable tokens, you can change the tokens like this:
$template->set_variable_tokens('{{', '}}');
Any variable with the name 'any' is skipped. It is matched, but not returned. You can change the name to ignore like this:
$template->set_ignore_var_name('any');