Download the PHP package hoels/regex without Composer
On this page you can find all versions of the php package hoels/regex. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package regex
RegEx Wrapper
This is a wrapper around regular expressions.
Regular expressions in PHP are a common point of failure and working with match groups in particular can be a major
headache. Inspired by the functionality Kotlin offers with its Regex class, I decided to start implementing a similar
functionality for PHP. Hoping that one day, the PHP team will improve the preg_* functions, this library provides a
very simple wrapper around regular expressions in PHP.
In contrast to the Kotlin implementation, the delimiters (e.g. / at the beginning and end of the expression) have to
be set. This allows for greater flexibility.
Installation
Requirements
- PHP 8.1+
Composer
Documentation
Regex class
The main class of this library is the Regex class. The class currently provides the following functions:
containsMatchIn
Indicates whether there is at least one match in $input for the regex given in $regex.
find
Returns the first match in $input for the regex given in $regex. Returns null if there is no match and an
MatchResult object if there is a match.
findAll
Returns an array of MatchResult objects for all matches in $input for the regex given in $regex. Returns an
empty array if there is no match.
matchAt
Returns the first match in $input for the regex given in $regex, only if the match starts at $index. Returns null
if there is no match and an MatchResult object if there is a match at $index.
replace
Replaces all occurrences of $regex in $input by the replacement expression $replacement. Example:
replaceFirst
Replaces the first occurrence of $regex in $input by the replacement expression $replacement. Example:
MatchResult class
The MatchResult class has three properties:
value(string): The matched string.offset(int): The offset of the matched string within the input string.groups(MatchGroup[]): An array of all matched groups.
Groups
The groups property contains an array of MatchGroup objects.
The first element (index 0) will always represent the matched string, therefore the value and offset properties of
the MatchGroup object will be the same as the ones of its MatchResult parent.
If the regular expression did not declare any groups, the first element will be the only one in the array.
If the regular expression does declare groups, there will be a MatchGroup object for every group in the order of
appearance. Therefore, the first group will have the index 1, the second the index 2, and so on. If there are named
groups, there will be additional array elements with the name as index. Note that the MatchGroup object will have the
same properties as the one with the numeric index, but the object reference will not be the same.
MatchGroup class
The MatchGroup class has two properties:
value(string|null): The matched string ornullif the declared group is outside the matched string.offset(int): The offset of the matched string within the input string. -1 if the declared group is outside the matched string.
