exif_read_data

exif_read_data(resource $file, [string $required_sections], [bool $as_arrays], [bool $read_thumbnail]): array
```php

`exif_read_data` lee los encabezados EXIF de las imágenes. Con esta función, se pueden leer los datos meta generados por las cámaras digitales.

Los encabezados EXIF tienden a estar presentes en las imágenes JPEG/TIFF generadas por las cámaras digitales, pero desafortunadamente, cada cámara digital tiene una idea diferente de cómo sus imágenes deben ser marcadas, por lo que no siempre se puede contar con un encabezado EXIF específico, aunque esté presente.

Los parámetros `Height` y `Width` se calculan de la misma manera que para la función `getimagesize`, por lo que sus valores no formarán parte de ningún encabezado devuelto. De igual manera, el índice `html` es la representación textual de la altura/ancho utilizada en una etiqueta de imagen HTML clásica.

Cuando un encabezado EXIF contiene una nota de Copyright, este encabezado puede contener a su vez dos valores. Como esta solución es inconsistente con los estándares EXIF 2.10, la sección `COMPUTED` devolverá los dos encabezados, `Copyright.Photographer` y `Copyright.Editor`, mientras que las secciones `IFD0` contienen el array de bytes con caracteres NULL para separar las dos entradas; o bien, solo la primera entrada si el tipo de datos era incorrecto (comportamiento por defecto de EXIF). La sección `COMPUTED` también contendrá una entrada `Copyright`, que será ya sea la cadena original de copyright, o una lista de valores separados por comas de fotos y copyright del autor.

La etiqueta `UserComment` presenta el mismo problema que la etiqueta Copyright. Puede almacenar dos valores: primero, el juego de caracteres utilizado, luego el valor en sí. Si es así, la sección `IFD` contendrá solo el juego de caracteres, o un array de bytes. La sección `COMPUTED` almacenará las dos entradas `UserCommentEncoding` y `UserComment`. El índice `UserComment` está disponible en ambos casos, y es preferible usarlo, en lugar del valor de la sección `IFD0`.

`exif_read_data` valida los datos de las etiquetas EXIF de acuerdo con la especificación EXIF (<http://exif.org/Exif2-2.PDF>, página 20).

## Parámetros

`file`  
La ubicación del archivo de imagen. Puede ser ya sea una ruta de acceso al archivo (los wrappers de flujo también son soportados como de costumbre), o un flujo `resource`.

`required_sections`  
Lista de valores separados por comas de las secciones que deben presentarse en el array de resultado. Si ninguna de las secciones solicitadas se encuentra, el valor devuelto es `false`.

|  |  |
|----|----|
| FILE | FileName (nombre del archivo), FileSize (tamaño del archivo), FileDateTime (fecha de modificación del archivo), SectionsFound (secciones encontradas) |
| COMPUTED | Atributo Html, ancho, altura, color o blanco y negro y más si está disponible. El ancho y la altura se calculan de la misma manera que la función `getimagesize`, por lo que sus valores nunca deberían diferir. De igual manera, el índice `html` es la representación textual de la altura/ancho utilizada en una etiqueta de imagen HTML clásica. |
| ANY_TAG | Toda la información concerniente a esta etiqueta, como `IFD0`, `EXIF`, ... |
| IFD0 | Todas las etiquetas `IFD0`. En imágenes normales, contienen las dimensiones de la imagen, etc. |
| THUMBNAIL | Un archivo que contiene una miniatura, si hay un segundo `IFD`. Toda la información etiquetada sobre esta miniatura será almacenada en esta sección. |
| COMMENT | Encabezado de comentario de las imágenes JPEG. |
| EXIF | La sección EXIF es una subsección de la sección `IFD0`. Ella contiene información más detallada sobre las imágenes. La mayoría de estos índices están relacionados con las cámaras digitales. |

`as_arrays`  
Especifica si cada sección debe convertirse en un array o no. Las `required_sections` `COMPUTED`, `THUMBNAIL` y `COMMENT` siempre serán convertidas en arrays, ya que contienen nombres que podrían entrar en conflicto.

`read_thumbnail`  
Cuando se define como `true`, la miniatura misma es leída. De lo contrario, solo se leen los datos contenidos en el archivo.

## Valores devueltos

Devuelve un array asociativo donde los índices son los nombres de los encabezados y los valores son los valores asociados a estos encabezados. Si no se puede devolver ningún dato, `exif_read_data` devolverá `false`.

## Errores/Excepciones

Pueden generarse errores de nivel `E_WARNING` y/o `E_NOTICE` para etiquetas no soportadas u otras condiciones de error potencial, pero la función intenta leer toda la información comprensible.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.0.0 | `required_sections` ahora es nullable. |
| 7.2.0 | Se ha añadido el soporte para los siguientes formatos EXIF: Samsung, DJI, Panasonic, Sony, Pentax, Minolta, Sigma/Foveon, AGFA, Kyocera, Ricoh, Epson |

## Ejemplos

Ejemplo con `exif_read_data`

La primera llamada falla porque la imagen no tiene encabezado de información.

Resultado del ejemplo anterior es similar a:

`exif_read_data` con flujos disponibles desde PHP 7.2.0

Resultado del ejemplo anterior es similar a: