Last updated: Tue, 30 Jun 2009

preg_replace_callback

(PHP 4 >= 4.0.5, PHP 5)

preg_replace_callback — Rechercher et remplacer par expression rationnelle standard en utilisant une fonction de callback

Description

mixed preg_replace_callback ( mixed $pattern , callback $callback , mixed $subject [, int $limit= -1 [, int &$count ]] )

Le comportement de preg_replace_callback() est presque identique à celui de preg_replace(), hormis le fait qu'à la place du paramètre replacement , il faut spécifier une fonction de rappel callback qui sera appelée, avec les éléments trouvés en arguments.

Liste de paramètres

pattern

Le masque à chercher. Il peut être une chaîne de caractères ou un tableau contenant des chaînes.

callback

La fonction de rappel qui recevra le tableau d'éléments trouvés dans la chaîne subject . La fonction de rappel doit retourner la chaîne de remplacement.

Vous aurez souvent besoin de la fonction callback avec preg_replace_callback() à un seul endroit. Dans ce cas, vous pouvez simplement utiliser la fonction create_function() pour déclarer une fonction anonyme comme fonction de rappel pour preg_replace_callback(). En faisant cela, vous concentrez toutes les routines liées à votre remplacement à un seul endroit, et nous ne polluez par votre espace de noms de fonctions avec des fonctions à usage unique.

Exemple #1 preg_replace_callback() et create_function()


<?php
// Un filtre de ligne de commande Unix pour convertir les lettres
// en majuscule de début des paragraphe en minuscules

$fp = fopen("php://stdin", "r") or die("Impossible de lire la ligne de commande");
while (!feof($fp)) {
    $line = fgets($fp);
    $line = preg_replace_callback(
        '|<p>\s*\w|',
        create_function(
            // Les guillemets simples sont très importants ici
            // ou bien il faut protéger les caractères $ avec \$
            '$matches',
            'return strtolower($matches[0]);'
        ),
        $line
    );
    echo $line;
}
fclose($fp);
?>

subject

La chaîne ou le tableau de chaînes à chercher et à remplacer.

limit

Le nombre maximal de remplacement pour chaque masque dans chaque chaîne subject . Vaut par défaut -1 (aucune limite).

count

Si fournie, cette variable sera remplie avec le nombre de remplacements effectués.

Valeurs de retour

preg_replace_callback() retourne un tableau si le paramètre subject est un tableau, ou, sinon, une chaîne de caractères.

Si des correspondances sont trouvées, le nouveau sujet sera retourné, sinon subject sera retourné, inchangé.

Historique

Version	Description
5.1.0	Le paramètre `count` a été ajouté.

Exemples

Exemple #2 Exemple avec preg_replace_callback()


<?php
// Ce texte était vrai en 2002
// nous voulons le mettre a jour pour 2003
$text = "Le premier avril est le 04/01/2002\n";
$text.= "Le dernier noël était le 12/24/2001\n";

// Fonction de callback
function next_year($matches)
{
  // comme d'habitude : $matches[0] représente la valeur totale
  // $matches[1] représente la première parenthèse capturante
  return $matches[1].($matches[2]+1);
}
echo preg_replace_callback(
            "|(\d{2}/\d{2}/)(\d{4})|",
            "next_year",
            $text);

?>

L'exemple ci-dessus va afficher :

Le premier avril est le 04/01/2003
Le dernier noël était le 12/24/2002

Exemple #3 Exemple avec preg_replace_callback() en utilisant une structure récursive pour gérer du BB code


<?php
$input = "plain [indent] deep [indent] deeper [/indent] deep [/indent] plain";

function parseTagsRecursive($input)
{

    $regex = '#\[indent]((?:[^[]|\[(?!/?indent])|(?R))+)\[/indent]#';

    if (is_array($input)) {
        $input = '<div style="margin-left: 10px">'.$input[1].'</div>';
    }

    return preg_replace_callback($regex, 'parseTagsRecursive', $input);
}

$output = parseTagsRecursive($input);

echo $output;
?>

Voir aussi

preg_replace() - Rechercher et remplacer par expression rationnelle standard
create_function() - Crée une fonction anonyme
Informations sur le type callback

preg_replace

preg_quote

Last updated: Tue, 30 Jun 2009

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);

add a note

preg_replace

preg_quote

Last updated: Tue, 30 Jun 2009