PHP
downloads | documentation | faq | getting help | mailing lists | licenses | wiki | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

preg_replace> <preg_quote
Last updated: Fri, 19 Jun 2009

view this page in

preg_replace_callback

(PHP 4 >= 4.0.5, PHP 5)

preg_replace_callbackВыполняет поиск по регулярному выражению и замену с использованием функции обратного вызова

Описание

mixed preg_replace_callback ( mixed $pattern , callback $callback , mixed $subject [, int $limit ] )

Поведение этой функции во многом напоминает preg_replace(), за исключением того, что вместо параметра replacement необходимо указывать callback функцию, которой в качестве входящего параметра передается массив найденных вхождений. Ожидаемый результат - строка, которой будет произведена замена.

Пример #1 preg_replace_callback() пример

<?php
  
// Этот текст был использован в 2002 году
  // мы хотим обновить даты к 2003 году
  
$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);

  
// результат:
  // April fools day is 04/01/2003
  // Last christmas was 12/24/2002
?>

Достаточно часто callback функция, кроме как в вызове preg_replace_callback(), ни в чем больше не участвует. Исходя из этих соображений, можно использовать create_function() для создания безымянной функции обратного вызова непосредственно в вызове preg_replace_callback(). Если вы используете такой подход, вся информация, связанная с заменой по регулярному выражению, будет собрана в одном месте, и пространство имен функций не будет загромождаться неиспользуемыми записями.

Пример #2 preg_replace_callback() и create_function()

<?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|',
          
create_function(
              
// Использование одиночных кавычек в данном случае принципиально,
              // альтернатива - экранировать все символы '$'
              
'$matches',
              
'return strtolower($matches[0]);'
          
),
          
$line
      
);
      echo 
$line;
  }
  
fclose($fp);
?>

Смотрите также preg_replace() и create_function().



preg_replace> <preg_quote
Last updated: Fri, 19 Jun 2009
 
add a note add a note User Contributed Notes
preg_replace_callback
carlos dot ballesteros at softonic dot com
02-Jul-2009 03:02
A simple function to replace a list of complete words or terms in a string (for PHP 5.3 or above because of the closure):

<?php
function replace_words($list, $line, $callback) {
    return
preg_replace_callback(
       
'/(^|[^\\w\\-])(' . implode('|', array_map('preg_quote', $list)) . ')($|[^\\w\\-])/mi',
        function(
$v) use ($callback) { return $v[1] . $callback($v[2]) . $v[3]; },
       
$line
   
);
}
?>

Example of usage:
<?php
$list
= array('php', 'apache web server');
$str = "php and the apache web server work fine together. php-gtk, for example, won't match. apache web servers shouldn't too.";

echo
replace_words($list, $str, function($v) {
    return
"<strong>{$v}</strong>";
});
?>
chris AT cmbuckley DOT co DOT uk
09-Jun-2009 02:44
This function does not support named subpatterns, so you can't do

<?php

preg_replace_callback
('/(?<char>[a-z])/', 'callback', 'word');

function
callback($matches) {
   
var_dump($matches);
}

?>

and expect to get $matches['char'] in your function.
mariush
12-May-2009 08:17
If you're planning to use preg_replace_callback inside a class, you need to use the array() function:

<?php
class MyClass
{

  function
preg_callback_url($matches)
  {
   
//var_dump($matches);
   
$url = $matches[1].$matches[2];
   
$text = '';
   
$pos = strpos($url,' ');
    if (
$pos!==FALSE) {
     
$text = trim(substr($url,$pos+1));
     
$url = substr($url,0,$pos);
    }
    return
'<a href="'.$url.'" rel="nofollow">'.(($text!='') ? $text : $url).'</a>';
  }

  function
ParseText($text)
  {
    return
preg_replace_callback('/\[(http|https|ftp)(.*?)\]/iS',array( &$this, 'preg_callback_url'), $text);
  }

}
?>
james dot records at gmail dot com
26-Apr-2009 07:22
This is what i use to read log files and do dns lookups on the ip's from the file.

<?php
function resolve_logs($arr) {
        return
gethostbyaddr($arr[0]);
}

$logent=file('yourlogfile');

$ipaddr = '/\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}/';
$logent = preg_replace_callback($ipaddr, resolve_logs, $logent);
?>
long2hu3 ATT yahoo DOTT com
02-Apr-2009 07:25
When you access variables from outside in a callback function, use the $global keyword:

<?php

// global # 1:
global $x;

$x = 0;
$str = '&Bla bla. &#x25ba;';

$find = '/(\&)([^#])/';

