Sophie

Sophie

distrib > Mandriva > 2008.1 > x86_64 > by-pkgid > 05cd670d8a02b2b4a0ffb1756f2e8308 > files > 1086

php-manual-zh-5.2.4-1mdv2008.1.noarch.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>ftp_alloc</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="PHP 手册"
HREF="index.html"><LINK
REL="UP"
TITLE="FTP 函数"
HREF="ref.ftp.html"><LINK
REL="PREVIOUS"
TITLE="FTP 函数"
HREF="ref.ftp.html"><LINK
REL="NEXT"
TITLE="ftp_cdup"
HREF="function.ftp-cdup.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=UTF-8"></HEAD
><BODY
CLASS="refentry"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>PHP 手册</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="ref.ftp.html"
ACCESSKEY="P"
>上一页</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.ftp-cdup.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.ftp-alloc"
></A
>ftp_alloc</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN61196"
></A
><P
>    (PHP 5)</P
>ftp_alloc&nbsp;--&nbsp;Allocates space for a file to be uploaded</DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN61199"
></A
><H2
>说明</H2
>bool <B
CLASS="methodname"
>ftp_alloc</B
> ( resource ftp_stream, int filesize [, string &#38;result] )<BR
></BR
><P
>&#13;   Sends an <TT
CLASS="literal"
>ALLO</TT
> command to the remote FTP server to 
   allocate space for a file to be uploaded.
  </P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>注意: </B
>
    Many FTP servers do not support this command.  These servers may return a failure 
    code (<TT
CLASS="constant"
><B
>FALSE</B
></TT
>) indicating the command is not supported or a success code (<TT
CLASS="constant"
><B
>TRUE</B
></TT
>)
    to indicate that pre-allocation is not necessary and the client should continue
    as though the operation were successful.  Because of this, it may be best to reserve
    this function for servers which explicitly require preallocation.
   </P
></BLOCKQUOTE
></DIV
><P
>&#13;  </P
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN61220"
></A
><H2
>参数</H2
><P
>&#13;   <P
></P
><DIV
CLASS="variablelist"
><DL
><DT
><CODE
CLASS="parameter"
>ftp_stream</CODE
></DT
><DD
><P
>&#13;       The link identifier of the FTP connection.
      </P
></DD
><DT
><CODE
CLASS="parameter"
>filezise</CODE
></DT
><DD
><P
>&#13;       The number of bytes to allocate.
      </P
></DD
><DT
><CODE
CLASS="parameter"
>return</CODE
></DT
><DD
><P
>&#13;       A textual representation of the servers response will be returned by 
       reference in <CODE
CLASS="parameter"
>result</CODE
> if a variable is provided.
      </P
></DD
></DL
></DIV
>
  </P
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN61240"
></A
><H2
>返回值</H2
><P
>&#13;   如果成功则返回 <TT
CLASS="constant"
><B
>TRUE</B
></TT
>,失败则返回 <TT
CLASS="constant"
><B
>FALSE</B
></TT
>。
  </P
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN61245"
></A
><H2
>范例</H2
><P
>&#13;   <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN61248"
></A
><P
><B
>例 1. <B
CLASS="function"
>ftp_alloc()</B
> example</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br /><br />$file </font><font color="#007700">= </font><font color="#DD0000">"/home/user/myfile"</font><font color="#007700">;<br /><br /></font><font color="#FF8000">/* connect to the server */<br /></font><font color="#0000BB">$conn_id </font><font color="#007700">= </font><font color="#0000BB">ftp_connect</font><font color="#007700">(</font><font color="#DD0000">'ftp.example.com'</font><font color="#007700">);<br /></font><font color="#0000BB">$login_result </font><font color="#007700">= </font><font color="#0000BB">ftp_login</font><font color="#007700">(</font><font color="#0000BB">$conn_id</font><font color="#007700">, </font><font color="#DD0000">'anonymous'</font><font color="#007700">, </font><font color="#DD0000">'user@example.com'</font><font color="#007700">);<br /><br />if (</font><font color="#0000BB">ftp_alloc</font><font color="#007700">(</font><font color="#0000BB">$conn_id</font><font color="#007700">, </font><font color="#0000BB">filesize</font><font color="#007700">(</font><font color="#0000BB">$file</font><font color="#007700">), </font><font color="#0000BB">$result</font><font color="#007700">)) {<br />&nbsp;&nbsp;echo </font><font color="#DD0000">"Space successfully allocated on server.&nbsp;&nbsp;Sending $file.</font><font color="#007700">\n</font><font color="#DD0000">"</font><font color="#007700">;<br />&nbsp;&nbsp;</font><font color="#0000BB">ftp_put</font><font color="#007700">(</font><font color="#0000BB">$conn_id</font><font color="#007700">, </font><font color="#DD0000">'/incomming/myfile'</font><font color="#007700">, </font><font color="#0000BB">$file</font><font color="#007700">, </font><font color="#0000BB">FTP_BINARY</font><font color="#007700">);<br />} else {<br />&nbsp;&nbsp;echo </font><font color="#DD0000">"Unable to allocate space on server.&nbsp;&nbsp;Server said: $result</font><font color="#007700">\n</font><font color="#DD0000">"</font><font color="#007700">;<br />}<br /><br /></font><font color="#0000BB">ftp_close</font><font color="#007700">(</font><font color="#0000BB">$conn_id</font><font color="#007700">);<br /><br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
  </P
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN61252"
></A
><H2
>参见</H2
><P
>&#13;   <P
></P
><TABLE
BORDER="0"
><TBODY
><TR
><TD
><A
HREF="function.ftp-put.html"
><B
CLASS="function"
>ftp_put()</B
></A
></TD
></TR
><TR
><TD
><A
HREF="function.ftp-fput.html"
><B
CLASS="function"
>ftp_fput()</B
></A
></TD
></TR
></TBODY
></TABLE
><P
></P
>
  </P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="ref.ftp.html"
ACCESSKEY="P"
>上一页</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>起始页</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="function.ftp-cdup.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>FTP 函数</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ref.ftp.html"
ACCESSKEY="U"
>上一级</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>ftp_cdup</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>