PHPackages                             vairogs/functions-preg - 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. [Utility & Helpers](/categories/utility)
4. /
5. vairogs/functions-preg

Abandoned → [valksor/php-functions-preg](/?search=valksor%2Fphp-functions-preg)Library[Utility & Helpers](/categories/utility)

vairogs/functions-preg
======================

A PHP library providing enhanced regular expression (preg\_\*) functions with improved error handling and UTF-8 support

029PHP

Since Apr 16Pushed 11mo agoCompare

[ Source](https://github.com/vairogs/functions-preg)[ Packagist](https://packagist.org/packages/vairogs/functions-preg)[ RSS](/packages/vairogs-functions-preg/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Vairogs Functions: Preg
=======================

[](#vairogs-functions-preg)

A PHP library providing enhanced regular expression (preg\_\*) functions with improved error handling and UTF-8 support.

Installation
------------

[](#installation)

Install the package via Composer:

```
composer require vairogs/functions-preg
```

Requirements
------------

[](#requirements)

PHP 8.4 or higher

Usage
-----

[](#usage)

There are two ways to use this package: via the Functions class or by directly using the traits.

### Using the Functions Class

[](#using-the-functions-class)

The Functions class provides enhanced versions of PHP's preg\_\* functions with better error handling and UTF-8 support.

```
use Vairogs\Functions\Preg\Functions;

// Create a new Functions instance
$preg = new Functions();

// Use enhanced preg_match
$isMatch = $preg->match('/pattern/', 'subject string', $matches);

// Use enhanced preg_replace
$replaced = $preg->replace('/pattern/', 'replacement', 'subject string');

// Use enhanced preg_split
$parts = $preg->split('/delimiter/', 'string to split');
```

### Using Traits Directly

[](#using-traits-directly)

Alternatively, you can use the traits directly in your own classes:

```
use Vairogs\Functions\Preg\Traits\_Match;
use Vairogs\Functions\Preg\Traits\_Replace;
use Vairogs\Functions\Preg\Traits\_Split;

class MyClass
{
    // Import the traits you need
    use _Match;
    use _Replace;
    use _Split;

    public function doSomething(): void
    {
        // Use the methods directly
        $isMatch = $this->match('/pattern/', 'subject string', $matches);
        $replaced = $this->replace('/pattern/', 'replacement', 'subject string');
        $parts = $this->split('/delimiter/', 'string to split');
    }
}
```

Note that some traits may depend on other helper traits. For example, the `_Match` trait uses `_AddUtf8Modifier`, `_NewPregException`, and `_RemoveUtf8Modifier` internally. The Functions class handles these dependencies for you, but if you use the traits directly, you may need to include these helper traits as well.

### UTF-8 Support

[](#utf-8-support)

The library automatically handles UTF-8 patterns by trying to add or remove the UTF-8 modifier as needed:

```
// Will automatically try with and without UTF-8 modifier
$isMatch = $preg->match('/pattern/u', 'subject with UTF-8 characters');
```

### Error Handling

[](#error-handling)

The library provides improved error handling by throwing exceptions with detailed information when regex errors occur:

```
try {
    $result = $preg->match('/invalid[pattern/', 'subject');
} catch (\Exception $e) {
    // Handle the exception with detailed error information
    echo $e->getMessage();
}
```

### SkipErrorHandler

[](#skiperrorhandler)

The SkipErrorHandler executes a callback while capturing PHP errors and converting them to exceptions:

```
use Vairogs\Functions\Preg\SkipErrorHandler;

try {
    $result = SkipErrorHandler::execute(function() {
        // Code that might trigger PHP errors
        $value = @file_get_contents('non-existent-file.txt');
        return $value;
    });
} catch (RuntimeException $e) {
    // Handle the error
    echo "Error: " . $e->getMessage();
}
```

Features
--------

[](#features)

For a complete list of all functions available in this package, see [Features](docs/features.md).

License
-------

[](#license)

This package is licensed under the [BSD-3-Clause License](LICENSE).

About Vairogs
-------------

[](#about-vairogs)

This package is part of the [vairogs/vairogs](https://github.com/vairogs/vairogs) project - a comprehensive PHP library and Symfony bundle that provides a collection of utilities, components, and integrations for Symfony applications.

The main project includes:

- Various utility functions and components
- Doctrine ORM tools and extensions
- API Platform integrations
- Symfony bundle for easy configuration
- And much more

If you find this Preg component useful, you might want to check out the full Vairogs project for additional tools and utilities that can enhance your Symfony application development.

To install the complete package:

```
composer require vairogs/vairogs
```

###  Health Score

17

—

LowBetter than 6% of packages

Maintenance39

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity14

Early-stage or recently created project

 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.

### Community

Maintainers

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

---

Top Contributors

[![k0d3r1s](https://avatars.githubusercontent.com/u/38725938?v=4)](https://github.com/k0d3r1s "k0d3r1s (2 commits)")

### Embed Badge

![Health badge](/badges/vairogs-functions-preg/health.svg)

```
[![Health](https://phpackages.com/badges/vairogs-functions-preg/health.svg)](https://phpackages.com/packages/vairogs-functions-preg)
```

PHPackages © 2026

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