php通过ftp上传文件

条件：

利用php -m 查看是否有开启ftp扩展（没有则 利用php --ini 查看php.ini路径 开启ftp扩展 php_ftp）

使用方法：

<?php
/**
 * 1.利用php -m 查看是否有开启ftp扩展
 * 2.利用php --ini 查看php.ini文化路径
 * 3.开启ftp扩展 php_ftp
 */

require './ftp.php';//加载ftp文件

$config = [
    'host'=>'127.0.0.1',//ftp地址
    'user'=>'root',//账户
    'pass'=>'root',//密码
    'port'=>21,//端口
];
$ftp =  new Ftp($config);//实例化对象

$result =$ftp->connect();//连接服务器
if ( ! $result){
    echo $ftp->get_error_msg();//获取链接错误
}

$local_file = 'test.txt';//本地文件地址
$remote_file = date('Y-m').'/text.txt';//上传的目录文件地址


//例子如下：
// //上传文件
if ($ftp->upload($local_file,$remote_file)){
    echo "上传成功";
}else{
     echo "上传失败";
}



// //删除整个目录
 $remote_path=date('Y-m');
 if ($ftp->delete_dir($remote_path)){
     echo "目录删除成功";
 }else{
     echo "目录删除失败";
 }



// //下载文件
$local_file2 = 'index.html';
$remote_file2='index.html';
if ($ftp->download($local_file2,$remote_file2)){
    echo "下载成功";
}else{
    echo "下载失败";
}


//移动文件|重命名文件
 $local_file3 = 'indexs.html';
 $remote_file3='index.html';
if ($ftp->remane($local_file3,$remote_file3)){
    echo "移动成功";
}else{
    echo "移动失败";
 }

$ftp->close();//关闭连接

类库文件：ftp.php

 <?php
/**
 * Created by PhpStorm.
 * User: 123456
 * Date: 2018/9/20
 * Time: 11:15
 * @author sunjiaqiang
 * @email 1366017911@qq.com
 */
class Ftp
{
    private $host  = ''; //远程服务器地址
    private $user  = ''; //ftp用户名
    private $pass  = ''; //ftp密码
    private $port  = 21; //ftp登录端口
    private $error = ''; //最后失败时的错误信息
    protected $conn; //ftp登录资源

    /**
     * 可以在实例化类的时候配置数据，也可以在下面的connect方法中配置数据
     * Ftp constructor.
     * @param array $config
     */
    public function __construct(array $config = [])
    {
        empty($config) or $this->initialize($config);
    }

    /**
     * 初始化数据
     * @param array $config 配置文件数组
     */
    public function initialize(array $config = [])
    {
        $this->host = $config['host'];
        $this->user = $config['user'];
        $this->pass = $config['pass'];
        $this->port = isset($config['port']) ?: 21;
    }

    /**
     * 连接及登录ftp
     * @param array $config 配置文件数组
     * @return bool
     */
    public function connect(array $config = [])
    {
        empty($config) or $this->initialize($config);
        if (false == ($this->conn = @ftp_connect($this->host))) {
            $this->error = "主机连接失败";
            return false;
        }
        if (!$this->_login()) {
            $this->error = "服务器登录失败";
            return false;
        }
        return true;
    }

    /**
     * 上传文件到ftp服务器
     * @param string $local_file 本地文件路径
     * @param string $remote_file 服务器文件地址
     * @param bool $permissions 文件夹权限
     * @param string $mode 上传模式(ascii和binary其中之一)
     */
    public function upload($local_file = '', $remote_file = '', $mode = 'auto', $permissions = null)
    {
        if (!file_exists($local_file)) {
            $this->error = "本地文件不存在";
            return false;
        }
        if ($mode == 'auto') {
            $ext  = $this->_get_ext($local_file);
            $mode = $this->_set_type($ext);
        }
        //创建文件夹
        $this->_create_remote_dir($remote_file);
        $mode   = ($mode == 'ascii') ? FTP_ASCII : FTP_BINARY;
        $result = @ftp_put($this->conn, $remote_file, $local_file, $mode); //同步上传
        if ($result === false) {
            $this->error = "文件上传失败";
            return false;
        }
        return true;
    }

