ftp_alloc

(PHP 5, PHP 7, PHP 8)

ftp_alloc — Reserviert Platz für eine hochzuladende Datei

Beschreibung

ftp_alloc(FTP\Connection $ftp, int $size, string &$response = null): bool

Sendet ein ALLO-Kommando an den entfernten FTP-Server, um Platz für eine hochzuladende Datei zu reservieren.

Hinweis:
Viele FTP-Server unterstützen dieses Kommando nicht. Diese Server können einen Fehlercode (false) zurückgeben, der angibt, dass das Kommando nicht unterstützt wird, oder einen Erfolgscode (true), der angibt, dass die Reservierung nicht notwendig ist und dass der Client so weiterarbeiten soll als wenn die Operation erfolgreich gewesen wäre. Daher ist es am besten, diese Funktion nur für Server zu verwenden, die die Reservierung explizit unterstützen.

Parameter-Liste

ftp: Eine FTP\Connection-Instanz.
size: Die Anzahl der zu reservierenden Bytes.
response: Eine Textdarstellung der Serverantwort wird als Referenz in response zurückgegeben, wenn eine Variable übergeben wird.

Rückgabewerte

Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.

Changelog

Version	Beschreibung
8.1.0	Der Parameter `ftp` erwartet nun eine FTP\Connection-Instanz; vorher wurde eine Ressource erwartet.

Beispiele

Beispiel #1 ftp_alloc()-Beispiel

<?php

$file = "/home/user/myfile";

// Verbindung aufbauen
$ftp = ftp_connect('ftp.example.com');
$login_result = ftp_login($ftp, 'anonymous', 'user@example.com');

if (ftp_alloc($ftp, filesize($file), $result)) {
  echo "Platz wurde erfolgreich auf dem Server reseviert. $file wird gesendet.\n";
  ftp_put($ftp, '/incoming/myfile', $file, FTP_BINARY);
} else {
  echo "Platz konnte nicht auf dem Server reserviert werden. Serverantwort: $result\n";
}

ftp_close($ftp);

?>

Siehe auch

ftp_put() - Lädt eine Datei auf einen FTP-Server
ftp_fput() - Überträgt eine geöffnete Datei auf einen FTP-Server

add a note

User Contributed Notes

There are no user contributed notes for this page.