// global # 2:
$replace = create_function('$f',
   
'global $x; $x ++; return $f[2];';

$str2 = preg_replace_callback($find, $replace, $str);

// $x == 1
// $str2 == 'Bla bla. &#x25ba;'
// without global, $x would be 0

?>
tijn at q-go dot com
06-Jan-2009 10:01
To access a local variable within a callback, use currying (delayed argument binding). For example
<?php
function curry($func, $arity) {
    return
create_function('', "
        \$args = func_get_args();
        if(count(\$args) >= $arity)
            return call_user_func_array('$func', \$args);
        \$args = var_export(\$args, 1);
        return create_function('','
            \$a = func_get_args();
            \$z = ' . \$args . ';
            \$a = array_merge(\$z,\$a);
            return call_user_func_array(\'$func\', \$a);
        ');
    "
);
}

function
on_match($transformation, $matches)
{
    return
$transformation[strtolower($matches[1])];
}

$transform = array('a' => 'Well,', 'd'=>'whatever', 'b'=>' ');

$callback = curry(on_match, 2);
echo
preg_replace_callback('/([a-z])/i', $callback($transform), 'Abcd');

echo
"\n";
?>

outputs:

"Well, whatever"

The magic lies in this curry function I found here: http://www.sitepoint.com/forums/showthread.php?threadid=336758
tijn at q-go dot com
05-Jan-2009 04:48
To access a local variable within a callback, use currying (delayed argument binding). For example
<?php
function curry($func, $arity) {
    return
create_function('', "
        \$args = func_get_args();
        if(count(\$args) >= $arity)
            return call_user_func_array('$func', \$args);
        \$args = var_export(\$args, 1);
        return create_function('','
            \$a = func_get_args();
            \$z = ' . \$args . ';
            \$a = array_merge(\$z,\$a);
            return call_user_func_array(\'$func\', \$a);
        ');
    "
);
}

function
on_match($transformation, $matches)
{
    return
$transformation[strtolower($matches[1])];
}

$transform = array('a' => 'Well,', 'd'=>'whatever', 'b'=>' ');

$callback = curry(on_match, 2);
echo
preg_replace_callback('/([a-z])/i', $callback($transform), 'Abcd');

echo
"\n";
?>

outputs:

"Well, whatever"

The magic lies in this curry function I found here: http://www.sitepoint.com/forums/showthread.php?threadid=336758
nicolaspar at gmail dot com
20-Dec-2008 02:33
To spend more than one parameter can do the following (note the "e" parameter in preg_replace function)
<?
$array
= array(
1=>'ONE',
2=>'TWO',
3=>'Three'
);

function
search(&$array, $str, $foo, $bar){
    return ( empty(
$array[$str]) ? '['.$foo.'-'.$bar.']' : $array[$str] );
}

function
keys(&$array, $str,$foo,$bar){
    return
preg_replace('/\[(.*?)\]/e',"search(\$array,$1,\$foo,\$bar)",$str);
}

$str = "One [1] Two [2] Three [3], Other parameter [22]";

echo
keys($array, $str,'Foo','Bar');
?>
Nice
harrrrpo at gmail dot com
19-Sep-2008 07:59
The last example -nested BBCode- has a problem and won't work
it should be
<?php
  $regex
= '#\[indent]((?:[^\[]|\[(?!/?indent])|(?R))+)\[/indent]#';
?>
([ should be escaped to be \[)

--
a nicer regex i used in a BBCode parser  (BBEngine http://www.phpclasses.org/browse/package/4829.html)
This one Captures Tag Arguments ,Empty tags and
also uses ?> for performance , wrapped in a simple function for templating (ofcourse it's one line but note's line size is limited :) )
<?php
    
/**
     * A Template for the recursive tags matcher RE
     * it generates it for a given tag ,open bracket and closing one
     * $O & $C must be pre-escaped from #'s
     * @param String $tag Tag to be parsed recursively
     * @param String $O   Opeening brackets of tag
     * @param String $C   Closing brackets of tag
     */
   
public function Recursive_RE_Generator($tag,$O,$C)
    {
      
$re="#{$O}({$tag}.*?){$C}((?>{$O}(?!/?{$tag}[^{$O}]*?{$C})|
[^{$O}]|(?R))*){$O}/{$tag}{$C}#is"
;
        return
$re;
    }
?>
nene at triin dot net
20-May-2008 10:14
The first example is bad, because it creates function for every line it processes. When the file has many lines, you could easily run out of memory. The code should be changed so, that create_function() is used outside of loop.
Sjon at hortensius dot net
24-Jun-2007 11:56
preg_replace_callback returns NULL when pcre.backtrack_limit is reached; this sometimes occurs faster then you might expect. No error is raised either; so don't forget to check for NULL yourself
matt at mattsoft dot net
26-Apr-2006 09:16
it is much better on preformance and better practice to use the preg_replace_callback function instead of preg_replace with the e modifier.

function a($text){return($text);}

// 2.76 seconds to run 50000 times
preg_replace("/\{(.*?)\}/e","a('\\1','\\2','\\3',\$b)",$a);

// 0.97 seconds to run 50000 times
preg_replace_callback("/\{(.*?)\}/s","a",$a);

preg_replace> <preg_quote
Last updated: Fri, 19 Jun 2009
 
 
show source | credits | sitemap | contact | advertising | mirror sites