PHP Doku:: Maskiert Zeichen regulärer Ausdrücke - function.preg-quote.html

Verlauf / Chronik / History: (3) anzeigen

Sie sind hier:
Doku-StartseitePHP-HandbuchFunktionsreferenzTextverarbeitungReguläre Ausdrücke (Perl-kompatibel)PCRE-Funktionenpreg_quote

Ein Service von Reinhard Neidl - Webprogrammierung.

PCRE-Funktionen

<<preg_match

preg_replace_callback>>

preg_quote

(PHP 4, PHP 5)

preg_quoteMaskiert Zeichen regulärer Ausdrücke

Beschreibung

string preg_quote ( string $str [, string $delimiter = NULL ] )

preg_quote() setzt einen Backslash vor jedes Zeichen von str, das zur Syntax eines regulären Ausdrucks gehört. Das ist nützlich, wenn Sie einen Text nach Übereinstimmungen mit einer zur Laufzeit erzeugten Zeichenkette durchsuchen müssen, die spezielle RegEx-Zeichen enthalten könnte.

Spezielle Zeichen regulärer Ausdrücke sind: . \ + * ? [ ^ ] $ ( ) { } = ! < > | : -

Parameter-Liste

str

Die zu durchsuchende Zeichenkette

delimiter

Falls der optionale delimiter angegeben wurde, wird dieser ebenfalls maskiert. Das ist nützlich, um den Begrenzer zu maskieren, der von den PCRE-Funktionen benötigt wird. Der / ist der am häufigsten verwendete Begrenzer.

Rückgabewerte

Gibt die maskierte Zeichenkette zurück.

Changelog

Version Beschreibung
5.3.0 Das Zeichen - wird nun maskiert.

Beispiele

Beispiel #1 preg_quote()-Beispiel

<?php
$schluesselwoerter 
'$40 für einen G3/400';
$schluesselwoerter preg_quote($schluesselwoerter'/');
echo 
$schluesselwoerter// liefert \$40 für einen G3\/400
?>

Beispiel #2 Kursivdruck eines Wortes in einem Text

<?php
// In diesem Beispiel wird preg_quote($wort) verwendet, damit die
// Asterisks (*) für den regulären Ausdruck keine spezielle Bedeutung haben.

$text "Dieses Buch ist *sehr* schwer zu finden.";
$wort "*sehr*";
$text preg_replace ("/" preg_quote($wort) . "/",
                          
"<i>" $wort "</i>",
                          
$text);
?>

Anmerkungen

Hinweis: Diese Funktion ist binary safe.


7 BenutzerBeiträge:
- Beiträge aktualisieren...
admin at nilamo dot com
4.08.2010 17:21
@zooly:

And what if $myvar = 'te\\E.t'?  It will match, when it shouldn't.  That's why you should use preg_quote().
zooly
21.07.2009 10:07
To escape characters with special meaning, like: .-[]() and so on, use \Q and \E.

For example:

<?php echo ( preg_match('/^'.( $myvar = 'te.t' ).'$/i', 'test') ? 'match' : 'nomatch' ); ?>

Will result in: match

But:

<?php echo ( preg_match('/^\Q'.( $myvar = 'te.t' ).'\E$/i', 'test') ? 'match' : 'nomatch' ); ?>

Will result in: nomatch
alexc223 at NOSPAM dot googlemail dot com
15.06.2009 9:41
Not sure why this note got deleted, but hey lets try again:

As of PHP 5.3, bug #47229 has been fixed and preg_quote *will* escape a hyphen (-). This may effect your code so ensure this is one thing you check when moving to 5.3.
frostschutz
20.03.2009 11:01
I wanted to escape a string of characters so I could match them in [], i.e. [.,-!"§$%\\\[\]\^].

Unfortunately preg_quote does not escape the - character which has a special meaning in [], i.e. [a-z].

So I used this hack: make - the delimiter of the expression, i.e.

preg_quote(userinput, "-")
preg_replace("-[$userinput]-u", "", $str)

Apparently using a special char as a delimiter of a regular expression disables this character, i.e. even if it's escaped it's not understood as special character for the expression anymore.

so the pattern "-[a\\-z]-u" matches the characters a, - and z, and not abc...xyz.

It would be nice if preg_quote also escaped characters that have special meanings even if they have this meaning only under certain conditions, such as inside [].
krishoog at gmail dot com
13.10.2008 16:51
To bizzigul at hotmail dot fr:
It's not a good practice to make somthing work *almost* all of the time. If the input contains a '`' you will still get an error. I recommend using the default delimiter ('/') and also feed this to preg_quote as second argument.
bizzigul at hotmail dot fr
30.07.2008 18:10
To prevent any problems, try to always use a delimiter that will *almost* not be used inside the regex, such as ` (back quote)

for example: instead of
<?php preg_match('/foo\/bar\//',$somevar); ?>

use

<?php preg_match('`foo/bar/`',$somevar); ?>

it's that simple! like this, you won't have to bother with delimiters anymore...
Anonymous
27.12.2007 0:13
Wondering why your preg_replace fails, even if you have used preg_quote?

Try adding the delimiter / - preg_quote($string, '/');



PHP Powered Diese Seite bei php.net
The PHP manual text and comments are covered by the Creative Commons Attribution 3.0 License © the PHP Documentation Group - Impressum - mail("TO:Reinhard Neidl",...)