te lo pongo tal cual viene en el manual oficial de php:
(
http://www.php.net/manual/es/function.str-replace.php)
str_replace
(PHP 3>= 3.0.6, PHP 4 , PHP 5)
str_replace -- Sustitiye todas las apariciones de la aguja en el pajar por la cadena
Descripción
string str_replace ( string aguja, string cad, string pajar)
Esta función sustituye todas las apariciones de la aguja en el pajar por la cad dada. Si no precisa reglas especiales de sustitución, deberá usar siempre esta función en lugar de ereg_replace().
Ejemplo 1. Ejemplo de str_replace()
$bodytag = str_replace ("%cuerpo%", "negro", "<body text=%cuerpo%>");