(PHP 4, PHP 5)
fgetcsv — Obtiene una línea del puntero a un archivo y la examina para tratar campos CSV
Similar a fgets() excepto que fgetcsv() examina la línea que lee para tratar campos en formato CSV y devuelve una matriz que contiene el campo leído.
Un puntero a un archivo abierto con éxito por fopen(), popen(), o fsockopen().
Debe ser mayor que la línea más larga (en caracteres) a ser encontrada en el archivo CSV (permitiendo caracteres fin de línea finales). Se volvió opcional en PHP 5. Al omitir este parámetro (o estableciéndolo a 0 en PHP 5.0.4 y posterior), la longitud máxmia de línea no está limitada, lo cual es ligeramente más lento.
Establece el delimitador de campo (un sólo carácter).
Establece el carácter de cierre de campo (un sólo carácter).
Establece el carácter de escape (un sólo carácter). Por defecto es una barra invertida.
Devuelve una matriz indexada que contiene los campos leídos.
Note:
Una línea en blanco en un archivo CSV será devuelta como una matriz que comprende un simple campo null, y no será tratada como un error.
Note: Si sufre problemas con PHP no reconociendo los finales de línea cuando lee o crea ficheros en Macintosh, puede probar de activar la opción de configuración en tiempo de ejecución auto_detect_line_endings para intentar resolver el problema.
fgetcsv() devuelve NULL si se proporciona un handle no válido, o FALSE en los demás errores, incluido el final de archivo.
Versión | Descripción |
---|---|
5.3.0 | Se añadió el parámetro escape |
4.3.5 | fgetcsv() ahora es segura al trabajar con datos binarios |
4.3.0 | Se añadió el parámetro enclosure |
Example #1 Lee e imprime el contenido completo de un archivo CSV
<?php
$fila = 1;
if (($gestor = fopen("test.csv", "r")) !== FALSE) {
while (($datos = fgetcsv($gestor, 1000, ",")) !== FALSE) {
$número = count($datos);
echo "<p> $número de campos en la línea $fila: <br /></p>\n";
$fila++;
for ($c=0; $c < $número; $c++) {
echo $datos[$c] . "<br />\n";
}
}
fclose($gestor);
}
?>
Note:
Esta función toma en cuenta los parámetros de loacalización. Si LANG es p.ej. en_US.UTF-8, los archivos codificados con un byte son leídos de forma errónea por esta función.