README

T-Regx | Regular Expressions library

PHP regular expressions brought up to modern standards.

See documentation at t-regx.com.

1. Installation
   • Composer
2. API
3. Documentation
4. T-Regx fiddle - Try online
5. Overview
6. Comparison
7. License

Installation

Installation for PHP 7.1 and later (PHP 8 as well):

composer require rawr/t-regx

API

You, choose the interface:

• I choose to keep PHP methods (but protected from errors):

  Scroll to see - preg::match_all(), preg::replace_callback(), preg::split()

• I choose the modern regex API:

  Scroll to see - pattern()->test(), pattern()->match(), pattern()->replace()

Documentation

Full API documentation is available at t-regx.com. List of changes is available in ChangeLog.md.

Try it online, in your browser!

Open T-Regx fiddle and start playing around.

Why T-Regx stands out?

💡 See documentation at t-regx.com

• No change in API!

  • You can use T-Regx safe features and exception-based error handling, without changing your API.

    Simply swap preg_match() to preg::match(), and your method is safe! Arguments and return types remain the same.

• Prepared patterns

  Using user data (for example with preg_quote()) isn't always safe with PCRE, as well as just not being that convenient to use. T-Regx provides Pattern::inject() and Pattern::bind() methods, designed specifically for handling potentially unsafe data. Pattern::format() allows converting user-supplied masks into full-fledged patterns safely.

• Working with the developer

  • Errors:
    • Not even touching your error handlers in any way
    • Converts all PCRE notices/error/warnings to exceptions
    • Preventing fatal errors
  • Strings:
    • Tracking offset and subjects while replacing strings
    • Fixing error with multi-byte offset (utf-8 safe)

• Automatic delimiters for your pattern

  Surrounding slashes or tildes (/pattern/ or ~patttern~) are not compulsory.

• Converting Warnings/Errors to Exceptions

  • Malformed patterns in preg_() methods don't make preg_last_error() to return error.
  • Notices, warnings or errors during preg:: are converted to exceptions.
  • preg_() can never fail, because it throws PregException on warning/error.
  • In some cases, preg_() methods might fail, return false/null and NOT trigger a warning. Separate exception, SuspectedReturnPregException is then thrown by T-Regx.

• Written with clean API

  • Descriptive, chainable interface
  • SRP methods
  • UTF-8 support out-of-the-box
  • No Reflection used, No (...varargs), No (boolean arguments, true), (No flags, 1) , [No [nested, [arrays]]]

• Protects your from fatal errors

  Certain arguments cause fatal errors with preg_() methods. T-Regx will throw a catchable exception, instead of a Fatal Error.

What's better

or

Sponsors

Andreas Leathley - developing SquirrelPHP

T-Regx is developed thanks to

License

T-Regx is MIT licensed.