ftp_nb_get
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