ftp_alloc
(PHP 5, PHP 7, PHP 8)
ftp_alloc — Reserviert Platz für eine hochzuladende Datei
Beschreibung
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