    /**
     * 从ftp服务器下载文件到本地
     * @param string $local_file 本地文件地址
     * @param string $remote_file 远程文件地址
     * @param string $mode 上传模式(ascii和binary其中之一)
     */
    public function download($local_file = '', $remote_file = '', $mode = 'auto')
    {
        if ($mode == 'auto') {
            $ext  = $this->_get_ext($remote_file);
            $mode = $this->_set_type($ext);
        }
        $mode   = ($mode == 'ascii') ? FTP_ASCII : FTP_BINARY;
        $result = @ftp_get($this->conn, $local_file, $remote_file, $mode);
        if ($result === false) {
            return false;
        }
        return true;
    }

    /**
     * 删除ftp服务器端文件
     * @param string $remote_file 文件地址
     */
    public function delete_file(string $remote_file = '')
    {
        $result = @ftp_delete($this->conn, $remote_file);
        if ($result === false) {
            return false;
        }
        return true;
    }
    /**
     * ftp创建多级目录
     * @param string $remote_file 要上传的远程图片地址
     */
    private function _create_remote_dir($remote_file = '', $permissions = null)
    {
        $remote_dir = dirname($remote_file);
        $path_arr   = explode('/', $remote_dir); // 取目录数组
        //$file_name = array_pop($path_arr); // 弹出文件名
        $path_div = count($path_arr); // 取层数
        foreach ($path_arr as $val) // 创建目录
        {
            if (@ftp_chdir($this->conn, $val) == false) {
                $tmp = @ftp_mkdir($this->conn, $val); //此处创建目录时不用使用绝对路径(不要使用:2018-02-20/ceshi/ceshi2，这种路径)，因为下面ftp_chdir已经已经把目录切换成当前目录
                if ($tmp == false) {
                    echo "目录创建失败，请检查权限及路径是否正确！";
                    exit;
                }
                if ($permissions !== null) {
                    //修改目录权限
                    $this->_chmod($val, $permissions);
                }
                @ftp_chdir($this->conn, $val);
            }
        }

        for ($i = 0; $i < $path_div; $i++) // 回退到根,因为上面的目录切换导致当前目录不在根目录
        {
            @ftp_cdup($this->conn);
        }
    }

    /**
     * 递归删除ftp端目录
     * @param string $remote_dir ftp目录地址
     */
    public function delete_dir(string $remote_dir = '')
    {
        $list = $this->list_file($remote_dir);
        if (!empty($list)) {
            $count = count($list);
            for ($i = 0; $i < $count; $i++) {
                if (!preg_match('#\.#', $list[$i]) && !@ftp_delete($this->conn, $list[$i])) {
                    //这是一个目录，递归删除
                    $this->delete_dir($list[$i]);
                } else {
                    $this->delete_file($list[$i]);
                }
            }
        }
        if (@ftp_rmdir($this->conn, $remote_dir) === false) {
            return false;
        }
        return true;
    }

    /**
     * 更改 FTP 服务器上的文件或目录名
     * @param string $old_file 旧文件/文件夹名
     * @param string $new_file 新文件/文件夹名
     */
    public function remane(string $old_file = '', string $new_file = '')
    {
        $result = @ftp_rename($this->conn, $old_file, $new_file);
        if ($result === false) {
            $this->error = "移动失败";
            return false;
        }
        return true;
    }

    /**
     * 列出ftp指定目录
     * @param string $remote_path
     */
    public function list_file(string $remote_path = '')
    {
        $contents = @ftp_nlist($this->conn, $remote_path);
        return $contents;
    }

    /**
     * 获取文件的后缀名
     * @param string $local_file
     */
    private function _get_ext($local_file = '')
    {
        return (($dot = strrpos($local_file, '.')) == false) ? 'txt' : substr($local_file, $dot + 1);
    }

