cvs: phpdoc /en/appendices wrappers.xml

pollita Thu Apr 24 19:47:12 2003 EDT Modified files: /phpdoc/en/appendices wrappers.xml Log: Show defaults for context options, clear up documentation on opening ftp:// URLs for writting, and add note for appending. Index: phpdoc/en/appendices/wrappers.xml diff -u phpdoc/en/appendices/wrappers.xml:1.13 phpdoc/en/appendices/wrappers.xml:1.14 --- phpdoc/en/appendices/wrappers.xml:1.13 Tue Apr 22 00:21:24 2003 +++ phpdoc/en/appendices/wrappers.xml Thu Apr 24 19:47:12 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> +<!-- $Revision: 1.14 $ --> <appendix id="wrappers"> <title>List of Supported Protocols/Wrappers</title> <para> @@ -58,14 +58,15 @@ <row> <entry>Name</entry> <entry>Usage</entry> + <entry>Default</entry> </row> </thead> <tbody> <row> <entry><literal>method</literal></entry> <entry><constant>GET</constant> or <constant>POST</constant> - (defaults to <constant>GET</constant>). </entry> + <entry><constant>GET</constant></entry> </row> <row> <entry><literal>header</literal></entry> @@ -74,6 +75,7 @@ <literal>User-agent:</literal>, <literal>Host:</literal>, and <literal>Authentication:</literal>. </entry> + <entry></entry> </row> <row> <entry><literal>content</literal></entry> @@ -81,6 +83,7 @@ Additional data to be sent after the headers. Typically used with POST requests. </entry> + <entry></entry> </row> </tbody> </tgroup> @@ -107,10 +110,21 @@ <simpara> You can open files for either reading or writing, but not both simultaneously. If the remote file already exists on the ftp - server and you attempt to open it for writing, the connection - will fail. If you need to update existing files over ftp, - use <function>ftp_connect</function>. + server and you attempt to open it for writing but have not specified + the context option <literal>overwrite</literal>, the connection + will fail. If you need to overwrite existing files over ftp, + specify the <literal>overwrite</literal> option in the context + and open the file for writting. Alternatively, you can + use the <link linkend="ref.ftp">FTP extension</link>. </simpara> + <note> + <title>Appending</title> + <simpara> + As of <literal>PHP 5.0</literal> files may be appended via the + <literal>ftp://</literal> url wrapper. In prior versions, attempting + to append to a file via <literal>ftp://</literal> will result in failure. + </simpara> + </note> <simpara> <filename>ftps://</filename> was introduced in PHP 4.3. It is the same as <filename>ftp://</filename>, @@ -131,6 +145,7 @@ <row> <entry>Name</entry> <entry>Usage</entry> + <entry>Default</entry> </row> </thead> <tbody> @@ -138,8 +153,8 @@ <entry><literal>overwrite</literal></entry> <entry> Allow overwritting of already existing files on remote server. - Disabled by default. </entry> + <entry>&false; (Disabled)</entry> </row> </tbody> </tgroup>