(PHP 4, PHP 5)
fgetcsv — Obtiene una línea del puntero a un fichero y la examina para analizar campos CSV
$handle
[, int $length = 0
[, string $delimiter = ","
[, string $enclosure = '"'
[, string $escape = "\\"
]]]] )Similar a fgets() excepto que fgetcsv() examina la línea que lee para analizar campos en formato CSV, devolviendo un array que contiene los campos leídos.
handleUn puntero a un fichero abierto satisfactoriamente por fopen(), popen(), o fsockopen().
lengthLongitud. Debe ser mayor que la línea más larga (en caracteres) encontrada en el fichero CSV (permitiendo caracteres fin de línea finales). Se hizo opcional en PHP 5. Al omitir este parámetro (o estableciéndolo a 0 en PHP 5.1.0 y posterior), la longitud máxima de línea no está limitada, lo que es ligeramente más lento.
delimiterEstablece el delimitador de campo (un sólo carácter).
enclosureEstablece el carácter circundante de cada campo (un sólo carácter).
escapeEstablece el carácter de escape (un sólo carácter). Por defecto, es una barra invertida.
Devuelve un array indexado que contiene los campos leídos.
Nota:
Una línea en blanco en un fichero CSV será devuelta como un array que comprende un único campo null, por lo que no será tratada como un error.
Nota: 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 fichero.
| Versión | Descripción |
|---|---|
| 5.3.0 |
Se añadió el parámetro escape
|
| 5.1.0 |
El parámetro length ahora es opcional.
El valor predeterminado es 0, significando sin límite de longitud.
|
| 4.3.5 | fgetcsv() ahora es segura al trabajar con datos binarios |
| 4.3.0 |
Se añadió el parámetro enclosure
|
Ejemplo #1 Leer e imprimir el contenido completo de un fichero CSV
<?php
$fila = 1;
if (($gestor = fopen("test.csv", "r")) !== FALSE) {
while (($datos = fgetcsv($gestor, 1000, ",")) !== FALSE) {
$numero = count($datos);
echo "<p> $numero de campos en la línea $fila: <br /></p>\n";
$fila++;
for ($c=0; $c < $numero; $c++) {
echo $datos[$c] . "<br />\n";
}
}
fclose($gestor);
}
?>
Nota:
Esta función toma en cuenta los parámetros de configuraciones regionales. Si LANG es, p.ej., en_US.UTF-8, los ficheros codificados con un byte son leídos de forma errónea por esta función.