    /**
     * 根据文件后缀获取上传编码
     * @param string $ext
     */
    private function _set_type($ext = '')
    {
        //如果传输的文件是文本文件，可以使用ASCII模式，如果不是文本文件，最好使用BINARY模式传输。
        return in_array($ext, ['txt', 'text', 'php', 'phps', 'php4', 'js', 'css', 'htm', 'html', 'phtml', 'shtml', 'log', 'xml'], true) ? 'ascii' : 'binary';
    }

    /**
     * 修改目录权限
     * @param $path 目录路径
     * @param int $mode 权限值
     */
    private function _chmod($path, $mode = 0755)
    {
        if (false == @ftp_chmod($this->conn, $path, $mode)) {
            return false;
        }
        return true;
    }

    /**
     * 登录Ftp服务器
     */
    private function _login()
    {
        return @ftp_login($this->conn, $this->user, $this->pass);
    }

    /**
     * 获取上传错误信息
     */
    public function get_error_msg()
    {
        return $this->error;
    }
/**
 * 关闭ftp连接
 * @return bool
 */
    public function close()
    {
        return $this->conn ? @ftp_close($this->conn_id) : false;
    }
}

FTP协议

FTP的中文名称是“文件传输协议”，是File Transfer Protocol三个英文单词的缩写。FTP协议是TCP/IP协议组中的协议之一，其传输效率非常高，在网络上传输大的文件时，经常采用该协议。
FTP协议有分主动模式和被动模式，有关介绍可以看这里，本文不做过多介绍。

三种方式

废话不多说，直接先上结果。
三种方式实现Qt项目中的Ftp传输功能：
1、Qt4 QFtp
2、Qt5 QNetworkAccessManager
3、POCO中的 FTPClientSession

接下来我们一一分析这几种方式的优缺点。

QFtp

先来说说QFtp，QFtp是Qt4中的专门负责Ftp传输的类，Ftp相关的常用接口都已经包含了，比如说：创建目录、删除目录、删除文件、获取文件列表、上传、下载等等常规操作。

	int setProxy(const QString &host, quint16 port);
    int connectToHost(const QString &host, quint16 port=21);
    int login(const QString &user = QString(), const QString &password = QString());
    int close();
    int setTransferMode(TransferMode mode);
    int list(const QString &dir = QString());
    int cd(const QString &dir);
    int get(const QString &file, QIODevice *dev=0, TransferType type = Binary);
    int put(const QByteArray &data, const QString &file, TransferType type = Binary);
    int put(QIODevice *dev, const QString &file, TransferType type = Binary);
    int remove(const QString &file);
    int mkdir(const QString &dir);
    int rmdir(const QString &dir);
    int rename(const QString &oldname, const QString &newname);

光看名字就知道其功能了，可以说是很全面的了。但不行的是这么好用的东西竟然被Qt5给抛弃了，取而代之的是用 QNetworkAccessManager 来实现。

QNetworkAccessManager

QNetworkAccessManager 是Qt里面专门负责网络请求的模块，包含了http的post、get，还有一个put，而Qt5中要实现Ftp上传功能就通过put来完成，下载通过get来完成。

 QNetworkReply *put(const QNetworkRequest &request, QIODevice *data)
 QNetworkReply *put(const QNetworkRequest &request, const QByteArray &data)
 QNetworkReply *put(const QNetworkRequest &request, QHttpMultiPart *multiPart)

 QNetworkReply *get(const QNetworkRequest &request)

遗憾的是，没有办法通过QNetworkAccessManager 实现Ftp创建目录、删除目录、删除文件、获取文件列表等功能。只能做上传下载操作。

FTPClientSession

最后来看FTPClientSession，这是POCO中网络模块里面负责实现FTP的类，POCO是目前最流行的C++轻量级封装库之一，里面包含了很多常用的封装库。

关于poco的安装见这里

