Função str_ireplace

A função str_ireplace procura em uma string todas as ocorrências de uma substring (sem diferenciar maiúsculas de minúsculas) e as substitui por um valor especificado. O primeiro parâmetro recebe a substring procurada, o segundo - a string de substituição, o terceiro - a string na qual a busca é realizada.

Sintaxe

str_ireplace(search, replace, subject);

Exemplo

Vamos substituir todas as ocorrências da substring sem diferenciar maiúsculas de minúsculas:

<?php
	echo str_ireplace('abc', '!', 'aBc abc ABC');
?>

Resultado da execução do código:

'! ! !'

Exemplo

Vamos substituir várias variantes em um array:

<?php
	$res = str_ireplace(['a', 'b'], ['1', '2'], 'aBc');
	echo $res;
?>

Resultado da execução do código:

'12c'

Exemplo

Vamos substituir as letras especificadas por um caractere comum indicado:

<?php
	echo str_ireplace(['a', 'b', 'c'], '!', 'AbcAbc');
?>

Resultado da execução do código:

'!!!!!!'

Exemplo

Vamos executar a substituição em cada elemento do array:

<?php
	$arr = ['Abc', 'abc', 'abc'];
	$res = str_ireplace('a', '!', $arr);
	print_r($res);
?>

Resultado da execução do código:

['!bc', '!bc', '!bc']

Veja também

a função str_replace,
que executa a substituição diferenciando maiúsculas de minúsculas
a função substr_replace,
que substitui parte de uma string