README

An unnecessarily complex tool that performs multi-level contextual text replacements in PHP. Useful for transforming text inside nested or scoped contexts while skipping comments and handling escapes.

Installation

Require the package with Composer (replace your-vendor/your-repo with the repository name you publish on GitHub/Packagist):

composer require zhalker/dumb-artifact-for-multi-level-contextual-parsing-in-php

Note: locally the package is autoloaded via the vendor/autoload.php generated by Composer.

Namespace and autoloading

This library uses PSR-4 autoloading. The base namespace is DumbContextualParser\ and maps to the src/ directory.

Example class: DumbContextualParser\ContextualReplaceText

Basic usage example

<?php
require __DIR__ . '/vendor/autoload.php';

use DumbContextualParser\ContextualReplaceText;

$text = "<html>\n<!-- ignore this comment -->\n<body>";

$rules = [
    [
        'scope_start' => '<body>',
        'scope_end' => '</body>',
        'self_replace' => [
            'open' => '"',
            'close' => '"',
            'pattern' => '<em>%s</em>'
        ],
        'inner_scopes' => []
    ]
];

$result = ContextualReplaceText::applyContexts($text, $rules);

echo $result;

Notes

The repository package name (zhalker/dumb-artifact-for-multi-level-contextual-parsing-in-php) can stay as-is for GitHub/Packagist; the PHP namespace used in code is DumbContextualParser\.
Consider adding tests (PHPUnit) and an examples/ directory with runnable examples.

License

MIT

zhalker / dumb-artifact-for-multi-level-contextual-parsing-in-php

Maintainers

Package info

Statistics

Security