而FTPClientSession提供了FTP的很多常用接口，如下：

	void setTimeout(const Poco::Timespan& timeout);
	Poco::Timespan getTimeout() const;
	void setPassive(bool flag, bool useRFC1738 = true);
	bool getPassive() const;
	virtual void open(const std::string& host, Poco::UInt16 port, const std::string& username = "", const std::string& password = "");
	virtual void login(const std::string& username, const std::string& password);
	void logout();
	void close();
	std::string systemType();
	void setFileType(FileType type);
	FileType getFileType() const;
	void setWorkingDirectory(const std::string& path);
	std::string getWorkingDirectory();
	void cdup();
	void rename(const std::string& oldName, const std::string& newName);
	void remove(const std::string& path);
	void createDirectory(const std::string& path);
	void removeDirectory(const std::string& path);
	std::istream& beginDownload(const std::string& path);
	void endDownload();
	std::ostream& beginUpload(const std::string& path);
	void endUpload();
	std::istream& beginList(const std::string& path = "", bool extended = false);
	void endList();
	void abort();
	int sendCommand(const std::string& command, std::string& response);
	int sendCommand(const std::string& command, const std::string& arg, std::string& response);
	bool isOpen() const;
	bool isLoggedIn() const;
	bool isSecure() const;
	const std::string& welcomeMessage();

可以看到，FTPClientSession提供的这些接口基本包含了所有的Ftp上传的需求。

以上三种方式都可以实现FTP的上传，但是这三种各有各的优缺点，本人在使用过程中遇到了各种各样的问题，这三种都有结合使用，那么，接下来整理一下这段时间在使用这三种方式的区别和优缺点。

三者区别

QFtp

首先来看QFtp，由于在Qt5中已经移除了该模块，所以如果要使用它的话就需要自己下载源码进行编译，还要解决各种编码问题，其实挺麻烦的。

优点：接口完整，而且使用方便，该有的接口都有
缺点：要自己编译源码，或者可以直接使用源码嵌入到项目中，然后要解决编码问题；对于异常处理不是太好，比如突然断网，收不到异常信号，也不会报错，甚至连接状态都不会改变，联网后不能继续上传，会一直假死，这种情况下处理异常就很不友好了，需要自己去解决这个问题。

QNetworkAccessManager

优点：简单，集成度高；对于异常的处理比较友好，比如断网后，会立马收到信号反馈，用户可以及时去处理剩下的任务，而且在超时时间内如果连接上网络后可以继续接着上一次的任务进行上传，这一点非常好，给开发省了不少事情。

缺点：太过于简单了，很多接口都没有，就只能做个上传下载，不能创建文件夹、删除文件等操作。

FTPClientSession

优点：使用简单，而且基本ftp的基本操作接口都有提供，对异常处理可以抛出异常，通过try catch进行捕捉，比如说删除不存在的文件夹、创建已存在的文件夹等，这些操作会直接导致程序崩溃退出，需要捕捉异常去处理；
缺点：没有提供上传下载进度的接口或回调，如果需要展示进度功能的话，就很麻烦了，需要自己计算上传了多少字节，还剩多少字节。对网络异常的处理也不是很友好，毕竟不能像Qt那样直接发信号通知。
另外，FTPClientSession可以通过beginList接口获取服务器上的文件列表，然后通过读取流的方式得到列表内容，但是如果文件名称中带有空格，那么获取到的文件名就会分开了，不是完整的文件名，比如，有个文件名叫 “abc 12 ed.mp3” ,通过流读取到的内容是 “abc” , “12” , “ed.mp3” ，这样读取文件列表就会有很大的问题了。而通过QFtp读取文件列表就是正常的。

还有一个非常重要的问题，FTP上传的数据有两种方式，一种是ASCII码上传，一种是通过二进制数据上传，这两种方式上传会影响上传后的文件大小，而据说QNetworkAccessManager 默认是通过二进制流上传，但是上传后文件大小变了，具体问题可以看这里，就是因为上传方式导致的，而QNetworkAccessManager 是不能修改上传方式的，这个问题比较严重了。QFtp和FTPClientSession都提供了上传方式的修改，从这一点上来说，QNetworkAccessManager 就很不适合了。

就我个人使用这三种方式的经验来看，QFtp是比较更适合的，能够满足使用需求，不过需要自己处理一些异常情况。

本篇只是简单介绍这三种方式优缺点，接下来会在后期的文章中单独列举demo展示如何使用。以及在实际的代码中遇到的各种各样的坑。