array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.ftp-alloc.php', 1 => 'ftp_alloc', 2 => 'Reserviert Platz für eine hochzuladende Datei', ), 'up' => array ( 0 => 'ref.ftp.php', 1 => 'FTP-Funktionen', ), 'prev' => array ( 0 => 'ref.ftp.php', 1 => 'FTP-Funktionen', ), 'next' => array ( 0 => 'function.ftp-append.php', 1 => 'ftp_append', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/ftp/functions/ftp-alloc.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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