PHP Tutorial
Control Statement
PHP Programs
- 20-php-programs
PHP Functions
PHP Arrays
PHP Strings
- php-string
- php-string-functions
PHP Math
- php-math-functions
PHP Form
- php-form:-get-post
PHP Include
- php-include-require
State Management
- php-cookie
- php-session
PHP File
Upload Download
- php-file-upload
- php-download-file
PHP Misc
PHP Mail
- php-mail
PHP MySQLi
PHP JSON
- php-json-example
PHP OOPs Concepts
PHP Topics
Related Tutorials
Interview Questions

PHP preg_replace() function

The preg_replace() function is a built-in function of PHP. It is used to perform a regular expression search and replace.

This function searches for pattern in subject parameter and replaces them with the replacement.

Syntax

     preg_replace (mixed $pattern, mixed $replacement, mixed $subject, int $limit, int $count)

    

Parameters

This function accepts five parameters, which are described below:

pattern

This parameter can be either a string or an array with strings. It holds the pattern to search in subject parameter.

replacement

It is a string or an array with strings parameter. This parameter replaces the pattern matched in subject parameter. It is a mandatory parameter.

If the replacement parameter is a string and the pattern parameter is an array, all patterns will be replaced by that string.
If both replacement and pattern parameters are arrays, each pattern will be replaced by the replacement counterpart.
If the replacement array consists of fewer elements than the pattern array, any extra pattern will be replaced by an empty string.

subject

The subject parameter can also be either a string or an array of string to search and replace.

If the subject is an array, the search and replacement are performed on every entry of subject, and the returned value will also be an array.

limit

The limit is an optional parameter that specifies the maximum possible replacement for each pattern. The default value of limit is -1, which means no limit.

count

It is an optional parameter. If this parameter is passed, this variable will contain the number of replacements done. This parameter added in PHP 5.1.0.

Return Type

The preg_replace() function returns an array if the subject parameter is an array otherwise it returns a string.

After the replacement has done, the modified string will be returned.
If any matches do not find, the string will remain unchanged.

Examples

Simple Replacing

     $res = preg_replace('/abc/', 'efg', $string);		#Replace all 'abc' with 'efg'
$res = preg_replace('/abc/i', 'efg', $string);		#Replace with case-insensitive matching
$res = preg_replace('/\s+/', '', $string);		#Strip all whitespace	

    

See the detailed examples to understand the preg_replace() function practically:

Example using backreference followed by numeric literals

     <?php
	$date = 'May 29, 2020';
	$pattern = '/(\w+) (\d+), (\d+)/i';
	$replacement = '${1} 5,$3';
		
	//display the result returned by preg_replace
	echo preg_replace($pattern, $replacement, $date);
?>

    

Output:

May 5, 2020

Example to strip whitespace

In the below example, preg_replace() removes all extra whitespace from the given string.

     <?php
	$str = 'Camila    Cabello   is    a   Hollywood    singer.';
	$str = preg_replace('/\s+/', ' ', $str);
	echo $str;
?>

    

Output:

Camila Cabello is a Hollywood singer.

Example using indexed arrays

This example will contain a pattern array to replace with replacement array.

     <?php		
	//declare a string
	$string = 'The slow black bear runs away from the zoo.';
	$patterns = array();
	
	//pattern to search in subject string
	$patterns[0] = '/slow/';
	$patterns[1] = '/black/';
	$patterns[2] = '/bear/';
	
	//replacement value to replace with pattern in the given search string
	$replacements = array();
	$replacements[2] = 'fox';
	$replacements[1] = 'brown';
	$replacements[0] = 'quick';
	
	//apply preg_replace function
	$newstr = preg_replace($patterns, $replacements, $string);
	echo "<b>String after replacement:</b> " .$newstr;
?>

    

Output:

String after replacement: The fox brown quick runs away from the zoo.

In the above example, we can see that output is not same as we want. Therefore, by applying ksort() on patterns and replacements before using preg_replace(), we can get what we want to.

     <?php	
	//declare a string
	$string = 'The slow black bear runs away from the zoo.';
	$patterns = array();
	
	//pattern to search in subject string
	$patterns[0] = '/slow/';
	$patterns[1] = '/black/';
	$patterns[2] = '/bear/';
	
	//replacement value to replace with pattern in the given search string
	$replacements = array();
	$replacements[2] = 'fox';
	$replacements[1] = 'brown';
	$replacements[0] = 'quick';
	
	//sort the values of both pattern and replacement
	ksort($patterns);
	ksort($replacements);
	
	//apply preg_replace function
	$newstr = preg_replace($patterns, $replacements, $string);
	echo "<b>String after replacement using ksort:</b> " .$newstr;
?>

    

Output:

String after replacement using ksort: The quick brown fox runs away from the zoo.

Next TopicPHP Functions

← prev next →

Hot Tutorials

HTML/CSS

JavaScript

Backend language

Development Framework

Database

Mobile development

Development tools

Big Data

XML Tutorial

Contact US

Email:jjw.quan@gmail.com

PHP Tutorial

Control Statement

PHP Programs

PHP Functions

PHP Arrays

PHP Strings

PHP Math

PHP Form

PHP Include

State Management

PHP File

Upload Download

PHP Misc

PHP Mail

PHP MySQLi

PHP JSON

PHP OOPs Concepts

PHP Topics

Related Tutorials

Interview Questions

PHP preg_replace() function

Syntax

Parameters

Return Type

Examples

Hot Tutorials

Python tutorial

Vue.js Tutorial

HTML Tutorial

Java Tutorial

PHP Tutorial

Spring Tutorial

JavaScript Tutorial

CSS Tutorial

jQuery Tutorial

SQL Tutorial

C Tutorial

HTML/CSS

HTML Tutorial

HTML5 Tutorial

CSS Tutorial

Bootstrap Tutorial

JavaScript

JavaScript Tutorial

Vue.js Tutorial

ReactJS Tutorial

jQuery Tutorial

Node.js Tutorial

TypeScript Tutorial

AngularJS Tutorial

JSON Tutorial

Ajax Tutorial

ES6 Tutorial

Angular 7 Tutorial

jQuery UI Tutorial

Backend language

Python tutorial

Java Tutorial

Node.js Tutorial

PHP Tutorial

Go Tutorial

C Tutorial

C++ Tutorial

C# Tutorial

Ruby Tutorial

JSP Tutorial

JSTL Tutorial

ASP.NET Tutorial

Perl Tutorial

Scala Tutorial

VBA Tutorial

Development Framework

Spring Tutorial

Spring Boot Tutorial

Django Tutorial

Servlet Tutorial

Struts 2 Tutorial

Hibernate Tutorial

Solr Tutorial

Database