<!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 -- 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 &result] )<BR ></BR ><P > 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 > </P ></DIV ><DIV CLASS="refsect1" ><A NAME="AEN61220" ></A ><H2 >参数</H2 ><P > <P ></P ><DIV CLASS="variablelist" ><DL ><DT ><CODE CLASS="parameter" >ftp_stream</CODE ></DT ><DD ><P > The link identifier of the FTP connection. </P ></DD ><DT ><CODE CLASS="parameter" >filezise</CODE ></DT ><DD ><P > The number of bytes to allocate. </P ></DD ><DT ><CODE CLASS="parameter" >return</CODE ></DT ><DD ><P > 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 > 如果成功则返回 <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 > <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"><?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 /> echo </font><font color="#DD0000">"Space successfully allocated on server. Sending $file.</font><font color="#007700">\n</font><font color="#DD0000">"</font><font color="#007700">;<br /> </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 /> echo </font><font color="#DD0000">"Unable to allocate space on server. 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">?></font> </font> </code></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE > </P ></DIV ><DIV CLASS="refsect1" ><A NAME="AEN61252" ></A ><H2 >参见</H2 ><P > <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 >