By Vikram Vaswani
Melonfire
November 07, 2000
   我們是一群PHP的忠實(shí)FANS，我們因各種不同的原因使用它-WEB站點(diǎn)的開發(fā)，畫圖，數(shù)據(jù)庫的聯(lián)接等 -我們發(fā)現(xiàn)，它非常的友好，強(qiáng)大而且易于使用……
你可能已經(jīng)看到PHP是怎樣被用于創(chuàng)建GIF和JPEG圖像，從數(shù)據(jù)庫中動態(tài)的獲取信息等等，但這只是冰山的一角---最新版本的PHP擁有著強(qiáng)大的文件傳輸功能。
在這篇教程里，我將向你展示FTP怎樣通過HTTP和FTP聯(lián)接來傳輸文件，同時也會有一些簡單的程序代碼，跟我來吧！

首先，你應(yīng)該知道PHP是通過HTTP和FTP聯(lián)接來傳輸文件的。通過HTTP上傳文件早在PHP3中就已經(jīng)出現(xiàn)，現(xiàn)在，新的FTP函數(shù)已經(jīng)在新的PHP版本中出現(xiàn)了！
開始之前，你需要確信你的PHP支持FTP，你可以通過以下代碼查知：

--------------------------------------------------------------------------------
<?

phpinfo();

?>
--------------------------------------------------------------------------------
檢查輸出結(jié)果，有一“Additional Modules”區(qū)，這里列示了你的PHP支持的模塊；如果你沒發(fā)現(xiàn)FTP模塊，你最好重新安裝PHP，并添加FTP支持！

先讓我們來看看一個典型的FTP任務(wù)是怎樣完成的吧！
--------------------------------------------------------------------------------
$ ftp ftp.server.com
Connected to ftp.server.com
220 server.com FTP server ready.
Name (server:john): john
331 Password required for john.
Password:
230 User john logged in.
Remote system type is UNIX.
Using binary mode to transfer files.
ftp> ls
200 PORT command successful.
150 Opening ASCII mode data connection for /bin/ls.
drwxr-xr-x  5 john   users        3072 Nov  2 11:03 .
drwxr-xr-x  88 root     root         2048 Nov  1 23:26 ..
drwxr--r--   2 john   users        1024 Oct  5 13:26 bin
drwx--x--x   8 john   users        1024 Nov  2 10:59 public_html
drwxr--r--   4 john   users        1024 Nov  2 11:26 tmp
-rw-r--r--   1 john   users     2941465 Oct  9 17:21 data.zip
226 Transfer complete.
ftp> bin
200 Type set to I.
ftp> get data.zip
local: data.zip remote: data.zip
200 PORT command successful.
150 Opening BINARY mode data connection for data.zip(2941465 bytes).
226 Transfer complete.
ftp> bye
221 Goodbye.
--------------------------------------------------------------------------------
你可以看到，進(jìn)程明顯被分為幾段：聯(lián)接（與FTP服務(wù)器建立聯(lián)接）、驗(yàn)證（確定用戶是否有權(quán)力進(jìn)入系統(tǒng)）、傳輸（這里包括列目錄，上傳或下載文件）、取消聯(lián)接。

使用PHP來FTP的步驟
建立一個PHP的FTP聯(lián)接必須遵守以下基本步驟：打開一個聯(lián)接 - 發(fā)出認(rèn)證信息 - 使用PHP函數(shù)操縱目錄和傳輸文件。
以下具體實(shí)現(xiàn)：
--------------------------------------------------------------------------------
<?

// 聯(lián)接FTP服務(wù)器
$conn = ftp_connect("ftp.server.com");

// 使用username和password登錄
ftp_login($conn, "john", "doe");

// 獲取遠(yuǎn)端系統(tǒng)類型
ftp_systype($conn);

// 列示文件
$filelist = ftp_nlist($conn, ".");

// 下載文件
ftp_get($conn, "data.zip", "data.zip", FTP_BINARY);

// 關(guān)閉聯(lián)接
ftp_quit($conn);

?>
--------------------------------------------------------------------------------
讓我們一步步的來：
為了初結(jié)化一個FTP聯(lián)接，PHP提供了ftp_connect()這個函數(shù)，它使用主機(jī)名稱和端口作為參數(shù)。在上面的例子里，主機(jī)名字為“ftp.server.com”；如果端口沒指定，PHP將會使用“21”作為缺省端口來建立聯(lián)接。
聯(lián)接成功后ftp_connect()傳回一個handle句柄；這個handle將被以后使用的FTP函數(shù)使用。
--------------------------------------------------------------------------------
<?

// connect to FTP server
$conn = ftp_connect("ftp.server.com");

