suche nach in der

preg_replace> <preg_quote
Last updated: Fri, 18 May 2012

view this page in

preg_replace_callback

(PHP 4 >= 4.0.5, PHP 5)

preg_replace_callback — Sucht und ersetzt einen regulären Ausdruck unter Verwendung eines Callbacks

Beschreibung

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

Abgesehen von der Tatsache, dass statt des Parameters replacement ein callback angegeben werden soll, ist das Verhalten dieser Funktion identisch zu preg_replace().

Parameter-Liste

pattern

Der Ausdruck, nach dem gesucht werden soll. Es kann entweder eine Zeichenkette oder ein Array mit Zeichenketten sein.

callback

Ein Callback, dem ein Array von Übereinstimmungen mit subject übergeben wird. Der Callback sollte die Ersetzungs-Zeichenkette liefern.

Häufig werden Sie die callback-Funktion für preg_replace_callback() nur an einer Stelle benötigen. In diesem Fall können Sie eine Anonyme Funktion (seit PHP 5.3.0) oder create_function() verwenden, um innerhalb des Aufrufs von preg_replace_callback() eine anonyme Funktion als Callback zu deklarieren. Auf diese Weise haben Sie alle Informationen für den Aufruf an einer Stelle und stopfen den Namensraum für Funktionen nicht mit Namen für Callback-Funktionen voll, die sonst nirgends verwendet werden.

Beispiel #1 preg_replace_callback() und create_function()

<?php
// ein Kommandozeilen-Filter im Unix-Stil zum Umwandeln von Groß- in
// Kleinschreibung am Beginn eines Abschnitts
$fp = fopen("php://stdin", "r") or die("kann stdin nicht lesen");
while (!feof($fp)) {
  $zeile = fgets($fp);
  $zeile = preg_replace_callback(
    '|<p>\s*\w|',
    create_function(
      // hier sind entweder einfache Anführungszeichen nötig
      // oder alternativ die Maskierung aller $ als \$
      '$treffer',
      'return strtolower($treffer[0]);'
    ),
    $zeile
  );
  echo $zeile;
}
fclose($fp);
?>

subject

Die Zeichenkette oder ein Array mit Zeichenketten zum Suchen und Ersetzen.

limit

Die Höchstzahl der Ersetzungen für jedes Suchmuster in jeder subject. Standardmäßig -1 (unbegrenzt).

count

Falls angegeben, wird dieser Variable die Anzahl vorgenommener Ersetzungen zugewiesen.

Rückgabewerte

Falls subject ein Array ist, gibt preg_replace_callback() ein Array zurück und andernfalls eine Zeichenkette. Bei einem Fehler ist der Rückgabewert NULL.

Falls Übereinstimmungen gefunden werden, wird die neue Zeichenkette zurückgegeben und andernfalls die unveränderte Zeichenkette subject

Changelog

Version Beschreibung
5.1.0 Den Parameter count hinzugefügt

Beispiele

Beispiel #2 preg_replace_callback() Beispiel

<?php
// dieser Text wurde 2002 verwendet
// wir wollen ihn für 2003 aktualisieren
$text = "Aprilscherze gibts am 01.04.2002\n";
$text.= "Das letzte Weihnachten war am 24.12.2001\n";
// die Callback-Funktion
function naechstes_jahr($treffer)
{
  // wie üblich: $treffer[0] ist die Übereinstimmung mit dem
  // kompletten Suchmuster, $treffer[1] die Übereinstimmung mit
  // dem ersten eingeklammerten Teilsuchmuster und so weiter
  return $treffer[1].($treffer[2]+1);
}
echo preg_replace_callback(
            "|(\d{2}\.\d{2}\.)(\d{4})|",
            "naechstes_jahr",
            $text);

?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Aprilscherze gibts am 01.04.2003
Das letzte Weihnachten war am 24.12.2002

Beispiel #3 preg_replace_callback() unter Verwendung einer rekursiven Struktur um gekapselten BB-Code zu verarbeiten

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

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

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

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

$ausgabe = parseTagsRecursive($eingabe);

echo $ausgabe;
?>

Siehe auch



add a note add a note User Contributed Notes
preg_replace_callback
roytam at NOSPAM dot gmail dot com
13-Jul-2007 12:57
> sjungwirth domain matrix-consultants com
It may fail in nested condition if $bar needs to be changed.
Sjon at hortensius dot net
24-Jun-2007 01: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
sjungwirth domain matrix-consultants com
07-May-2007 02:31
one way to 'pass' extra info other than just the matches and still use preg_replace_callback is to have your callback function be a class method, and just before you call preg_replace_callback, store the info in that class. I am using static methods/variables for my implementation; I'm not sure if its required.
<?php
class foo {
    private static $bar;
    public static function do_something($bar) {
        self::$bar = $bar; // store bar
       
        $input = $bar->get_somevar();
        $pattern = "match me";
        $output = preg_replace_callback($pattern, array('self', 'do_something_callback'), $input);
       
        return $output;
    }

    private static function do_something_callback($matches) {
        $bar = self::$bar; // retrieve bar
       
        // do stuff like $bar->get_someothervar();
       
        return $replacement;
    }
}
?>
matt at mattsoft dot net
26-Apr-2006 11: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);
spamhoneypot at acksys dot co dot uk
17-Dec-2003 03:08
I thought I'd post this as I'd been using the function preg_replace_callback with NP within functions, but as soon as I re-wrote my script as a class, it all fell apart.

When debugging I ended up writing test code and this is what follows. It works as I'd expect, YMMV of course.

<?php

// v v over simplified
class foo
{
  function parse()
  {
    $pattern = "/<a(.*?)href\s*=\s*['|\"|\s*](.*?)['|\"|>](.*?)>(.*?)<\/a>/i";
    $string = "<a class='whatever' href='http://foo.com' target='_blank'>foo</a>";
    print preg_replace_callback($pattern,array($this,'cb'),$string);
  }

  function cb($matches)
  {
    return "<a" . $matches[1] . "href='http://someothersite.com/foo.php?page=" . urlencode($matches[2]) . "'" . $matches[3] . ">" . $matches[4] . "</a>";
  }

}

$bar = new foo();
$bar->parse();

/**
output is
<a class='whatever' href='http://someothersite.com/foo.php?page=http%3A%2F%2Ffoo.com' target='_blank'>foo</a>
*/

?>
vlad4321 at fastmail dot fm
12-Nov-2003 12:47
You can use this function to display url address as a link or image based on suffix of the url.

Every string beginning with www or http(s):// will be displayed as an URL address.  But if the string ends with *.jpg or *.gif, it will be displayed as an image.

Please note: This function also verifies the size of the image. If is it more than 600x400, it changes it.
<?php

$pattern_html = "/\b((http(s?):\/\/)|(www\.))([\w\.]+)";
$pattern_html .= "([\#\,\/\~\?\&\=\;\%\-\w+\.]+)\b/i";

$text = preg_replace_callback($pattern_html,'Check_if_Image',$text);
.
.
function Check_if_Image($matches) {
$suffix = strtolower(substr($matches[0],-4));
if ( $suffix == '.jpg' or $suffix == '.gif') {
    $dsn = 'http'.$matches[3].'://'.$matches[4].$matches[5];
    if (list($width, $height, $type, $attr) = getimagesize("$dsn")) {
    if ( ($width > 600) ) {
        $koef = $width / 600;
        $width = 600;
        $height /= $koef;
        }
    if ( ($height > 400) ) {
        $koef = $height / 400;
        $height = 400;
        $width /= $koef;
        }
    }
    else {
        $height=400;
        $width=600;
    }

    $ret = "<img src=\"$dsn\"";
    $ret .= "\" border=0 width=\"$width\" height=\"$height\">";
    }
else {
    $ret = '<a href="http'.$matches[3].'://'.$matches[4].$matches[5];
    $ret .='" target="_blank">'.$matches[0].'</a>';
    }
return ("$ret");
}

?>
e-mail at dreamguard dot at
23-Oct-2003 11:02
If you want to do a date function in a template system you'll have to use the callback here.

Ex.:
function date_match ($matches)
{
   return date ($matches['2']);
}
$output = preg_replace_callback ('/({DATE=")(.{1,})("})/', 'date_match', $input);
oyoryelNOSPAM at hotNOSPAMmail dot com
22-Apr-2002 06:23
If you want to be able to change variables of the class in the callback function, you have to use preg_replace_callback(pattern, array(&$this, 'method_name'), subject)
Probably very obvious, but it kept me busy for a while...
add a note add a note

preg_replace> <preg_quote
Last updated: Fri, 18 May 2012