Bezeichnung
form:AddFiles -- fügt mehrere Datei-Upload-Sektionen zu einem HTTP-POST hinzu
Übersicht
form:AddFiles(name, table)
Beschreibung
form:AddFiles() wird verwendet, um mehrere Datei-Upload-Sektionen beim Erstellen eines Multipart/Formdata-HTTP-POST (manchmal auch als RFC 2388-ähnliche Post bezeichnet) anzuhängen. Nachdem Sie alle gewünschten Sektionen hinzugefügt haben, übergeben Sie das Formularelement als Parameter an #CURLOPT_HTTPPOST. Siehe easy:SetOpt_HTTPPost für Details.

Sie müssen form:Free() aufrufen, nachdem der Form-Post erstellt wurde, um die Ressourcen freizugeben.

Die Verwendung von POST mit HTTP 1.1 impliziert die Verwendung eines "Expect: 100-continue" Headers. Sie können diesen Header mit #CURLOPT_HTTPHEADER wie gewohnt deaktivieren.

Erstens gibt es einige Grundlagen, die Sie über Multipart/Formdata-Post verstehen müssen. Jeder Teil besteht aus mindestens einem NAME- und einem CONTENTS-Teil. Wenn der Teil für den Datei-Upload gemacht wird, gibt es auch einen gespeicherten CONTENT-TYPE und einen FILENAME (Dateiname). Im Folgenden werden wir besprechen, welche Optionen Sie verwenden, um diese Eigenschaften in den Teilen festzulegen, die Sie Ihrem Post hinzufügen möchten.

Das Argument name muss eine Zeichenkette sein, die den Namen dieses Teils angibt. Der Name darf keine nullwertigen Bytes enthalten.

Das Argument table muss eine Tabelle enthalten, die eine Liste der Dateien beschreibt, die dem Form-Post-Objekt hinzugefügt werden sollen. In der Tabelle muss ein Element pro Datei vorhanden sein. Die einzelnen Tabellenelemente können drei verschiedene Typen haben:

  1. Eine Zeichenkette: In diesem Fall muss die Zeichenkette lediglich den Pfad zu der hochzuladenden Datei enthalten.
  2. Eine Tabelle mit zwei Zeichenketten: In diesem Fall muss die erste Zeichenkette den Pfad zu der hochzuladenden Datei enthalten und die zweite Zeichenkette muss den Content-Typ für die Datei enthalten.
  3. Eine Tabelle mit drei Zeichenketten: Wie oben, aber die dritte Zeichenkette muss einen Dateinamen enthalten, der anstelle des Dateinamens für den Teil verwendet werden soll, der aus dem in der ersten Zeichenkette in der Tabelle angegebenen Pfad abgeleitet ist.

Eingaben
name
Name des Elements
table
Tabelle mit den hochzuladenden Dateien (siehe oben)

Navigation zeigen