# stream_get_meta_data

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

stream_get_meta_data — Recuperar meta-información o de cabecera de punteros a flujos/archivo

### Descripción

stream_get_meta_data(resource `$stream`): array

Devuelve información sobre un `stream` (flujo) existente.

### Parámetros

`stream`

  El flujo puede ser cualquier flujo creado por fopen(), fsockopen() y pfsockopen().

### Valores devueltos

La matriz resultante contiene los siguientes elementos:

- `timed_out` (bool) - `true` si el flujo agota el tiempo mientras espera información en la última llamada a fread() o fgets().

- `blocked` (bool) - `true` si el flujo está en el modo de bloqueo IO. Véase stream_set_blocking().

- `eof` (bool) - `true` si el flujo ha alcanzado la marca eof (end-of-file, final de archivo). Observe que para flujos de socket este miembro puede ser `true` incluso cuando `unread_bytes` no es cero. Para determinar si hay más información para leer, use feof() en vez de leer este elemento.

- `unread_bytes` (int) - el número de bytes contenidos actualmente en el propio buffer interno de PHP.

  > Nota: No se debería usar este valor en un script.

- `stream_type` (string) - una etiqueta que describe la implementación subyacente del flujo.

- `wrapper_type` (string) - una etiqueta que describe la implementación de la envoltura de protocolo que traslapa al flujo. Véase Protocolos y Envolturas soportados para más información acerca de envolturas.

- `wrapper_data` (mixed) - la información específica de la envoltura vinculada a este flujo. Véase Protocolos y Envolturas soportados para más información acerca de envolturas y su infomración de envoltura.

- `mode` (string) - el tipo de acceso requerido para este flujo (véase la Tabla 1 de la referencia de fopen())

- `seekable` (bool) - si el flujo acutal puede ser buscado.

- `uri` (string) - la URI/nombre de archivo asociado con este flujo.

### Ejemplos

Ejemplo #1 Ejemplo de stream_get_meta_data()

`<?php
$url = 'http://www.example.com/';
if (!$fp = fopen($url, 'r')) {
trigger_error("Incapaz de abrir la URL ($url)", E_USER_ERROR);
}
$meta = stream_get_meta_data($fp);
print_r($meta);
fclose($fp);
?>`

El resultado del ejemplo sería algo similar a:

    Array
    (
        [wrapper_data] => Array
            (
                [0] => HTTP/1.1 200 OK
                [1] => Server: Apache/2.2.3 (Red Hat)
                [2] => Last-Modified: Tue, 15 Nov 2005 13:24:10 GMT
                [3] => ETag: "b300b4-1b6-4059a80bfd280"
                [4] => Accept-Ranges: bytes
                [5] => Content-Type: text/html; charset=UTF-8
                [6] => Set-Cookie: FOO=BAR; expires=Fri, 21-Dec-2012 12:00:00 GMT; path=/; domain=.example.com
                [6] => Connection: close
                [7] => Date: Fri, 16 Oct 2009 12:00:00 GMT
                [8] => Age: 1164
                [9] => Content-Length: 438
            )

        [wrapper_type] => http
        [stream_type] => tcp_socket/ssl
        [mode] => r
        [unread_bytes] => 438
        [seekable] =>
        [uri] => http://www.example.com/
        [timed_out] =>
        [blocked] => 1
        [eof] =>
    )

### Notas

> Nota:

> Esta función NO funciona en sockets creados por la extensión Socket.

### Ver también

- get_headers() - Recupera todas las cabeceras enviadas por el servidor en respuesta a una petición HTTP
- $http_response_header