PHP正则替换函数preg_replace和preg_replace_callback使用总结

在编写php模板引擎工具类时，以前常用的一个正则替换函数为 preg_replace()，加上正则修饰符 /e，就能够执行强大的回调函数，实现模板引擎编译（其实就是字符串替换）。

详情介绍参考博文：php函数preg_replace() 正则替换所有符合条件的字符串

应用举例如下：

<?php
/**
 * 模板解析类
 */
class template {

 public function compile($template) {

  // if逻辑
  $template = preg_replace("/\<\!\-\-\{if\s+(.+?)\}\-\-\>/e", "\$this->iftag('\\1')", $template);

  return $template;
 }

 /**
  * if 标签
  */
 protected function iftag($str) {

  //$str = stripslashes($str); // 去反转义

  return '<?php if (' . $str . ') { ?>';
 }
}

$template = 'xxx<!--{if $user[\'username\']}-->yyy<!--{if $user["password"]}-->zzz';

$tplcomplier = new template();

$template = $tplcomplier->compile($template);

echo $template;

?>

输出结果为：

xxx<?php if ($user['username']) { ?>yyy<?php if ($user[\"password\"]) { ?>zzz

仔细观察，发现 $user["password"] 中的双引号被转义了，这不是我们想要的结果。

为了能够正常输出，还必须反转义一下，但是，如果字符串中本身含有反转义双引号的话，我们此时反转义，原本的反转义就变成了非反转义了，这个结果又不是我们想要的，所以说这个函数在这方面用的不爽！

后来，发现一个更专业级的 正则替换回调函数 preg_replace_callback()。

mixed preg_replace_callback ( mixed pattern, callback callback, mixed subject [, int limit] )
本函数的行为几乎和 preg_replace() 一样，除了不是提供一个 replacement 参数，而是指定一个 callback 函数。该函数将以目标字符串中的匹配数组作为输入参数，并返回用于替换的字符串。

回调函数 callback：

一个回调函数，在每次需要替换时调用，调用时函数得到的参数是从subject 中匹配到的结果。回调函数返回真正参与替换的字符串。这是该回调函数的签名：

string handler ( array $matches )

像上面所看到的，回调函数通常只有一个参数，且是数组类型。

罗列一些有关preg_replace_callback()函数的实例：

example #1 preg_replace_callback() 和 匿名函数

<?php
/* 一个unix样式的命令行过滤器，用于将段落开始部分的大写字母转换为小写。 */
$fp = fopen("php://stdin", "r") or die("can't read stdin");
while (!feof($fp)) {
    $line = fgets($fp);
    $line = preg_replace_callback(
        '|<p>\s*\w|',
        function ($matches) {
            return strtolower($matches[0]);
        },
        $line
    );
    echo $line;
}
fclose($fp);
?>

如果回调函数是个匿名函数，在php5.3中，通过关键字use，支持给匿名函数传多个参数，如下所示：

<?php
$string = "some numbers: one: 1; two: 2; three: 3 end";
$ten = 10;
$newstring = preg_replace_callback(
    '/(\\d+)/',
    function($match) use ($ten) { return (($match[0] + $ten)); },
    $string
    );
echo $newstring;
#prints "some numbers: one: 11; two: 12; three: 13 end";
?>

example #2 preg_replace_callback() 和 一般函数

<?php
// 将文本中的年份增加一年.
$text = "april fools day is 04/01/2002\n";
$text.= "last christmas was 12/24/2001\n";
// 回调函数
function next_year($matches) {
  // 通常: $matches[0]是完成的匹配
  // $matches[1]是第一个捕获子组的匹配
  // 以此类推
  return $matches[1].($matches[2]+1);
}
echo preg_replace_callback(
            "|(\d{2}/\d{2}/)(\d{4})|",
            "next_year",
            $text);

?>

example #3 preg_replace_callback() 和 类方法

如何在类的内部调用非静态函数？你可以按如下操作：
对于 php 5.2，第二个参数 像这样 array($this, 'replace') ：

<?php
class test_preg_callback{

  private function process($text){
    $reg = "/\{([0-9a-za-z\- ]+)\:([0-9a-za-z\- ]+):?\}/";
    return preg_replace_callback($reg, array($this, 'replace'), $text);
  }
 
  private function replace($matches){
    if (method_exists($this, $matches[1])){
      return @$this->$matches[1]($matches[2]);    
    }
  } 
}
?>

对于 php5.3，第二个参数像这样 "self::replace" ：
注意，也可以是 array($this, 'replace')。

<?php
class test_preg_callback{

  private function process($text){
    $reg = "/\{([0-9a-za-z\- ]+)\:([0-9a-za-z\- ]+):?\}/";
    return preg_replace_callback($reg, "self::replace", $text);
  }
 
  private function replace($matches){
    if (method_exists($this, $matches[1])){
      return @$this->$matches[1]($matches[2]);    
    }
  } 
}
?>

根据上面所学到的知识点，把模板引擎类改造如下：

<?php
/**
 * 模板解析类
 */
class template {

 public function compile($template) {

  // if逻辑
  $template = preg_replace_callback("/\<\!\-\-\{if\s+(.+?)\}\-\-\>/", array($this, 'iftag'), $template);

  return $template;
 }

 /**
  * if 标签
  */
 protected function iftag($matches) {
  return '<?php if (' . $matches[1] . ') { ?>';
 }
}

$template = 'xxx<!--{if $user[\'username\']}-->yyy<!--{if $user["password"]}-->zzz';

$tplcomplier = new template();

$template = $tplcomplier->compile($template);

echo $template;

?>

输出结果为：

xxx<?php if ($user['username']) { ?>yyy<?php if ($user["password"]) { ?>zzz

正是我们想要的结果，双引号没有被反转义！

ps：关于正则，本站还提供了2款非常简便实用的正则表达式工具供大家使用：

javascript正则表达式在线测试工具：

正则表达式在线生成工具：