深入PHP FTP类的详解


Posted in PHP onJune 13, 2013

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*/

PHP 相关文章推荐
多数据表共用一个页的新闻发布
Oct 09 PHP
用PHP 快速生成 Flash 动画的方法
Mar 06 PHP
php下检测字符串是否是utf8编码的代码
Jun 28 PHP
PHP表单提交表单名称含有点号(.)则会被转化为下划线(_)
Dec 14 PHP
深入php中var_dump方法的使用详解
Jun 24 PHP
Fedora下安装php Redis扩展笔记
Sep 03 PHP
PHP借助phpmailer发送邮件
May 11 PHP
php使用Session和文件统计在线人数
Jul 04 PHP
PHP编程开发怎么提高编程效率 提高PHP编程技术
Nov 09 PHP
Yii模型操作之criteria查找数据库的方法
Jul 15 PHP
PHP中STDCLASS用法实例分析
Nov 11 PHP
网站被恶意镜像怎么办 php一段代码轻松搞定(全面版)
Oct 23 PHP
PHP代码审核的详细介绍
Jun 13 #PHP
PHP设计模式之调解者模式的深入解析
Jun 13 #PHP
PHP设计模式之迭代器模式的深入解析
Jun 13 #PHP
PHP设计模式之解释器模式的深入解析
Jun 13 #PHP
PHP设计模式之代理模式的深入解析
Jun 13 #PHP
PHP设计模式之责任链模式的深入解析
Jun 13 #PHP
PHP设计模式之结构模式的深入解析
Jun 13 #PHP
You might like
关于我转生变成史莱姆这档事:第二季PV上线,萌王2021年回归
2020/05/06 日漫
社区(php&amp;&amp;mysql)二
2006/10/09 PHP
基于php冒泡排序算法的深入理解
2013/06/09 PHP
Laravel 4.2 中队列服务(queue)使用感受
2014/10/30 PHP
laravel 5 实现模板主题功能(续)
2015/03/02 PHP
Linux系统中为php添加pcntl扩展
2016/08/28 PHP
Zend Framework分发器用法示例
2016/12/11 PHP
laravel 操作数据库常用函数的返回值方法
2019/10/11 PHP
PHP+fiddler抓包采集微信文章阅读数点赞数的思路详解
2019/12/20 PHP
PHP中-&gt;和=&gt;的含义及使用示例解析
2020/08/06 PHP
基于JQuery的asp.net树实现代码
2010/11/30 Javascript
jQuery1.6 正式版发布并提供下载
2011/05/05 Javascript
jQuery的Ajax的自动完成功能控件简要说明
2013/02/22 Javascript
通过onmouseover选项卡实现img图片的变化
2014/02/12 Javascript
优化Node.js Web应用运行速度的10个技巧
2014/09/03 Javascript
AngularJS基础 ng-non-bindable 指令详细介绍
2016/08/02 Javascript
angularjs性能优化的方法
2018/09/05 Javascript
vue axios 简单封装以及思考
2018/10/09 Javascript
[01:11:10]2014 DOTA2华西杯精英邀请赛 5 24 iG VS VG加赛
2014/05/26 DOTA
python实现从一组颜色中找出与给定颜色最接近颜色的方法
2015/03/19 Python
在Django中输出matplotlib生成的图片方法
2018/05/24 Python
Linux系统(CentOS)下python2.7.10安装
2018/09/26 Python
Python 通过requests实现腾讯新闻抓取爬虫的方法
2019/02/22 Python
基于腾讯云服务器部署微信小程序后台服务(Python+Django)
2019/05/08 Python
Python实现Mysql数据统计及numpy统计函数
2019/07/15 Python
Django多数据库的实现过程详解
2019/08/01 Python
详解在python操作数据库中游标的使用方法
2019/11/12 Python
Python中openpyxl实现vlookup函数的实例
2020/10/28 Python
详解CSS3中使用gradient实现渐变效果的方法
2015/08/18 HTML / CSS
丝芙兰波兰:Sephora.pl
2018/03/25 全球购物
拉夫劳伦爱尔兰官方网站:Ralph Lauren爱尔兰
2020/04/10 全球购物
员工培训心得体会
2013/12/30 职场文书
上课玩手机检讨书
2014/02/08 职场文书
中国梦口号
2014/06/13 职场文书
导游词之南京栖霞山
2019/10/18 职场文书
Jupyter notebook 更改文件打开的默认路径操作
2021/05/21 Python