一个非常实用简单的FTP上传类

用了好几个项目的FTP类

class Ftp
{
    // FTP服务器地址
    private $host = '';
    // FTP 用户名
    private $user = '';
    // FTP 密码
    private $pass = '';
    // FTP 登录端口
    private $port = 21;
    // 最后失败时的错误信息
    private $error = '';
    // FTP 登录资源
    protected $conn;

    /**
     * 可以在实例化类的时候配置数据，也可以在下面的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其中之一)
     * @return bool
     */
    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其中之一)
     * @return bool
     */
    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 文件地址
     * @return bool
     */
    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 要上传的远程图片地址
     * @param string $permissions
     * @return mixed
     */
    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) {
                // 此处创建目录时不用使用绝对路径(不要使用:2018-02-20/ceshi/ceshi2，这种路径)
                // 因为下面ftp_chdir已经已经把目录切换成当前目录
                $tmp = @ftp_mkdir($this->conn, $val);
                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目录地址
     * @return bool
     */
    public function delete_dir($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 新文件/文件夹名
     * @return bool
     */
    public function remane($old_file = '', $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
     * @return mixed
     */
    public function list_file($remote_path = '')
    {
        $contents = @ftp_nlist($this->conn, $remote_path);
        return $contents;
    }

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

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

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

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

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