FTP是一種文件傳輸協議,它支持兩種模式,一種方式叫做Standard (也就是Active,主動方式),一種是 Passive (也就是PASV,被動方式)。 Standard模式 FTP 的客戶端發送 PORT 命令到FTP server。Passive模式FTP的客戶端發送 PASV命令到 FTP Server。
下面介紹一個這兩種方式的工作原理:
Standard模式
FTP 客戶端首先和FTP Server的TCP 21端口建立連接,通過這個通道 發送命令,客戶端需要接收數據的時候在這個通道上發送PORT命令。 PORT命令包含 了客戶端用什麼端口接收數據。在傳送數據的時候,服務器端通過自己的TCP 20端口發送數據。 FTP server必須和客戶端建立一個新的連接用來傳送數據。
Passive模式
在建立控制通道的時候和Standard模式類似,當客戶端通過這個通道發送PASV 命令的時候,FTP server打開一個位於1024和5000之間的隨機端口並且通知 客戶端在這個端口上傳送數據的請求,然後FTP server 將通過這個端口進行數據的傳送,這個時候FTP server不再需要建立一個新的和客戶端之間的連接。
使用PHP操作FTP-用法
復制代碼 代碼如下:
<?
// 聯接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函數使用。
$conn = ftp_connect(ftp.server.com);
//一旦建立聯接,使用ftp_login()發送一個用戶名稱和用戶密碼。你可以看到,這個函數ftp_login()使用了 ftp_connect()函數傳來的handle,以確定用戶名和密碼能被提交到正確的服務器。
ftp_login($conn, “john”, “doe”);
// close connection
ftp_quit($conn);
//登錄了FTP服務器,PHP提供了一些函數,它們能獲取一些關於系統和文件以及目錄的信息。
ftp_pwd()
//獲取當前所在的目錄
$here = ftp_pwd($conn);
//獲取服務器端系統信息ftp_systype()
$server_os = ftp_systype($conn);
//被動模式(PASV)的開關,打開或關閉PASV(1表示開)
ftp_pasv($conn, 1);
//進入目錄中用ftp_chdir()函數,它接受一個目錄名作為參數。
ftp_chdir($conn, “public_html”);
//回到所在的目錄父目錄用ftp_cdup()實現
ftp_cdup($conn);
//建立或移動一個目錄,這要使用ftp_mkdir()和ftp_rmdir()函數;注意:ftp_mkdir()建立成功的話,就會返回新建立的目錄名。
ftp_mkdir($conn, “test”);
ftp_rmdir($conn, “test”);
//上傳文件,ftp_put()函數能很好的勝任,它需要你指定一個本地文件名,上傳後的文件名以及傳輸的類型。比方說:如果你想上傳 “abc.txt”這個文件,上傳後命名為“xyz.txt”,命令應該是這樣:
ftp_put($conn, “xyz.txt”, “abc.txt”, FTP_ASCII);
//下載文件:PHP所提供的函數是ftp_get(),它也需要一個服務器上文件名,下載後的文件名,以及傳輸類型作為參數,例如:服務器端文件為his.zip,你想下載至本地機,並命名為hers.zip,命令如下:
ftp_get($conn, “hers.zip”, “his.zip”, FTP_BINARY);
//PHP提供兩種方法:一種是簡單列示文件名和目錄,另一種就是詳細的列示文件的大小,權限,創立時間等信息。
//第一種使用ftp_nlist()函數,第二種用ftp_rawlist().兩種函數都需要一個目錄名做為參數,都返回目錄列做為一個數組,數組的每一個元素相當於列表的一行。
$filelist = ftp_nlist($conn, “.”);
//函數ftp_size(),它返回你所指定的文件的大小,使用BITES作為單位。要指出的是,如果它返回的是 “-1”的話,意味著這是一個目錄
$filelist = ftp_size($conn, “data.zip”);
?>
FTP類
復制代碼 代碼如下:
<?php
/**
* 仿寫CodeIgniter的FTP類
* FTP基本操作:
* 1) 登陸; connect
* 2) 當前目錄文件列表; filelist
* 3) 目錄改變; chgdir
* 4) 重命名/移動; rename
* 5) 創建文件夾; mkdir
* 6) 刪除; delete_dir/delete_file
* 7) 上傳; upload
* 8) 下載 download
*
* @author quanshuidingdang
*/
class Ftp {
private $hostname = '';
private $username = '';
private $password = '';
private $port = 21;
private $passive = TRUE;
private $debug = TRUE;
private $conn_id = FALSE;
/**
* 構造函數
*
* @param array 配置數組 : $config = array('hostname'=>'','username'=>'','password'=>'','port'=>''...);
*/
public function __construct($config = array()) {
if(count($config) > 0) {
$this->_init($config);
}
}
/**
* FTP連接
*
* @access public
* @param array 配置數組
* @return boolean
*/
public function connect($config = array()) {
if(count($config) > 0) {
$this->_init($config);
}
if(FALSE === ($this->conn_id = @ftp_connect($this->hostname,$this->port))) {
if($this->debug === TRUE) {
$this->_error("ftp_unable_to_connect");
}
return FALSE;
}
if( ! $this->_login()) {
if($this->debug === TRUE) {
$this->_error("ftp_unable_to_login");
}
return FALSE;
}
if($this->passive === TRUE) {
ftp_pasv($this->conn_id, TRUE);
}
return TRUE;
}
/**
* 目錄改變
*
* @access public
* @param string 目錄標識(ftp)
* @param boolean
* @return boolean
*/
public function chgdir($path = '', $supress_debug = FALSE) {
if($path == '' OR ! $this->_isconn()) {
return FALSE;
}
$result = @ftp_chdir($this->conn_id, $path);
if($result === FALSE) {
if($this->debug === TRUE AND $supress_debug == FALSE) {
$this->_error("ftp_unable_to_chgdir:dir[".$path."]");
}
return FALSE;
}
return TRUE;
}
/**
* 目錄生成
*
* @access public
* @param string 目錄標識(ftp)
* @param int 文件權限列表
* @return boolean
*/
public function mkdir($path = '', $permissions = NULL) {
if($path == '' OR ! $this->_isconn()) {
return FALSE;
}
$result = @ftp_mkdir($this->conn_id, $path);
if($result === FALSE) {
if($this->debug === TRUE) {
$this->_error("ftp_unable_to_mkdir:dir[".$path."]");
}
return FALSE;
}
if( ! is_null($permissions)) {
$this->chmod($path,(int)$permissions);
}
return TRUE;
}
/**
* 上傳
*
* @access public
* @param string 本地目錄標識
* @param string 遠程目錄標識(ftp)
* @param string 上傳模式 auto || ascii
* @param int 上傳後的文件權限列表
* @return boolean
*/
public function upload($localpath, $remotepath, $mode = 'auto', $permissions = NULL) {
if( ! $this->_isconn()) {
return FALSE;
}
if( ! file_exists($localpath)) {
if($this->debug === TRUE) {
$this->_error("ftp_no_source_file:".$localpath);
}
return FALSE;
}
if($mode == 'auto') {
$ext = $this->_getext($localpath);
$mode = $this->_settype($ext);
}
$mode = ($mode == 'ascii') ? FTP_ASCII : FTP_BINARY;
$result = @ftp_put($this->conn_id, $remotepath, $localpath, $mode);
if($result === FALSE) {
if($this->debug === TRUE) {
$this->_error("ftp_unable_to_upload:localpath[".$localpath."]/remotepath[".$remotepath."]");
}
return FALSE;
}
if( ! is_null($permissions)) {
$this->chmod($remotepath,(int)$permissions);
}
return TRUE;
}
/**
* 下載
*
* @access public
* @param string 遠程目錄標識(ftp)
* @param string 本地目錄標識
* @param string 下載模式 auto || ascii
* @return boolean
*/
public function download($remotepath, $localpath, $mode = 'auto') {
if( ! $this->_isconn()) {
return FALSE;
}
if($mode == 'auto') {
$ext = $this->_getext($remotepath);
$mode = $this->_settype($ext);
}
$mode = ($mode == 'ascii') ? FTP_ASCII : FTP_BINARY;
$result = @ftp_get($this->conn_id, $localpath, $remotepath, $mode);
if($result === FALSE) {
if($this->debug === TRUE) {
$this->_error("ftp_unable_to_download:localpath[".$localpath."]-remotepath[".$remotepath."]");
}
return FALSE;
}
return TRUE;
}
/**
* 重命名/移動
*
* @access public
* @param string 遠程目錄標識(ftp)
* @param string 新目錄標識
* @param boolean 判斷是重命名(FALSE)還是移動(TRUE)
* @return boolean
*/
public function rename($oldname, $newname, $move = FALSE) {
if( ! $this->_isconn()) {
return FALSE;
}
$result = @ftp_rename($this->conn_id, $oldname, $newname);
if($result === FALSE) {
if($this->debug === TRUE) {
$msg = ($move == FALSE) ? "ftp_unable_to_rename" : "ftp_unable_to_move";
$this->_error($msg);
}
return FALSE;
}
return TRUE;
}
/**
* 刪除文件
*
* @access public
* @param string 文件標識(ftp)
* @return boolean
*/
public function delete_file($file) {
if( ! $this->_isconn()) {
return FALSE;
}
$result = @ftp_delete($this->conn_id, $file);
if($result === FALSE) {
if($this->debug === TRUE) {
$this->_error("ftp_unable_to_delete_file:file[".$file."]");
}
return FALSE;
}
return TRUE;
}
/**
* 刪除文件夾
*
* @access public
* @param string 目錄標識(ftp)
* @return boolean
*/
public function delete_dir($path) {
if( ! $this->_isconn()) {
return FALSE;
}
//對目錄宏的'/'字符添加反斜槓'\'
$path = preg_replace("/(.+?)\/*$/", "\\1/", $path);
//獲取目錄文件列表
$filelist = $this->filelist($path);
if($filelist !== FALSE AND count($filelist) > 0) {
foreach($filelist as $item) {
//如果我們無法刪除,那麼就可能是一個文件夾
//所以我們遞歸調用delete_dir()
if( ! @delete_file($item)) {
$this->delete_dir($item);
}
}
}
//刪除文件夾(空文件夾)
$result = @ftp_rmdir($this->conn_id, $path);
if($result === FALSE) {
if($this->debug === TRUE) {
$this->_error("ftp_unable_to_delete_dir:dir[".$path."]");
}
return FALSE;
}
return TRUE;
}
/**
* 修改文件權限
*
* @access public
* @param string 目錄標識(ftp)
* @return boolean
*/
public function chmod($path, $perm) {
if( ! $this->_isconn()) {
return FALSE;
}
//只有在PHP5中才定義了修改權限的函數(ftp)
if( ! function_exists('ftp_chmod')) {
if($this->debug === TRUE) {
$this->_error("ftp_unable_to_chmod(function)");
}
return FALSE;
}
$result = @ftp_chmod($this->conn_id, $perm, $path);
if($result === FALSE) {
if($this->debug === TRUE) {
$this->_error("ftp_unable_to_chmod:path[".$path."]-chmod[".$perm."]");
}
return FALSE;
}
return TRUE;
}
/**
* 獲取目錄文件列表
*
* @access public
* @param string 目錄標識(ftp)
* @return array
*/
public function filelist($path = '.') {
if( ! $this->_isconn()) {
return FALSE;
}
return ftp_nlist($this->conn_id, $path);
}
/**
* 關閉FTP
*
* @access public
* @return boolean
*/
public function close() {
if( ! $this->_isconn()) {
return FALSE;
}
return @ftp_close($this->conn_id);
}
/**
* FTP成員變量初始化
*
* @access private
* @param array 配置數組
* @return void
*/
private function _init($config = array()) {
foreach($config as $key => $val) {
if(isset($this->$key)) {
$this->$key = $val;
}
}
//特殊字符過濾
$this->hostname = preg_replace('|.+?://|','',$this->hostname);
}
/**
* FTP登陸
*
* @access private
* @return boolean
*/
private function _login() {
return @ftp_login($this->conn_id, $this->username, $this->password);
}
/**
* 判斷con_id
*
* @access private
* @return boolean
*/
private function _isconn() {
if( ! is_resource($this->conn_id)) {
if($this->debug === TRUE) {
$this->_error("ftp_no_connection");
}
return FALSE;
}
return TRUE;
}
/**
* 從文件名中獲取後綴擴展
*
* @access private
* @param string 目錄標識
* @return string
*/
private function _getext($filename) {
if(FALSE === strpos($filename, '.')) {
return 'txt';
}
$extarr = explode('.', $filename);
return end($extarr);
}
/**
* 從後綴擴展定義FTP傳輸模式 ascii 或 binary
*
* @access private
* @param string 後綴擴展
* @return string
*/
private function _settype($ext) {
$text_type = array (
'txt',
'text',
'php',
'phps',
'php4',
'js',
'css',
'htm',
'html',
'phtml',
'shtml',
'log',
'xml'
);
return (in_array($ext, $text_type)) ? 'ascii' : 'binary';
}
/**
* 錯誤日志記錄
*
* @access prvate
* @return boolean
*/
private function _error($msg) {
return @file_put_contents('ftp_err.log', "date[".date("Y-m-d H:i:s")."]-hostname[".$this->hostname."]-username[".$this->username."]-password[".$this->password."]-msg[".$msg."]\n", FILE_APPEND);
}
}
/*End of file ftp.php*/
/*Location /Apache Group/htdocs/ftp.php*/
DEMO
復制代碼 代碼如下:
<?php
require_once('ftp.php');
$config = array(
'hostname' => 'localhost',
'username' => 'root',
'password' => 'root',
'port' => 21
);
$ftp = new Ftp();
$ftp->connect($config);
$ftp->upload('ftp_err.log','ftp_upload.log');
$ftp->download('ftp_upload.log','ftp_download.log');
/*End of file ftp_demo.php*/
/*Location: /htdocs/ftp_demo.php*/