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 將在每一階段實時更新。
|