PHP preg_match(): Regular Expressions (Regex)

โšก Smart Summary

Regular Expressions in PHP are pattern-matching tools that validate, split, and replace text in a single expression. This walkthrough covers the core functions preg_match, preg_split, and preg_replace, explains the common metacharacters, and builds a working email validation pattern step by step.

  • ๐Ÿงฉ What Regex Is: A regular expression is a pattern that describes text, letting one function validate, search, or transform strings.
  • โœ… preg_match: preg_match tests whether a pattern appears in a string and returns true on the first match, ideal for validation.
  • โœ‚๏ธ preg_split: preg_split breaks a string into an array wherever the pattern occurs, such as splitting a sentence on spaces.
  • ๐Ÿ” preg_replace: preg_replace finds every match of a pattern and replaces it with new text, useful for templating and highlighting.
  • ๐Ÿ”ค Metacharacters: Symbols like ., ^, $, *, and + build complex patterns, for example anchoring a match to the start or end.
  • ๐Ÿ“ง Email Pattern: Character classes and quantifiers combine into a single pattern that checks whether an email address is well formed.
  • ๐Ÿค– AI Assist: AI tools can write a regex from a plain description and explain or debug a complex existing pattern.

PHP Regular Expressions

What is Regular expression in PHP?

PHP regular expressions, also known as regex, are a powerful pattern matching tool that can be performed in a single expression. Regular expressions use special characters such as +, -, and ^ to create complex expressions. They can help you accomplish tasks such as validating email addresses, IP addresses, and more.

Why use regular expressions

  • PHP regular expressions simplify identifying patterns in string data by calling a single function. This saves us coding time.
  • When validating user input such as email addresses, domain names, telephone numbers, and IP addresses
  • Highlighting keywords in search results
  • When creating a custom HTML template. Regex in PHP can be used to identify the template tags and replace them with actual data.

Built-in Regular expression Functions in PHP

PHP has built-in functions that allow us to work with regular expressions, which we will learn in this tutorial. Let us look at the commonly used regular expression functions in PHP.

  • preg_match() in PHP โ€“ this function is used to perform pattern matching on a string. It returns true if a match is found and false if a match is not found.
  • preg_split() in PHP โ€“ this function is used to perform a pattern match on a string and then split the results into a numeric array.
  • preg_replace() in PHP โ€“ this function is used to perform a pattern match on a string and then replace the match with the specified text.

Below is the syntax for a regular expression function such as preg_match(), preg_split(), or preg_replace().

<?php
function_name('/pattern/',subject);
?>

HERE,

  • “function_name(…)” is either preg_match(), preg_split(), or preg_replace().
  • “/…/” the forward slashes denote the beginning and end of our regular expression
  • “‘/pattern/'” is the pattern that we need to match
  • “subject” is the text string to be matched against

Let us now look at practical examples that implement the above PHP regex functions.

Preg_match() in PHP

The first example uses the preg_match() function to perform a simple pattern match for the word guru in a given URL.

The code below shows the implementation of the preg_match() function for the above example.

<?php
$my_url = "www.guru99.com";
if (preg_match("/guru/", $my_url))
{
echo "the url $my_url contains guru";
}
else
{
echo "the url $my_url does not contain guru";
}
?>

Browse to the URL http://localhost/phptuts/preg_match_simple.php

Built-in Regular expression Functions

Let us examine the part of the code responsible for our output, preg_match(‘/guru/’, $my_url). HERE,

  • “preg_match(…)” is the PHP regex function
  • “‘/guru/'” is the regular expression pattern to be matched
  • “$my_url” is the variable containing the text to be matched against.

PHP Preg_split()

Let us now look at another example that uses the preg_split() function.

We will take a string phrase and explode it into an array; the pattern to be matched is a single space.

The text string to be used in this example is “I Love Regular Expressions”.

The code below illustrates the implementation of the above example.

<?php

$my_text = "I Love Regular Expressions";

$my_array = preg_split("/ /", $my_text);

print_r($my_array );

?>

Browse to the URL http://localhost/phptuts/preg_split.php

PHP Preg_split()

PHP Preg_replace()

Let us now look at the preg_replace() PHP function that performs a pattern match and then replaces the pattern with something else.

The code below searches for the word guru in a string.

It replaces the word guru with the word guru surrounded by CSS code that highlights the background color.

<?php

$text = "We at Guru99 strive to make quality education affordable to the masses. Guru99.com";

$text = preg_replace("/Guru/", '<span style="background:yellow">Guru</span>', $text);

echo $text;

?>

Assuming you have saved the file preg_replace.php, browse to the URL http://localhost/phptuts/preg_replace.php

PHP Preg_replace()

Regular Expression Metacharacters

The above examples used very basic patterns. Metacharacters allow us to perform more complex pattern matches, such as testing the validity of an email address. Let us now look at the commonly used metacharacters.

Metacharacter Description Example
. Matches any single character except a new line /./ matches anything that has a single character
^ Matches the beginning of a string or excludes characters /^PH/ matches any string that starts with PH
$ Matches a pattern at the end of the string /com$/ matches guru99.com, yahoo.com etc.
* Matches zero or more of the preceding characters /com*/ matches computer, communication etc.
+ Requires the preceding character(s) appear at least once /yah+oo/ matches yahoo
\ Used to escape metacharacters /yahoo+\.com/ treats the dot as a literal value
[…] Character class /[abc]/ matches a, b or c
a-z Matches lower case letters /a-z/ matches cool, happy etc.
A-Z Matches upper case letters /A-Z/ matches WHAT, HOW, WHY etc.
0-9 Matches any number between 0 and 9 /0-4/ matches 0,1,2,3,4

The above list only gives the most commonly used metacharacters in regular expressions.

Let us now look at a fairly complex example that checks the validity of an email address.

<?php
$my_email = "name@company.com";
if (preg_match("/^[a-zA-Z0-9._-]+@[a-zA-Z0-9-]+\.[a-zA-Z.]{2,5}$/", $my_email)) {
echo "$my_email is a valid email address";
}
else
{
echo "$my_email is NOT a valid email address";
}
?>

Explaining the Email Validation Pattern

HERE,

  • “/…/” starts and ends the regular expression
  • “^[a-zA-Z0-9._-]” matches any lower or upper case letters, numbers between 0 and 9, and dots, underscores, or dashes.
  • “+@[a-zA-Z0-9-]” matches the @ symbol followed by lower or upper case letters, numbers between 0 and 9, or dashes.
  • “+\.[a-zA-Z.]{2,5}$/” escapes the dot using the backslash, then matches any lower or upper case letters with a character length between 2 and 5 at the end of the string.

Browse to the URL http://localhost/phptuts/preg_match.php

PHP Email Validation Pattern

As you can see from the above breakdown, metacharacters are very powerful when it comes to matching patterns.

FAQs

preg_match stops at the first match and fills $matches with that one result. preg_match_all finds every match in the string and returns them all in a nested array, which suits extracting repeated items.

Modifiers follow the closing delimiter and change matching behavior. The i modifier makes the pattern case insensitive, m treats each line separately for ^ and $, and s lets the dot match newlines, as in /guru/i.

Wrap parts of the pattern in parentheses to create capture groups. After preg_match, the full match is in $matches[0] and each group follows in $matches[1], $matches[2], and so on.

Yes. Describe the text you want to match, such as a phone number or date format, and AI can produce the pattern plus a preg_match example. Test it against real and edge-case inputs before relying on it.

Yes. Paste the pattern, and AI can break it down token by token, explain what each part matches, and point out why it fails on certain input, then suggest a corrected version.

Summarize this post with: