HOWTO · PHP

Cómo extraer números de una cadena en PHP

Este artículo introduce cómo extraer números de una cadena en PHP. Incluye la función preg_match_all(), la función filter_var() y la función preg_replace().

En esta página

Para extraer dígitos de una cadena PHP, elige el resultado que necesitas: secuencias de dígitos separadas, una cadena depurada que conserve los dígitos y los signos, o una cadena con solo dígitos ASCII. Los ejemplos usan la misma entrada para que puedas comparar sus resultados. Extraer caracteres no equivale a analizar un decimal ni a validar un número.

Usa preg_match_all() para capturar cada secuencia de dígitos

Usa preg_match_all() cuando quieras que cada secuencia de dígitos sea una coincidencia independiente. El patrón determina qué cuenta como coincidencia; \d+ encuentra uno o más dígitos consecutivos. La función devuelve el número de coincidencias y el tercer argumento recibe el texto capturado en $matches[0] (y los grupos de captura, si los hay, en entradas adicionales). Por tanto, el valor devuelto es un recuento, no los valores extraídos.

Ejecuta este ejemplo:

El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.

<?php
$input = 'Invoice A-42: total $18.50; item 7.';
$count = preg_match_all('/\d+/', $input, $matches);
echo "count=$count\n";
echo implode(', ', $matches[0]), "\n";
?>
count=4
42, 18, 50, 7

Cada secuencia se devuelve por separado, así que el punto decimal de 18.50 divide ese texto en 18 y 50. Este método sirve para encontrar secuencias de dígitos, pero no determina si representan números enteros, decimales, fechas o identificadores. Si importa el formato que los rodea, añade un patrón más específico.

Usa filter_var() para conservar caracteres de números enteros

filter_var(), con FILTER_SANITIZE_NUMBER_INT, conserva en una sola cadena los caracteres de números enteros, incluidos los signos más y menos. Elimina los demás caracteres; no encuentra valores por separado ni valida que la cadena resultante sea un número entero bien formado. Como conserva todos los signos que coinciden, también pueden aparecer signos que estaban en otras partes de la entrada.

El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.

<?php
$input = 'Invoice A-42: total $18.50; item 7.';
$sanitized = filter_var($input, FILTER_SANITIZE_NUMBER_INT);
echo $sanitized, "\n";
?>
-4218507

La salida es -4218507: se conserva el signo menos de A-42 y se elimina el separador decimal, por lo que 18 y 50 quedan unidos. Mantén el resultado como texto hasta que la aplicación compruebe el formato esperado y decida cómo interpretarlo. Convertir texto depurado arbitrario a un número entero puede ocultar una entrada mal formada y hacer que se pierda información; no sustituye al análisis ni a la validación.

Usa preg_replace() para eliminar los caracteres que no sean dígitos

Usa preg_replace() con /[^0-9]/ para sustituir por una cadena vacía cada carácter que quede fuera del rango de dígitos ASCII. Así se obtiene una sola cadena que concatena las secuencias de dígitos separadas en la entrada. El método elimina signos, puntuación decimal, espacios en blanco y letras; úsalo solo si esos caracteres no deben influir en el resultado.

El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.

<?php
$input = 'Invoice A-42: total $18.50; item 7.';
$digits = preg_replace('/[^0-9]/', '', $input);
echo $digits, "\n";
?>
4218507

Aquí, [^0-9] significa cualquier carácter que no sea uno de los diez dígitos ASCII. El resultado conserva el orden de los dígitos, pero descarta los límites entre valores: 42, 18, 50 y 7 se convierten en 4218507. Esto puede servir para conservar los caracteres numéricos de un identificador, pero no para recuperar los valores numéricos originales. El patrón también excluye los caracteres numéricos que no sean ASCII.

Elige un método según el formato de entrada

Elige preg_match_all() si necesitas cada secuencia de dígitos como un valor independiente. Elige filter_var() con FILTER_SANITIZE_NUMBER_INT si quieres una sola cadena que conserve los dígitos y los signos; valida su formato antes de interpretarla. Elige preg_replace() si el resultado deseado es una sola cadena de dígitos ASCII y quieres concatenar las secuencias separadas.

Ninguna de estas operaciones analiza un decimal: preg_match_all() separa los dígitos donde aparece la puntuación, mientras que los métodos de depuración eliminan el punto decimal. Si necesitas conservar el significado de un decimal, un separador de millares o un número con signo, define y valida ese formato de entrada antes de convertirlo. Del mismo modo, /[^0-9]/ conserva deliberadamente solo dígitos ASCII; si la entrada puede contener otros tipos de numerales, usa un patrón diseñado para ese conjunto de caracteres. El método adecuado depende de si la entrada es prosa, un valor con formato o un identificador, y de si los separadores y los signos tienen significado.