ftp_put

(PHP 4, PHP 5, PHP 7, PHP 8)

ftp_putCarga un fichero en un servidor FTP

Descripción

ftp_put(
    FTP\Connection $ftp,
    string $remote_filename,
    string $local_filename,
    int $mode = FTP_BINARY,
    int $offset = 0
): bool

ftp_put() registra el fichero local_filename en el servidor FTP.

Parámetros

ftp

An FTP\Connection instance.

remote_filename

La ruta hacia el fichero remoto.

local_filename

La ruta hacia el fichero local.

mode

El modo de transferencia. Debe ser FTP_ASCII o FTP_BINARY.

offset

La posición en el fichero remoto desde la cual comenzará la carga.

Valores devueltos

Devuelve true en caso de éxito o false en caso de error.

Historial de cambios

Versión Descripción
8.1.0 The ftp parameter expects an FTP\Connection instance now; previously, a recurso was expected.
7.3.0 El argumento mode ahora es opcional. Anteriormente era obligatorio.

Ejemplos

Ejemplo #1 Ejemplo con ftp_put()

<?php
$file
= 'somefile.txt';
$remote_file = 'readme.txt';

// Establecimiento de una conexión básica
$ftp = ftp_connect($ftp_server);

// Identificación con un nombre de usuario y una contraseña
$login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);

// Carga un fichero
if (ftp_put($ftp, $remote_file, $file, FTP_ASCII)) {
echo
"El fichero $file ha sido cargado con éxito\n";
} else {
echo
"Ha ocurrido un problema al cargar el fichero $file\n";
}

// Cierre de la conexión
ftp_close($ftp);
?>

Ver también

  • ftp_pasv() - Activa o desactiva el modo pasivo
  • ftp_fput() - Carga un fichero en un servidor FTP
  • ftp_nb_fput() - Escribe un fichero en un servidor FTP, y lo lee desde un fichero (no bloqueante)
  • ftp_nb_put() - Envía un fichero a un servidor FTP (no bloqueante)