?>
--------------------------------------------------------------------------------
一旦建立聯(lián)接，使用ftp_login()發(fā)送一個用戶名稱和用戶密碼。你可以看到，這個函數(shù)ftp_login()使用了ftp_connect()函數(shù)傳來的handle，以確定用戶名和密碼能被提交到正確的服務(wù)器。
--------------------------------------------------------------------------------
<?

// log in with username and password
ftp_login($conn, "john", "doe");

?>
--------------------------------------------------------------------------------
這時，你就能夠做你想做的事情了，具體在下一部分講：

做完你想做的事后，千萬要記住使用ftp_quit()函數(shù)關(guān)閉你的FTP聯(lián)接

--------------------------------------------------------------------------------
<?

// close connection
ftp_quit($conn);

?>
--------------------------------------------------------------------------------
登錄了FTP服務(wù)器，PHP提供了一些函數(shù)，它們能獲取一些關(guān)于系統(tǒng)和文件以及目錄的信息。

ftp_pwd()
如果你想知道你當(dāng)前所在的目錄時，你就要用到這個函數(shù)了。
--------------------------------------------------------------------------------
<?

// get current location
$here = ftp_pwd($conn);

?>
--------------------------------------------------------------------------------
萬一你需要知道服務(wù)器端運(yùn)行的是什么系統(tǒng)呢？
ftp_systype()正好提供給你這方面的信息。
--------------------------------------------------------------------------------
<?

// get system type
$server_os = ftp_systype($conn);

?>
--------------------------------------------------------------------------------
關(guān)于被動模式（PASV）的開關(guān)，PHP也提供了這樣一個函數(shù)，它能打開或關(guān)閉PASV（1表示開）
--------------------------------------------------------------------------------
<?

// turn PASV on
ftp_pasv($conn, 1);

?>
--------------------------------------------------------------------------------

現(xiàn)在，你已經(jīng)知道你在“哪里”和“誰”跟你在一起了吧，現(xiàn)在我們開始在目錄中逛逛--實(shí)現(xiàn)這一功能的是ftp_chdir()函數(shù)，它接受一個目錄名作為參數(shù)。
--------------------------------------------------------------------------------
<?

// change directory to "public_html"
ftp_chdir($conn, "public_html");

?>
--------------------------------------------------------------------------------
如果你想回到你剛才所在的目錄（父目錄），ftp_cdup()能幫你實(shí)現(xiàn)你的愿望，這個函數(shù)能回到上一級目錄。
--------------------------------------------------------------------------------
<?

// go up one level in the directory tree
ftp_cdup($conn);

?>
--------------------------------------------------------------------------------
你也能夠建立或移動一個目錄，這要使用ftp_mkdir()和ftp_rmdir()函數(shù)；注意：ftp_mkdir()建立成功的話，就會返回新建立的目錄名。
--------------------------------------------------------------------------------
<?

// make the directory "test"
ftp_mkdir($conn, "test");

// remove the directory "test"
ftp_rmdir($conn, "test");

?>
--------------------------------------------------------------------------------
建立一個FTP的目錄通常是傳輸文件--- 那么就讓我們開始吧！

先是上傳文件，ftp_put()函數(shù)能很好的勝任這一職責(zé)，它需要你指定一個本地文件名，上傳后的文件名以及傳輸?shù)念愋?。比方說：如果你想上傳“abc.txt”這個文件，上傳后命名為“xyz.txt”，命令應(yīng)該是這樣：
--------------------------------------------------------------------------------
<?

// upload
ftp_put($conn, "xyz.txt", "abc.txt", FTP_ASCII);

?>
--------------------------------------------------------------------------------
下載文件：
PHP所提供的函數(shù)是ftp_get()，它也需要一個服務(wù)器上文件名，下載后的文件名，以及傳輸類型作為參數(shù)，例如：服務(wù)器端文件為his.zip，你想下載至本地機(jī)，并命名為hers.zip，命令如下：
--------------------------------------------------------------------------------
<?

// download
ftp_get($conn, "hers.zip", "his.zip", FTP_BINARY);

?>
--------------------------------------------------------------------------------
PHP定義了兩種模式作為傳輸模式 FTP_BINARY 和 FTP_ASCII ，這兩種模式的使用請看上兩例，至于其詳細(xì)解釋，本文也不多說了，具體請參看相關(guān)書籍。




我該怎樣列示文件呢？（用DIR？ ：） ）
PHP提供兩種方法：一種是簡單列示文件名和目錄，另一種就是詳細(xì)的列示文件的大小，權(quán)限，創(chuàng)立時間等信息。
第一種使用ftp_nlist()函數(shù)，第二種用ftp_rawlist().兩種函數(shù)都需要一個目錄名做為參數(shù)，都返回目錄列做為一個數(shù)組，數(shù)組的每一個元素相當(dāng)于列表的一行。
--------------------------------------------------------------------------------
<?

// obtain file listing
$filelist = ftp_nlist($conn, ".");

