用PHP實現一個FTP客戶端

php具有很好的擴展性，在php中對于ftp文件的上傳也是內置功能，和其他語言一樣，只能實現的是客戶端。

class FtpClient {
   /**
     * 上傳文件根目錄
     * @var string
     */
    private $rootPath;

    /**
     * 本地上傳錯誤信息
     * @var string
     */
    private $error = ''; //上傳錯誤信息

    /**
     * FTP連接
     * @var resource
     */
    private $link;

    private $config = array(
        'host'     => '', //服務器
        'port'     => 21, //端口
        'timeout'  => 90, //超時時間
        'username' => '', //用戶名
        'password' => '', //密碼
    );

    /**
     * 構造函數，用于設置上傳根路徑
     * @param array  $config FTP配置
     */
    public function __construct($config){
        /* 默認FTP配置 */
        $this->config = array_merge($this->config, $config);

        /* 登錄FTP服務器 */
        if(!$this->login()){
            E($this->error);
        }
    }

    /**
     * 檢測上傳根目錄
     * @param string $rootpath   根目錄
     * @return boolean true-檢測通過，false-檢測失敗
     */
    public function checkRootPath($rootpath){
        /* 設置根目錄 */
        $this->rootPath = ftp_pwd($this->link) . '/' . ltrim($rootpath, '/');

        if(!@ftp_chdir($this->link, $this->rootPath)){
            $this->error = '上傳根目錄不存在！';
            return false;
        }
        return true;
    }

    /**
     * 檢測上傳目錄
     * @param  string $savepath 上傳目錄
     * @return boolean          檢測結果，true-通過，false-失敗
     */
    public function checkSavePath($savepath){
        /* 檢測并創建目錄 */
        if (!$this->mkdir($savepath)) {
            return false;
        } else {
            //TODO:檢測目錄是否可寫
            return true;
        }
    }

    /**
     * 保存指定文件
     * @param  array   $file    保存的文件信息
     * @param  boolean $replace 同名文件是否覆蓋
     * @return boolean          保存狀態，true-成功，false-失敗
     */
    public function save($file, $replace=true) {
        $filename = $this->rootPath . $file['savepath'] . $file['savename'];

        /* 不覆蓋同名文件 */
        // if (!$replace && is_file($filename)) {
        //     $this->error = '存在同名文件' . $file['savename'];
        //     return false;
        // }

        /* 移動文件 */
        if (!ftp_put($this->link, $filename, $file['tmp_name'], FTP_BINARY)) {
            $this->error = '文件上傳保存錯誤！';
            return false;
        }
        return true;
    }

    /**
     * 創建目錄
     * @param  string $savepath 要創建的穆里
     * @return boolean          創建狀態，true-成功，false-失敗
     */
    public function mkdir($savepath){
        $dir = $this->rootPath . $savepath;
        if(ftp_chdir($this->link, $dir)){
            return true;
        }

        if(ftp_mkdir($this->link, $dir)){
            return true;
        } elseif($this->mkdir(dirname($savepath)) && ftp_mkdir($this->link, $dir)) {
            return true;
        } else {
            $this->error = "目錄 {$savepath} 創建失敗！";
            return false;
        }
    }
    /**
     * 創建目錄
     * @param  string $file     目標文件或者目錄
     * @return real          文件大小或者-1
     */
    public function filesize($file)
    {
        return @ftp_size($this->link,$file);
    }

    /**
     * 獲取最后一次上傳錯誤信息
     * @return string 錯誤信息
     */
    public function getError(){
        return $this->error;
    }
    /**
     * 給文件或者目錄授權
     * @param String $file 文件或者路徑
     * @param $mode 八進制權限值 1- 執行權限，2-寫權限，4 - 讀權限  0644->所有者可讀寫，其他人可讀
     * @return 設置成功的新權限或者失敗時false
     */
    public function chmod($file,$mode)
    {
        if(!ftp_chmod(($this->link,$mode,$file))
        {
            $this->error = '授權失敗';
        }
    }
    /**
     * @param string  path  必需。規定要刪除的文件的路徑
     * @return true or false 
     */
    public function delete($path)
    {
        if (!ftp_delete($this->link, $path)) {
           $this->error ='刪除文件：'.$path.' 失敗';
        }
    }

    /**
     * @param string local  必需。本地文件存儲路徑
     * @param string remote  必需。遠程文件路徑
     * @param string mode  必需。讀取模式
     * @param string resume  讀取文件大小的起始位置
     * @return true or false 
     */
    public function fetch($local,$remote,$mode,$resume=0)
    {
        $arr_mode = array(FTP_ASCII,FTP_BINARY);
        if(!in_array($mode, $arr_mode))
        {
            $mode = FTP_BINARY;
        }
        if(!ftp_get($this->link,$local,$remote,$mode,$resume))
        {
            $this->error ='讀取遠程文件：'.$remote.' 失敗';
        }
    }

    /**
     * 登錄到FTP服務器
     * @return boolean true-登錄成功，false-登錄失敗
     */
    private function login(){
        extract($this->config);
        $this->link = ftp_connect($host, $port, $timeout);
        if($this->link) {
            if (ftp_login($this->link, $username, $password)) {
               return true;
            } else {
                $this->error = "無法登錄到FTP服務器：username - {$username}";
            }
        } else {
            $this->error = "無法連接到FTP服務器：{$host}";
        }
        return false;
    }

    /**
     * 析構方法，用于斷開當前FTP連接
     */
    public function __destruct() {
        ftp_close($this->link);
    }
}