https://github.com/derrabus/php-ereg-shim

Replacement for the ereg legacy php extension
https://github.com/derrabus/php-ereg-shim

legacy php polyfill regular-expressions shim

Last synced: 2 months ago
JSON representation

Replacement for the ereg legacy php extension

• Host: GitHub
• URL: https://github.com/derrabus/php-ereg-shim
• Owner: derrabus
• License: mit
• Created: 2017-12-31T12:32:05.000Z (about 7 years ago)
• Default Branch: main
• Last Pushed: 2023-12-02T07:31:26.000Z (about 1 year ago)
• Last Synced: 2024-10-12T04:11:36.944Z (3 months ago)
• Topics: legacy, php, polyfill, regular-expressions, shim
• Language: PHP
• Size: 25.4 KB
• Stars: 11
• Watchers: 3
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# php ereg shim

This package emulates the old php extension for POSIX regular expressions

(ereg) if it's not available. Internally, the PCRE extension is used to process

regular expressions.

## Requirements and Usage

The library requires php 5.3 or newer. To add it to your projects, simply add

`derrabus/ereg-shim` to your composer dependencies.

```

composer require derrabus/ereg-shim

```

This should auto-register the shim for you. However, it remains inactive as

long as the ereg extension is active. It should be safe to include it in

projects that should be tested on php 5 and php 7/8 simultaneously.

You can also force the usage of the shim implementation on php 5 by directly

calling the corresponding methods on the `Rabus\EregShim\Ereg` class.

Global function call        | Forced shimmed function call

--------------------------- | -------------------------------------------------

`ereg('[0-9][^0-9]', '2a')` | `\Rabus\EregShim\Ereg::ereg('[0-9][^0-9]', '2a')`

## Purpose and limitations

This library can be helpful if you need to quicky migrate a legacy codebase to

php 7.0 and beyond. It will be slower than the native implementation and is not

intended to be a permanent solution. Code that depends on the ereg extension

should be refactored to use the corresponding PCRE functions instead.

The library has been developed against the test suite of the php 5.6 ereg

extension in order to get as close to the original behavior as possible. While

PCRE and POSIX regular expressions are very similar, they're not 100%

compatible. There are certain edge cases that this library cannot cover.