Documentación offline PHP master

ftp_nb_get

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

ftp_nb_get

Lee un fichero en un servidor FTP y lo escribe en un fichero (no bloqueante)

Descripción#

ftp_nb_get(FTP\Connection $ftp, string $local_filename, string $remote_filename, [int $mode], [int $offset]): int
```php

`ftp_nb_get` lee el fichero `remote_filename` presente en el servidor FTP `ftp` y lo guarda en un fichero local.

La diferencia entre esta función y `ftp_fget` es que esta función puede leer el fichero de manera asíncrona, para que el programa realice otras tareas mientras el fichero se descarga.

## Parámetros

`ftp`  
Una instancia de `FTP\Connection`.

`local_filename`  
La ruta hacia el fichero local (será sobrescrito si el fichero ya existe).

`remote_filename`  
La ruta hacia el fichero remoto.

`mode`  
El modo de transferencia. Debe ser `FTP_ASCII` o `FTP_BINARY`.

`offset`  
La posición en el fichero remoto a partir de la cual debe comenzar la descarga.

## Valores devueltos

Devuelve `FTP_FAILED` o `FTP_FINISHED` o `FTP_MOREDATA`, o `false` en caso de fallo al abrir el fichero local.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.1.0 | El parámetro `ftp` ahora espera una instancia de `FTP\Connection` ; anteriormente, se esperaba un `resource`. |
| 7.3.0 | El argumento `mode` ahora es opcional. Anteriormente era obligatorio. |

## Ejemplos

Ejemplo con `ftp_nb_get`
Reanudación de una descarga con `ftp_nb_get`
Reanudación de una descarga desde la posición 100 en un nuevo fichero con `ftp_nb_get`

```php

En el ejemplo anterior, newfile es 100 bytes más pequeño que README en el sitio FTP, ya que comenzamos a leer desde el offset 100. Si no hubiéramos desactivado la opción FTP_AUTOSEEK, los primeros 100 bytes del fichero newfile serían rellenados con '\0'.

Véase también#

ftp_nb_fget, ftp_nb_continue, ftp_fget, ftp_get