PhpRiot
Become Zend Certified

Prepare for the ZCE exam using our quizzes (web or iPad/iPhone). More info...


When you're ready get 7.5% off your exam voucher using voucher CJQNOV23 at the Zend Store

PregReplace

Zend_Filter_PregReplace performs a search using regular expressions and replaces all found elements.

Supported options for Zend_Filter_PregReplace

The following options are supported for Zend_Filter_PregReplace:

  • match: The pattern which will be searched for.

  • replace: The string which is used as replacement for the matches.

Basic usage

To use this filter properly you must give two options:

The option match has to be given to set the pattern which will be searched for. It can be a string for a single pattern, or an array of strings for multiple pattern.

To set the pattern which will be used as replacement the option replace has to be used. It can be a string for a single pattern, or an array of strings for multiple pattern.

<?php
$filter 
= new Zend_Filter_PregReplace(array('match' => '/bob/',
                                            
'replace' => 'john'));
$input  'Hy bob!';

$filter->filter($input);
// returns 'Hy john!'

You can use getMatchPattern() and setMatchPattern() to set the matching pattern afterwards. To set the replacement pattern you can use getReplacement() and setReplacement().

<?php
$filter 
= new Zend_Filter_PregReplace();
$filter->setMatchPattern(array('bob''Hy'))
       ->
setReplacement(array('john''Bye'));
$input  'Hy bob!";

$filter->filter($input);
// returns '
Bye john!'

For a more complex usage take a look into PHP's PCRE Pattern Chapter.

Zend Framework