By Vikram Vaswani
Melonfire
November 07, 2000
我們是一群PHP的忠實FANS，我們因各種不同的原因使用它-WEB站點的開發，畫圖，數據庫的聯接等 -我們發現，它非常的友好，強大而且易於使用……
你可能已經看到PHP是怎樣被用於創建GIF和JPEG圖像，從數據庫中動態的獲取信息等等，但這只是冰山的一角---最新版本的PHP擁有著強大的文件傳輸功能。
在這篇教程裡，我將向你展示FTP怎樣通過HTTP和FTP聯接來傳輸文件，同時也會有一些簡單的程序代碼，跟我來吧！
首先，你應該知道PHP是通過HTTP和FTP聯接來傳輸文件的。通過HTTP上傳文件早在PHP3中就已經出現，現在，新的FTP函數已經在新的PHP版本中出現了！
開始之前，你需要確信你的PHP支持FTP，你可以通過以下代碼查知：
--------------------------------------------------------------------------------
<?
phpinfo();
?>
--------------------------------------------------------------------------------
檢查輸出結果，有一“Additional Modules”區，這裡列示了你的PHP支持的模塊；如果你沒發現FTP模塊，你最好重新安裝PHP，並添加FTP支持！
先讓我們來看看一個典型的FTP任務是怎樣完成的吧！
--------------------------------------------------------------------------------
$ 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.
--------------------------------------------------------------------------------
你可以看到，進程明顯被分為幾段：聯接（與FTP服務器建立聯接）、驗證（確定用戶是否有權力進入系統）、傳輸（這裡包括列目錄，上傳或下載文件）、取消聯接。
使用PHP來FTP的步驟
建立一個PHP的FTP聯接必須遵守以下基本步驟：打開一個聯接 - 發出認證信息 - 使用PHP函數操縱目錄和傳輸文件。
以下具體實現：
--------------------------------------------------------------------------------
<?
// 聯接FTP服務器
$conn = ftp_connect("ftp.server.com");
// 使用username和password登錄
ftp_login($conn, "john", "doe");
// 獲取遠端系統類型
ftp_systype($conn);
// 列示文件
$filelist = ftp_nlist($conn, ".");
// 下載文件
ftp_get($conn, "data.zip", "data.zip", FTP_BINARY);
// 關閉聯接
ftp_quit($conn);
?>
--------------------------------------------------------------------------------
讓我們一步步的來：
為了初結化一個FTP聯接，PHP提供了ftp_connect()這個函數，它使用主機名稱和端口作為參數。在上面的例子裡，主機名字為“ftp.server.com”；如果端口沒指定，PHP將會使用“21”作為缺省端口來建立聯接。
聯接成功後ftp_connect()傳回一個handle句柄；這個handle將被以後使用的FTP函數使用。
--------------------------------------------------------------------------------
<?
// connect to FTP server
$conn = ftp_connect("ftp.server.com");
?>
--------------------------------------------------------------------------------
一旦建立聯接，使用ftp_login()發送一個用戶名稱和用戶密碼。你可以看到，這個函數ftp_login()使用了ftp_connect()函數傳來的handle，以確定用戶名和密碼能被提交到正確的服務器。
--------------------------------------------------------------------------------
<?
// log in with username and password
ftp_login($conn, "john", "doe");
?>
--------------------------------------------------------------------------------
這時，你就能夠做你想做的事情了，具體在下一部分講：
做完你想做的事後，千萬要記住使用ftp_quit()函數關閉你的FTP聯接
--------------------------------------------------------------------------------
<?
// close connection
ftp_quit($conn);
?>
--------------------------------------------------------------------------------
登錄了FTP服務器，PHP提供了一些函數，它們能獲取一些關於系統和文件以及目錄的信息。
ftp_pwd()
如果你想知道你當前所在的目錄時，你就要用到這個函數了。
--------------------------------------------------------------------------------
<?
// get current location
$here = ftp_pwd($conn);
?>
--------------------------------------------------------------------------------
萬一你需要知道服務器端運行的是什麼系統呢？
ftp_systype()正好提供給你這方面的信息。
--------------------------------------------------------------------------------
<?
// get system type
$server_os = ftp_systype($conn);
?>
--------------------------------------------------------------------------------
關於被動模式（PASV）的開關，PHP也提供了這樣一個函數，它能打開或關閉PASV（1表示開）
--------------------------------------------------------------------------------
<?
// turn PASV on
ftp_pasv($conn, 1);
?>
--------------------------------------------------------------------------------
現在，你已經知道你在“哪裡”和“誰”跟你在一起了吧，現在我們開始在目錄中逛逛--實現這一功能的是ftp_chdir()函數，它接受一個目錄名作為參數。
--------------------------------------------------------------------------------
<?
// change directory to "public_html"
ftp_chdir($conn, "public_html");
?>
--------------------------------------------------------------------------------
如果你想回到你剛才所在的目錄（父目錄），ftp_cdup()能幫你實現你的願望，這個函數能回到上一級目錄。
--------------------------------------------------------------------------------
<?
// go up one level in the directory tree
ftp_cdup($conn);
?>
--------------------------------------------------------------------------------
你也能夠建立或移動一個目錄，這要使用ftp_mkdir()和ftp_rmdir()函數；注意：ftp_mkdir()建立成功的話，就會返回新建立的目錄名。
--------------------------------------------------------------------------------
<?
// make the directory "test"
ftp_mkdir($conn, "test");
// remove the directory "test"
ftp_rmdir($conn, "test");
?>
--------------------------------------------------------------------------------
建立一個FTP的目錄通常是傳輸文件--- 那麼就讓我們開始吧！
先是上傳文件，ftp_put()函數能很好的勝任這一職責，它需要你指定一個本地文件名，上傳後的文件名以及傳輸的類型。比方說：如果你想上傳“abc.txt”這個文件，上傳後命名為“xyz.txt”，命令應該是這樣：
--------------------------------------------------------------------------------
<?
// upload
ftp_put($conn, "xyz.txt", "abc.txt", FTP_ASCII);
?>
--------------------------------------------------------------------------------
下載文件：
PHP所提供的函數是ftp_get()，它也需要一個服務器上文件名，下載後的文件名，以及傳輸類型作為參數，例如：服務器端文件為his.zip，你想下載至本地機，並命名為hers.zip，命令如下：
--------------------------------------------------------------------------------
<?
// download
ftp_get($conn, "hers.zip", "his.zip", FTP_BINARY);
?>
--------------------------------------------------------------------------------
PHP定義了兩種模式作為傳輸模式 FTP_BINARY 和 FTP_ASCII ，這兩種模式的使用請看上兩例，至於其詳細解釋，本文也不多說了，具體請參看相關書籍。
我該怎樣列示文件呢？（用DIR？ ：） ）
PHP提供兩種方法：一種是簡單列示文件名和目錄，另一種就是詳細的列示文件的大小，權限，創立時間等信息。
第一種使用ftp_nlist()函數，第二種用ftp_rawlist().兩種函數都需要一個目錄名做為參數，都返回目錄列做為一個數組，數組的每一個元素相當於列表的一行。
--------------------------------------------------------------------------------
<?
// obtain file listing
$filelist = ftp_nlist($conn, ".");
?>
--------------------------------------------------------------------------------
你一定想知道文件的大小吧！別急，這裡有一個非常容易的函數ftp_size()，它返回你所指定的文件的大小，使用BITES作為單位。要指出的是，如果它返回的是 “-1”的話，意味著這是一個目錄，在隨後的例子中，你將會看到這一功能的應用。
--------------------------------------------------------------------------------
<?
// obtain file size of file "data.zip"
$filelist = ftp_size($conn, "data.zip");
?>
現在，我們已經接觸了PHP關於FTP的大量函數，但這僅僅只是函數，離我們的目標還遠遠不夠，要顯示出這些函數的真正力量，我們應該建立一個程序，這個程序能以WEB方式上傳，下載文件---這就是我們將要做的！
在我們進入代碼前，我想要告訴大家的是，這個例子僅僅只是為了向大家解釋PHP的各種FTP函數的使用，很多方面還不夠完善，比如說，錯誤分析等，至於你想應用到你自己的程序中，你應該進行一些修改！
程序包括以下幾個文件：
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>
--------------------------------------------------------------------------------
這是一個登錄表單，有一個服務器名稱、用戶名、密碼，輸入框。輸入的變量將會被存到$server, $username 和 $password 變量中，表單提交後，調用actions.php，它將初始化FTP聯接。
注意那個“hidden” 它傳給action.php一個變量$action ，值為CWD。
這是action.php文件的源碼：
--------------------------------------------------------------------------------
<html>
<head>
<basefont face=Arial>
</head>
<body>
<!-- the include.php interface will be inserted into this page -->
<?
//檢查表單傳來的數據，不全則報錯，要想程序完善的話，這裡應該有更全的輸入檢測功能
if (!$server
!$username
!$password)
{
echo "提交數據不全!";
}
else
{
// keep reading
}
?>
</body>
</html>
--------------------------------------------------------------------------------
接下來是變量 "actions". 程序允許以下的action：
"action=CWD"
改變工作目錄
"action=Delete"
刪除指定文件
"action=Download"
下載指定文件
"action=Upload"
上傳指定文件
如果你仔細檢查文件include.php，在裡面包括一個HTML界面，你將會看到，它包括許多表單，每一個指向一個特定的功能，每一個表單包含一個field（通常隱藏） ，當表單提交，相應的功能將被執行。
例如：按下“刪除”，"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")
{
// 具體代碼
}
?>
--------------------------------------------------------------------------------
以上的具體代碼將會實現指定的功能，並退出循環，它們都包含以下步驟：
--------------------------------------------------------------------------------
通過定制的函數聯接並登錄FTP服務器
connect();
轉向適當的目錄
執行選擇的功能
刷新列表，以察看改變的結果
通過include("include.php")，顯示文件列表和控制按鈕
關閉聯接
--------------------------------------------------------------------------------
注意:
以下功能支持多文件操作- 即 "action=Delete" 和 "action=Download" 它們使用FOR循環來實現。
變量$cdir 和 $here 將在每一階段實時更新。
