https://github.com/hotmeteor/regex
A set of ready-made regex helper methods for use in your Laravel application.
https://github.com/hotmeteor/regex
laravel library php regex
Last synced: about 1 month ago
JSON representation
A set of ready-made regex helper methods for use in your Laravel application.
- Host: GitHub
- URL: https://github.com/hotmeteor/regex
- Owner: hotmeteor
- Created: 2021-08-09T14:15:29.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-06-19T20:01:22.000Z (7 months ago)
- Last Synced: 2025-09-28T10:55:30.438Z (4 months ago)
- Topics: laravel, library, php, regex
- Language: PHP
- Homepage:
- Size: 23.4 KB
- Stars: 245
- Watchers: 2
- Forks: 6
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Regex
A set of ready-made regex helper methods for use in your Laravel application.
[](https://packagist.org/packages/hotmeteor/regex)
## Installation
```shell
composer require hotmeteor/regex
```
## Usage
Regex comes with a set of common regex patterns that are ready to use. These patterns can be used to either **replace** or **match** against values. Every pattern is both case-insensitive and able to interpret unicode characters, and should support all languages.
Additionally, beyond the methods below both the underlying `match` and `replace` methods are exposed to pass in custom patterns.
### Match
Match methods return true or false depending on if the subject value contains anything but the expected pattern.
You may optional allow whitespace by passing `true` as a second parameter.
#### Methods
```php
Regex::isAlpha($subject, $allowWhitespace = false)
```
Checks if the value contains anything but letters.
***
```php
Regex::isAlphanumeric($subject, $allowWhitespace = false)
```
Checks if the value contains anything but letters and numbers.
***
```php
Regex::isAlphadash($subject, $allowWhitespace = false)
```
Checks if the value contains anything but letters, numbers, and `.-_`.
***
```php
Regex::isDigits($subject, $allowWhitespace = false)
```
Checks if the value contains anything but integers.
***
```php
Regex::isNumeric($subject)
```
Checks if the value contains anything but numeric values, including decimals and negative numbers. Does not allow for whitespace.
***
```php
Regex::isUuid($subject)
```
Checks if the value is a UUID. Does not allow for whitespace.
***
```php
Regex::isIp($subject) // or
Regex::isIpv4($subject)
```
Checks if the value is an IPv4 address. Does not allow for whitespace.
***
```php
Regex::isIpv6($subject)
```
Checks if the value is an IPv6 address. Does not allow for whitespace.
### Replace
Replace methods replace anything in the subject value that doesn't match the pattern with the provided replacement.
The default replacement is nothing: it just removes the character.
#### Methods
```php
Regex::alpha($subject, $replace = '')
```
Replaces all characters in the subject except letters.
***
```php
Regex::alphanumeric($subject, $replace = '')
```
Replaces all characters in the subject except letters and numbers.
***
```php
Regex::alphadash($subject, $replace = '')
```
Replaces all characters in the subject except letters, numbers, and `.-_`.
***
```php
Regex::digits($subject, $replace = '')
```
Replaces all characters in the subject except integers.
***
```php
Regex::numeric($subject, $replace = '')
```
Replaces all characters in the subject except numeric values, including decimals and negative numbers.
***
```php
Regex::uuid($subject)
```
Replaces all characters in the subject to form it into a UUID. Does not accept a replacement value.
***
```php
Regex::ip($subject) // or
Regex::ipv4($subject)
```
Replaces all characters in the subject to form it into an IPv4 address. Does not accept a replacement value.
```php
Regex::ipv6($subject)
```
Replaces all characters in the subject to form it into an IPv6 address. Does not accept a replacement value.