[edit] Last updated: Fri, 23 Dec 2011

preg_quote

(PHP 4, PHP 5)

preg_quote — Düzenli ifadelerin özel karakterlerini önceler

Açıklama

string preg_quote ( string $dizge [, string $im = NULL ] )

preg_quote() işlevi dizge değiştirgesinde bulunan düzenli ifade özel karakterlerinin her birinin önüne tersbölü karakteri yerleştirir. Düzenli ifade dizgesini çalışma anında oluşturuyorsanız ve du dizgelerin özel karakterleri içerme olasılığı varsa bu işlev çok işe yarar.

Özel düzenli ifade karakterleri şunlardır: . \ + * ? [ ^ ] $ ( ) { } = ! < > | : -

Değiştirgeler

dizge: Girdi dizgesi.
im: Belirtilmesi isteğe bağlı olup, gerekirse bu im de öncelenecektir. PCRE işlevlerinin gerektirdiği imleri öncelemek için yararlıdır. / karakteri en çok kullanılan imlerden biridir.

Dönen Değerler

Öncelenmiş dizge ile döner.

Sürüm Bilgisi

Sürüm:	Açıklama
5.3.0	- karakteri artık önceleniyor.

Örnekler

Örnek 1 - preg_quote() örneği


<?php
$keywords = '$40 for a g3/400';
$keywords = preg_quote($keywords, '/');
echo $keywords; // çıktısı: \$40 for a g3\/400
?>

Örnek 2 - Bir metnin içindeki bir kelimeyi vurgulamak


<?php
// Bu örnekte, preg_quote($kelime),
// düzenli ifade için özel anlama sahip
// yıldız imlerini öncelemekte kullanılmıştır.

$metin = "Bu kitabı bulmak çok *zor*.";
$kelime = "*zor*";
$metin = preg_replace ("/" . preg_quote($kelime) . "/",
                          "<i>" . $kelime . "</i>",
                          $metin);
?>

Notlar

Bilginize: Bu işlev ikil dosyalarla çalışırken dosya içeriğini değiştirmez.

preg_replace_callback

preg_match

[edit] Last updated: Fri, 23 Dec 2011

add a note User Contributed Notes preg_quote

billadoid at gmail dot com 12-Jan-2012 05:11


If you need to quote everything but a wildcard, maybe this function will come handy to you:





<?php


protected function _ruleOptionIsMatched($option, $subject)


{


    $option = preg_quote($option, '#');


    $option = str_replace('\*', '.*', $option);





    if(preg_match("#^$option$#", $subject))


    {


        return true;


    }


    else


    {


        return false;


    }


}


?>

admin at nilamo dot com 04-Aug-2010 08: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-Jul-2009 01: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-Jun-2009 12: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-Mar-2009 02: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-Oct-2008 07: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-Jul-2008 09: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 26-Dec-2007 03:13


Wondering why your preg_replace fails, even if you have used preg_quote?



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

add a note