PHP str_replace - Guía completa para reemplazar cadenas

La función str_replace es una de las funciones más útiles en PHP para manipular cadenas de texto. Permite reemplazar todas las ocurrencias de una cadena de búsqueda en otra cadena.

📚 Sintaxis de str_replace

La función str_replace en PHP tiene la siguiente sintaxis:

str_replace(busqueda, reemplazo, cadena, conteo)

Donde:

• busqueda: es la cadena que se va a buscar.

• reemplazo: es la cadena que reemplazará a busqueda.

• cadena: es la cadena original donde se realizará la búsqueda y reemplazo.

• conteo (opcional): si se proporciona esta variable, str_replace llenará esta variable con el número total de reemplazos realizados.

🔧 Uso básico de str_replace

Aquí hay un ejemplo básico de cómo usar str_replace:

$texto = '¡Hola, mundo!';
$texto = str_replace('mundo', 'PHP', $texto);
echo $texto; // Salida: '¡Hola, PHP!'

🔄 Reemplazar múltiples cadenas con str_replace

str_replace también permite reemplazar múltiples cadenas a la vez. Simplemente proporciona arrays en lugar de cadenas para busqueda y reemplazo:

$texto = '¡Hola, mundo!';
$texto = str_replace(['¡Hola,', 'mundo'], ['¡Adiós,', 'PHP'], $texto);
echo $texto; // Salida: '¡Adiós, PHP!'

📊 Contar el número de reemplazos con str_replace

Si quieres saber cuántos reemplazos se realizaron, puedes proporcionar una cuarta variable a str_replace:

$texto = '¡Hola, mundo, mundo, mundo!';
$conteo = 0;
$texto = str_replace('mundo', 'PHP', $texto, $conteo);
echo $conteo; // Salida: 3

❗ Consejos para usar str_replace

• str_replace es sensible a mayúsculas y minúsculas. Si quieres un reemplazo que no distinga entre mayúsculas y minúsculas, usa str_ireplace.

• Si busqueda y reemplazo son arrays y reemplazo tiene menos elementos que busqueda, los elementos adicionales de busqueda serán reemplazados por una cadena vacía.

• Si busqueda es un array y reemplazo es una cadena, entonces esta cadena será usada para reemplazar todos los valores de busqueda.