Saltar al contenido

fgetcsv()

Introducción a la función fgetcsv() de PHP

La función fgetcsv() de PHP se utiliza para leer una línea de un archivo y analizarla como datos CSV (Valores Separados por Comas). Es una función crucial para los desarrolladores web que necesitan leer y procesar archivos CSV de manera eficiente.

La función fgetcsv() acepta un parámetro obligatorio y cuatro parámetros opcionales. En este artículo, discutiremos la sintaxis y los parámetros de la función fgetcsv(), junto con ejemplos de cómo usarla.

Sintaxis

La sintaxis de la función fgetcsv() es la siguiente:

La sintaxis de fgetcsv() en PHP

php
array fgetcsv ( resource $stream [, int $length = 0 [, string $delimiter = ',' [, string $enclosure = '"' [, string $escape = '\\' ]]]] )
  • stream: el puntero de archivo desde el cual leer
  • length: la longitud máxima de la línea a leer
  • delimiter: el carácter delimitador para los datos CSV
  • enclosure: el carácter de delimitación para los datos CSV
  • escape: el carácter de escape para los datos CSV

Parámetros

La función fgetcsv() toma un parámetro obligatorio y cuatro parámetros opcionales:

  1. $stream: El puntero de archivo desde el que desea leer. Este parámetro puede ser un recurso creado mediante la función fopen() o una función similar.
  2. $length: La longitud máxima de la línea a leer. Este parámetro es opcional y su valor predeterminado es 0, lo que significa que se leerá toda la línea.
  3. $delimiter: El carácter delimitador para los datos CSV. Este parámetro es opcional y su valor predeterminado es ','.
  4. $enclosure: El carácter de delimitación para los datos CSV. Este parámetro es opcional y su valor predeterminado es '"'.
  5. $escape: El carácter de escape para los datos CSV. Este parámetro es opcional y su valor predeterminado es '\'. Nota: Este parámetro está en desuso desde PHP 8.1.

Valores devueltos

En caso de éxito, fgetcsv() devuelve un array indexado que contiene los campos leídos de la línea. Si se produce un error o se alcanza el final del archivo, devuelve false.

Ejemplos

A continuación se presentan algunos ejemplos de cómo usar la función fgetcsv():

Ejemplo 1: Leer una línea de datos CSV desde un archivo

El siguiente ejemplo abre un archivo, lee una línea de datos CSV y cierra correctamente el manejador del archivo:

Leer una línea de datos CSV desde un archivo en PHP

php
$fileHandle = fopen('data.csv', 'r');
if ($fileHandle) {
    $line = fgetcsv($fileHandle);
    fclose($fileHandle);
}

Ejemplo 2: Leer una línea de datos CSV desde un archivo con un delimitador personalizado

El siguiente ejemplo lee una línea de datos CSV desde el puntero de archivo $fileHandle con un delimitador personalizado:

Leer una línea de datos CSV desde un archivo con un delimitador personalizado

php
$line = fgetcsv($fileHandle, 0, ';');

Este código leerá una línea de datos CSV con el delimitador ';'.

Conclusión

En conclusión, la función fgetcsv() es una función crucial de PHP que se puede utilizar para leer una línea de un archivo y analizarla como datos CSV. Es esencial para leer y procesar archivos CSV de manera eficiente.

Al utilizar los ejemplos proporcionados en este artículo, ahora debería poder usar la función fgetcsv() en su código PHP con facilidad. Si tiene alguna pregunta o inquietud sobre el uso de la función fgetcsv() en PHP, no dude en contactarnos. Estaremos encantados de ayudarle.

Práctica

¿Cuál es la función de fgetcsv() en PHP?

¿Te resulta útil?

Vista previa dual-run — compárala con las rutas Symfony en producción.