?>
--------------------------------------------------------------------------------
你一定想知道文件的大小吧！別急，這里有一個非常容易的函數(shù)ftp_size()，它返回你所指定的文件的大小，使用BITES作為單位。要指出的是，如果它返回的是 “-1”的話，意味著這是一個目錄，在隨后的例子中，你將會看到這一功能的應(yīng)用。
--------------------------------------------------------------------------------
<?

// obtain file size of file "data.zip"
$filelist = ftp_size($conn, "data.zip");

?>

現(xiàn)在，我們已經(jīng)接觸了PHP關(guān)于FTP的大量函數(shù)，但這僅僅只是函數(shù)，離我們的目標(biāo)還遠(yuǎn)遠(yuǎn)不夠，要顯示出這些函數(shù)的真正力量，我們應(yīng)該建立一個程序，這個程序能以WEB方式上傳，下載文件---這就是我們將要做的！

在我們進(jìn)入代碼前，我想要告訴大家的是，這個例子僅僅只是為了向大家解釋PHP的各種FTP函數(shù)的使用，很多方面還不夠完善，比如說，錯誤分析等，至于你想應(yīng)用到你自己的程序中，你應(yīng)該進(jìn)行一些修改！

程序包括以下幾個文件：
index.html - 登錄文件

actions.php - 程序必需的FTP代碼

include.php - 程序主界面，它顯示文件列表和控制按鈕。

讓我們從 "index.html"開始吧:
--------------------------------------------------------------------------------
<table border=0 align=center>
<form action="actions.php" method=post>
<input type=hidden name=action value=CWD>
<tr>
<td>
Server
</td>
<td>
<input type=text name=server>
</td>
</tr>

<tr>
<td>
User
</td>
<td>
<input type=text name=username>
</td>
</tr>

<tr>
<td>
Password
</td>
<td>
<input type=password name=password>
</td>
</tr>

<tr>
<td colspan=2 align=center>
<input type="submit" value="Beam Me Up, Scotty!">
</td>
</tr>

</form>
</table>
--------------------------------------------------------------------------------
這是一個登錄表單，有一個服務(wù)器名稱、用戶名、密碼，輸入框。輸入的變量將會被存到$server, $username 和 $password 變量中，表單提交后，調(diào)用actions.php，它將初始化FTP聯(lián)接。

注意那個“hidden” 它傳給action.php一個變量$action ，值為CWD。


這是action.php文件的源碼：
--------------------------------------------------------------------------------
<html>
<head>
<basefont face=Arial>
</head>
<body>

<!-- the include.php interface will be inserted into this page -->

<?

//檢查表單傳來的數(shù)據(jù)，不全則報(bào)錯，要想程序完善的話，這里應(yīng)該有更全的輸入檢測功能
if (!$server
!$username
!$password)
{
echo "提交數(shù)據(jù)不全!";
}
else
{
// keep reading
}

?>

</body>
</html>
--------------------------------------------------------------------------------


接下來是變量 "actions". 程序允許以下的action：

"action=CWD"

改變工作目錄

"action=Delete"

刪除指定文件

"action=Download"

下載指定文件

"action=Upload"

上傳指定文件

如果你仔細(xì)檢查文件include.php，在里面包括一個HTML界面，你將會看到，它包括許多表單，每一個指向一個特定的功能，每一個表單包含一個field（通常隱藏） ，當(dāng)表單提交，相應(yīng)的功能將被執(zhí)行。

例如：按下“刪除”，"action=Delete"就被傳送給"actions.php"

為了操作這四個功能，actions.php中代碼如下：
--------------------------------------------------------------------------------
<?
// action: 改變目錄
if ($action == "CWD")
{
// 具體代碼
}

// action: 刪除文件
else if ($action == "Delete")
{
// 具體代碼
}
// action: 下載文件
else if ($action == "Download")
{
// 具體代碼
}
// action: 上傳文件
else if ($action == "Upload")
{
// 具體代碼
}

?>
--------------------------------------------------------------------------------
以上的具體代碼將會實(shí)現(xiàn)指定的功能，并退出循環(huán)，它們都包含以下步驟：

--------------------------------------------------------------------------------
通過定制的函數(shù)聯(lián)接并登錄FTP服務(wù)器
connect();

轉(zhuǎn)向適當(dāng)?shù)哪夸?br>
執(zhí)行選擇的功能

刷新列表，以察看改變的結(jié)果

通過include("include.php")，顯示文件列表和控制按鈕

關(guān)閉聯(lián)接
--------------------------------------------------------------------------------
注意:
以下功能支持多文件操作- 即 "action=Delete" 和 "action=Download" 它們使用FOR循環(huán)來實(shí)現(xiàn)。
變量$cdir 和 $here 將在每一階段實(shí)時更新。