深入PHP FTP类的详解

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复制代码代码如下: < ? phprequire_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*/


版权声明: 此文为本站源创文章[或由本站编辑从网络整理改编],
转载请备注出处:
[狂码一生] https://www.sindsun.com/articles/8/39
[若此文确切存在侵权,请联系本站管理员进行删除!]


--THE END--