PHP 之ftp客户端类封装实现

<?php
/**
 * Class FtpClient
 */
class FtpClient
{
    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 string $mode 上传模式(ascii和binary其中之一)
     * @param null $permissions 文件夹权限
     * @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($remote_file = '')
    {
        $result = @ftp_delete($this->conn, $remote_file);
        if ($result === FALSE) {
            return FALSE;
        }
        return TRUE;
    }

    /**
     * ftp创建多级目录
     * @param string $remote_file 要上传的远程图片地址
     * @param null $permissions 修改目录权限
     */
    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目录地址
     * @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;
    }

    /**
     *
     * @param string $remote_path
     */
    /**
     * 列出ftp指定目录
     * @param string $remote_path 服务器上的路径
     * @return array
     */
    public function list_file($remote_path = '')
    {
        $contents = @ftp_nlist($this->conn, $remote_path);
        return $contents;
    }
    /**
     * 获取文件的后缀名
     * @param string $local_file 本地文件
     * @return bool|string
     */
    private function _get_ext($local_file = '')
    {
        return (($dot = strrpos($local_file, '.')) == FALSE) ? 'txt' : substr($local_file, $dot + 1);
    }

    /**
     * 根据文件后缀获取上传编码
     * @param string $ext
     * @return string
     */
    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 权限值
     * @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;
    }
}