preg_replace是PHP中基于PCRE引擎的字符串正则替换函数,支持全局匹配、捕获组引用、大小写忽略等特性,语法为preg_replace($pattern, $replacement, $subject, $limit=-1, &$count)。

如果您需要在PHP中对字符串执行模式匹配并进行替换操作,则可以使用内置函数preg_replace。该函数基于Perl兼容正则表达式(PCRE)引擎,支持复杂的模式匹配与动态替换逻辑。以下是具体使用方式:
一、基础语法与参数说明
preg_replace函数接收三个必需参数和两个可选参数,核心作用是将符合正则表达式的子串替换为指定内容。其行为依赖于正则表达式是否启用全局匹配、是否区分大小写等修饰符。
1、第一个参数为正则表达式模式,必须以分隔符开头和结尾,常用分隔符为斜杠“/”,例如 "/abc/";
2、第二个参数为替换内容,可为字符串或包含反向引用的格式,如 "$1" 表示捕获组第一项;
立即学习“PHP免费学习笔记(深入)”;
3、第三个参数为待处理的原始字符串,支持字符串或字符串数组;
4、第四个参数(可选)用于限制最大替换次数,设为-1表示无限制;
5、第五个参数(可选)用于接收实际完成的替换次数,需传入变量引用。
二、单次简单替换
适用于仅需替换首个匹配项的场景,不启用全局修饰符g时,默认只替换第一次出现的匹配内容。
1、定义原始字符串:$str = "apple banana apple cherry";
2、编写正则模式:$pattern = "/apple/";
3、设定替换内容:$replacement = "orange";
4、调用函数:$result = preg_replace($pattern, $replacement, $str, 1);
5、输出结果:echo $result; → orange banana apple cherry
三、全局替换所有匹配项
通过在正则模式末尾添加修饰符“g”(即“/pattern/g”),可实现对全部匹配位置的替换。注意PHP中实际使用“/pattern/g”写法,但需确保分隔符一致且修饰符正确放置。
1、定义原始字符串:$str = "cat bat rat";
2、编写带全局修饰符的模式:$pattern = "/at/g";
3、设定替换内容:$replacement = "dog";
4、调用函数:$result = preg_replace($pattern, $replacement, $str);
5、输出结果:echo $result; → cdog bdog rdog
四、使用捕获组进行结构化替换
当正则表达式中包含圆括号包围的子表达式时,会形成捕获组,可在替换字符串中通过$1、$2等方式引用对应匹配内容,从而实现保留部分原始结构的同时修改其他部分。
1、定义原始字符串:$str = "name: Alice, age: 30";
2、编写含捕获组的模式:$pattern = "/name:\s*(\w+),\s*age:\s*(\d+)/";
3、设定替换内容为反转顺序:$replacement = "age: $2, name: $1";
4、调用函数:$result = preg_replace($pattern, $replacement, $str);
5、输出结果:echo $result; → age: 30, name: Alice
五、忽略大小写的替换
在处理用户输入或非标准化文本时,常需忽略字母大小写差异。此时可在正则模式后添加修饰符“i”,使匹配过程不区分大小写。
1、定义原始字符串:$str = "Hello WORLD hello";
2、编写带大小写忽略修饰符的模式:$pattern = "/hello/i";
3、设定替换内容:$replacement = "hi";
4、调用函数:$result = preg_replace($pattern, $replacement, $str);
5、输出结果:echo $result; → hi hi hi











