mirror of
https://github.com/moparisthebest/curl
synced 2024-11-12 04:25:08 -05:00
RFC1867 was updated by RFC2388
This commit is contained in:
parent
35eb9fc6ad
commit
37d509f04f
@ -480,7 +480,7 @@ waits for a reply from the server.
|
|||||||
.IP "-F/--form <name=content>"
|
.IP "-F/--form <name=content>"
|
||||||
(HTTP) This lets curl emulate a filled-in form in which a user has pressed the
|
(HTTP) This lets curl emulate a filled-in form in which a user has pressed the
|
||||||
submit button. This causes curl to POST data using the Content-Type
|
submit button. This causes curl to POST data using the Content-Type
|
||||||
multipart/form-data according to RFC1867. This enables uploading of binary
|
multipart/form-data according to RFC2388. This enables uploading of binary
|
||||||
files etc. To force the 'content' part to be a file, prefix the file name
|
files etc. To force the 'content' part to be a file, prefix the file name
|
||||||
with an @ sign. To just get the content part from a file, prefix the file name
|
with an @ sign. To just get the content part from a file, prefix the file name
|
||||||
with the symbol <. The difference between @ and < is then that @ makes a file
|
with the symbol <. The difference between @ and < is then that @ makes a file
|
||||||
|
@ -870,7 +870,7 @@ data using the read callback!
|
|||||||
Using POST with HTTP 1.1 implies the use of a "Expect: 100-continue" header.
|
Using POST with HTTP 1.1 implies the use of a "Expect: 100-continue" header.
|
||||||
You can disable this header with \fICURLOPT_HTTPHEADER\fP as usual.
|
You can disable this header with \fICURLOPT_HTTPHEADER\fP as usual.
|
||||||
|
|
||||||
To make multipart/formdata posts (aka rfc1867-posts), check out the
|
To make multipart/formdata posts (aka RFC2388-posts), check out the
|
||||||
\fICURLOPT_HTTPPOST\fP option.
|
\fICURLOPT_HTTPPOST\fP option.
|
||||||
.IP CURLOPT_POSTFIELDSIZE
|
.IP CURLOPT_POSTFIELDSIZE
|
||||||
If you want to post data to the server without letting libcurl do a strlen()
|
If you want to post data to the server without letting libcurl do a strlen()
|
||||||
|
@ -13,7 +13,7 @@ curl_formadd - add a section to a multipart/formdata HTTP POST
|
|||||||
.ad
|
.ad
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
curl_formadd() is used to append sections when building a multipart/formdata
|
curl_formadd() is used to append sections when building a multipart/formdata
|
||||||
HTTP POST (sometimes referred to as rfc1867-style posts). Append one section at
|
HTTP POST (sometimes referred to as RFC2388-style posts). Append one section at
|
||||||
a time until you've added all the sections you want included and then you pass
|
a time until you've added all the sections you want included and then you pass
|
||||||
the \fIfirstitem\fP pointer as parameter to \fBCURLOPT_HTTPPOST\fP.
|
the \fIfirstitem\fP pointer as parameter to \fBCURLOPT_HTTPPOST\fP.
|
||||||
\fIlastitem\fP is set after each call and on repeated invokes it should be
|
\fIlastitem\fP is set after each call and on repeated invokes it should be
|
||||||
|
@ -502,13 +502,14 @@ then passing that list to libcurl.
|
|||||||
While the simple examples above cover the majority of all cases where HTTP
|
While the simple examples above cover the majority of all cases where HTTP
|
||||||
POST operations are required, they don't do multi-part formposts. Multi-part
|
POST operations are required, they don't do multi-part formposts. Multi-part
|
||||||
formposts were introduced as a better way to post (possibly large) binary data
|
formposts were introduced as a better way to post (possibly large) binary data
|
||||||
and were first documented in the RFC1867. They're called multi-part because
|
and were first documented in the RFC1867 (updated in RFC2388). They're called
|
||||||
they're built by a chain of parts, each being a single unit. Each part has its
|
multi-part because they're built by a chain of parts, each part being a single
|
||||||
own name and contents. You can in fact create and post a multi-part formpost
|
unit of data. Each part has its own name and contents. You can in fact create
|
||||||
with the regular libcurl POST support described above, but that would require
|
and post a multi-part formpost with the regular libcurl POST support described
|
||||||
that you build a formpost yourself and provide to libcurl. To make that
|
above, but that would require that you build a formpost yourself and provide
|
||||||
easier, libcurl provides \fIcurl_formadd(3)\fP. Using this function, you add
|
to libcurl. To make that easier, libcurl provides \fIcurl_formadd(3)\fP. Using
|
||||||
parts to the form. When you're done adding parts, you post the whole form.
|
this function, you add parts to the form. When you're done adding parts, you
|
||||||
|
post the whole form.
|
||||||
|
|
||||||
The following example sets two simple text parts with plain textual contents,
|
The following example sets two simple text parts with plain textual contents,
|
||||||
and then a file with binary contents and uploads the whole thing.
|
and then a file with binary contents and uploads the whole thing.
|
||||||
|
Loading…
Reference in New Issue
Block a user