📄 function.ftp-alloc.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html> <head> <title>Allocates space for a file to be uploaded</title> <meta http-equiv="content-type" content="text/html; charset=UTF-8"> </head> <body><div style="text-align: center;"> <div class="prev" style="text-align: left; float: left;"><a href="ref.ftp.html">FTP Functions</a></div> <div class="next" style="text-align: right; float: right;"><a href="function.ftp-cdup.html">ftp_cdup</a></div> <div class="up"><a href="ref.ftp.html">FTP Functions</a></div> <div class="home"><a href="index.html">PHP Manual</a></div></div><hr /><div id="function.ftp-alloc" class="refentry"> <div class="refnamediv"> <h1 class="refname">ftp_alloc</h1> <p class="verinfo">(PHP 5)</p><p class="refpurpose"><span class="refname">ftp_alloc</span> — <span class="dc-title">Allocates space for a file to be uploaded</span></p> </div> <div class="refsect1 description"> <h3 class="title">Description</h3> <div class="methodsynopsis dc-description"> <span class="type">bool</span> <span class="methodname"><b><b>ftp_alloc</b></b></span> ( <span class="methodparam"><span class="type">resource</span> <tt class="parameter">$ftp_stream</tt></span> , <span class="methodparam"><span class="type">int</span> <tt class="parameter">$filesize</tt></span> [, <span class="methodparam"><span class="type">string</span> <tt class="parameter reference">&$result</tt></span> ] )</div> <p class="para rdfs-comment"> Sends an <i>ALLO</i> command to the remote FTP server to allocate space for a file to be uploaded. </p> <blockquote><p><b class="note">Note</b>: Many FTP servers do not support this command. These servers may return a failure code (<b><tt>FALSE</tt></b>) indicating the command is not supported or a success code (<b><tt>TRUE</tt></b>) 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. <br /> </p></blockquote> <p class="para"> </p> </div> <div class="refsect1 parameters"> <h3 class="title">Parameters</h3> <p class="para"> <dl> <dt> <span class="term"><i><tt class="parameter">ftp_stream</tt></i></span> <dd> <p class="para"> The link identifier of the FTP connection. </p> </dd> </dt> <dt> <span class="term"><i><tt class="parameter">filezise</tt></i></span> <dd> <p class="para"> The number of bytes to allocate. </p> </dd> </dt> <dt> <span class="term"><i><tt class="parameter">return</tt></i></span> <dd> <p class="para"> A textual representation of the servers response will be returned by reference in <i><tt class="parameter">result</tt></i> if a variable is provided. </p> </dd> </dt> </dl> </p> </div> <div class="refsect1 returnvalues"> <h3 class="title">Return Values</h3> <p class="para"> Returns <b><tt>TRUE</tt></b> on success or <b><tt>FALSE</tt></b> on failure. </p> </div> <div class="refsect1 examples"> <h3 class="title">Examples</h3> <p class="para"> <div class="example"> <p><b>Example #1 <b>ftp_alloc()</b> example</b></p> <div class="example-contents"><div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB"><?php<br /><br />$file </span><span style="color: #007700">= </span><span style="color: #DD0000">"/home/user/myfile"</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">/* connect to the server */<br /></span><span style="color: #0000BB">$conn_id </span><span style="color: #007700">= </span><span style="color: #0000BB">ftp_connect</span><span style="color: #007700">(</span><span style="color: #DD0000">'ftp.example.com'</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$login_result </span><span style="color: #007700">= </span><span style="color: #0000BB">ftp_login</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn_id</span><span style="color: #007700">, </span><span style="color: #DD0000">'anonymous'</span><span style="color: #007700">, </span><span style="color: #DD0000">'user@example.com'</span><span style="color: #007700">);<br /><br />if (</span><span style="color: #0000BB">ftp_alloc</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn_id</span><span style="color: #007700">, </span><span style="color: #0000BB">filesize</span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">), </span><span style="color: #0000BB">$result</span><span style="color: #007700">)) {<br /> echo </span><span style="color: #DD0000">"Space successfully allocated on server. Sending $file.\n"</span><span style="color: #007700">;<br /> </span><span style="color: #0000BB">ftp_put</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn_id</span><span style="color: #007700">, </span><span style="color: #DD0000">'/incomming/myfile'</span><span style="color: #007700">, </span><span style="color: #0000BB">$file</span><span style="color: #007700">, </span><span style="color: #0000BB">FTP_BINARY</span><span style="color: #007700">);<br />} else {<br /> echo </span><span style="color: #DD0000">"Unable to allocate space on server. Server said: $result\n"</span><span style="color: #007700">;<br />}<br /><br /></span><span style="color: #0000BB">ftp_close</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn_id</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">?></span></span></code></div> </div> </div> </p> </div> <div class="refsect1 seealso"> <h3 class="title">See Also</h3> <p class="para"> <ul class="simplelist"> <li class="member"><a href="function.ftp-put.html" class="function" rel="rdfs-seeAlso">ftp_put()</a></li> <li class="member"><a href="function.ftp-fput.html" class="function" rel="rdfs-seeAlso">ftp_fput()</a></li> </ul> </p> </div></div><hr /><div style="text-align: center;"> <div class="prev" style="text-align: left; float: left;"><a href="ref.ftp.html">FTP Functions</a></div> <div class="next" style="text-align: right; float: right;"><a href="function.ftp-cdup.html">ftp_cdup</a></div> <div class="up"><a href="ref.ftp.html">FTP Functions</a></div> <div class="home"><a href="index.html">PHP Manual</a></div></div></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -