PHP封装FastDFS操作类

 
    fastdfs_get_last_error_no(), 'info' => fastdfs_get_last_error_info(), 'act' => $act)
    
    private static $instance = null;
    
    private function __construct(){
        return true;
    }
    
    public function __destruct(){
        fastdfs_tracker_close_all_connections();
    }
 
    public static function getInstance( $group_name = '' ){
        if (self::$instance == null){
            self::$instance = new FDFS();
            
            if( !self::$instance->_loadTracker() ){
                return false;
            }
        }
        
        return self::$instance;
    }
    
    private function _loadTracker(){
        $this->_tracker = fastdfs_tracker_get_connection();
        if( !$this->_tracker ){
            return false;
        }
        if( !fastdfs_active_test($this->_tracker) ){
            $this->_setLastError('fastdfs_active_test(_tracker)');
            return false;
        }
        
        return true;
    }
    
    private function _setLastError( $act = '' ){
        $this->_error = array('no' => fastdfs_get_last_error_no(), 'info' => fastdfs_get_last_error_info(), 'act' => $act);
    }
    
    /**
     * 连接storage
     * @param string $group_name
     * @return boolean
     */
    public function storageConnection($group_name = ''){
        if( !isset($this->_storage_arr[$group_name]) ){
            $this->_storage_arr[$group_name] = fastdfs_tracker_query_storage_store($group_name, $this->_tracker);
            if( !$this->_storage_arr[$group_name] ){
                return false;
            }
    
            $server = fastdfs_connect_server($this->_storage_arr[$group_name]['ip_addr'], $this->_storage_arr[$group_name]['port']);
            if( !$server ){
                $this->_setLastError('fastdfs_connect_server(_storage)');
                return false;
            }
    
            if( !fastdfs_active_test($server) ){
                $this->_setLastError('fastdfs_active_test(server)');
                return false;
            }
            $this->_storage_arr[$group_name]['sock'] = $server['sock'];
            unset($server);
        }
    
        if( !isset($this->_storage_arr[$group_name]) ){
            $this->_group_name    = null;
            $this->_storage       = null;
            return false;
        }else{
            $this->_group_name    = $group_name;
            $this->_storage       = &$this->_storage_arr[$group_name];
        }
    
        return true;
    }
    
    /**
     * 上传文件
     * @param string $local_filename 本地文件路径
     * @param boolean $file_ext_name 文件后缀名
     * @param boolean $is_file_buff 是否是字符内容
     * @return boolean|array array('group_name' => '', 'filename' => '')
     */
    public function upload( $local_filename, $file_ext_name = null, $is_file_buff = false ){
        if($is_file_buff){
            $act = 'fastdfs_storage_upload_by_filebuff';
        }else{
            $act = 'fastdfs_storage_upload_by_filename';
        }
        $file_info = $act($local_filename, $file_ext_name, array(), null, $this->_tracker, $this->_storage);
        if( !$file_info ){
            $this->_setLastError($act.'('.$local_filename.')');
            return false;
        }
        
        return $file_info;
    }
    
    /**
     * 上传从文件
     * @param string $local_filename  本地文件路径
     * @param string $master_filename storage里的主文件路径
     * @param string $prefix_name 后缀
     * @param boolean $file_ext_name 文件后缀名
     * @param boolean $is_file_buff 是否是字符内容
     * @return boolean|array  array('group_name' => '', 'filename' => '')
     */
    public function uploadSlave( $local_filename, $master_filename, $prefix_name, $file_ext_name = null, $is_file_buff = false ){
        if($is_file_buff){
            $act = 'fastdfs_storage_upload_slave_by_filebuff';
        }else{
            $act = 'fastdfs_storage_upload_slave_by_filename';
        }
        $file_info = $act($local_filename, $this->_group_name, $master_filename, $prefix_name, $file_ext_name, array(), $this->_tracker, $this->_storage);
        if( !$file_info ){
            $this->_setLastError($act.'('.$local_filename.','.$master_filename.','.$prefix_name.')');
            return false;
        }
        
        return $file_info;
    }
    
    /**
     * 删除文件
     * @param string $group_name
     * @param string $filename
     */
    public function delete($group_name, $filename){
        return fastdfs_storage_delete_file($group_name, $filename);
    }
    
    /**
     * 下载文件
     * @param string $group_name
     * @param string $filename
     */
    public function down($group_name, $filename){
        $file_content = fastdfs_storage_download_file_to_buff($group_name, $filename);
        return $file_content;
    }
    
    public function exist($group_name, $filename){
        return fastdfs_storage_file_exist($group_name, $filename);
    }
    
    /**
     * 获取最后的错误信息
     */
    public function lastError(){
        if( !$this->_error ){
            $this->__setLastError();
        }
        return $this->_error;
    }
}
?>

 

<?php

/**
 * FastDFS client Class
 * @author Rebill.Ruan
 */
class FastDFS
{
    /**
     * FastDFS class constructor
     *
     * @param int $config_index use which config file, base 0. default is 0
     * @param bool $bMultiThread if in multi-thread, default is false
     */
    public function __construct($config_index = 0, $bMultiThread = false){}

    /**
     * get a connected tracker server
     * return array for success, false for error
     * the assoc array including elements: ip_addr, port and sock
     *
     * @return array|bool
     */
    public function tracker_get_connection(){}

    /**
     * connect to all tracker servers
     * return true for success, false for error
     *
     * @return bool
     */
    public function tracker_make_all_connections(){}

    /**
     * close all connections to the tracker servers
     * return true for success, false for error
     *
     * @return bool
     */
    public function tracker_close_all_connections(){}

    /**
     * send ACTIVE_TEST cmd to the server
     * return true for success, false for error
     *
     * @param array $server_info the assoc array including elements: ip_addr, port and sock, sock must be connected
     * @return bool
     */
    public function active_test(array $server_info){}

    /**
     * connect to the server
     * return array for success, false for error
     *
     * @param string $ip_addr the ip address of the server
     * @param int $port the port of the server
     * @return array|bool
     */
    public function connect_server($ip_addr, $port){}

    /**
     * disconnect from the server
     * return true for success, false for error
     *
     * @param array $server_info the assoc array including elements: ip_addr, port and sock
     * @return bool
     */
    public function disconnect_server(array $server_info){}

    /**
     * get group stat info
     * return index array for success, false for error, each group as a array element
     *
     * @param string $group_name the group name of the master file
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @return array|bool
     */
    public function tracker_list_groups($group_name='', $tracker_server=array()){}

    /**
     * get the storage server info to upload file
     * return assoc array for success, false for error. the assoc array including elements: ip_addr, port, sock and store_path_index
     *
     * @param string $group_name the group name of the master file
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @return array|bool
     */
    public function tracker_query_storage_store($group_name='', $tracker_server=array()){}

    /**
     * get the storage server list to upload file
     * return indexed storage server array for success, false for error.
     * each element is an ssoc array including elements: ip_addr, port, sock and store_path_index
     *
     * @param string $group_name the group name of the master file
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @return array|bool
     */
    public function tracker_query_storage_store_list($group_name='', $tracker_server=array()){}

    /**
     * get the storage server info to set metadata
     * return assoc array for success, false for error
     * the assoc array including elements: ip_addr, port and sock
     *
     * @param string $group_name the group name of the master file
     * @param string $remote_filename the filename on the storage server
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @return array|bool
     */
    public function tracker_query_storage_update($group_name, $remote_filename, $tracker_server=array()){}

    /**
     * get the storage server info to download file (or get metadata)
     * return assoc array for success, false for error
     * the assoc array including elements: ip_addr, port and sock
     *
     * @param string $group_name the group name of the master file
     * @param string $remote_filename the filename on the storage server
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @return array|bool
     */
    public function tracker_query_storage_fetch($group_name, $remote_filename, $tracker_server=array()){}

    /**
     * get the storage server list which can retrieve the file content or metadata
     * return index array for success, false for error.
     * each server as an array element
     *
     * @param string $group_name the group name of the master file
     * @param string $remote_filename the filename on the storage server
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @return array|bool
     */
    public function tracker_query_storage_list($group_name, $remote_filename, $tracker_server=array()){}

    /**
     * get the storage server info to set metadata
     * return assoc array for success, false for error
     * the assoc array including elements: ip_addr, port and sock
     *
     * @param string $file_id the file id of the file
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @return array|bool
     */
    public function tracker_query_storage_update1($file_id, $tracker_server=array()){}

    /**
     * get the storage server info to download file (or get metadata)
     * return assoc array for success, false for error
     * the assoc array including elements: ip_addr, port and sock
     *
     * @param string $file_id the file id of the file
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @return array|bool
     */
    public function tracker_query_storage_fetch1($file_id, $tracker_server=array()){}

    /**
     * get the storage server list which can retrieve the file content or metadata
     * return index array for success, false for error.
     * each server as an array element
     *
     * @param string $file_id
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @return array|bool
     */
    public function tracker_query_storage_list1($file_id, $tracker_server=array()){}

    /**
     * delete the storage server from the cluster
     * return true for success, false for error
     *
     * @param string $group_name the group name of the master file
     * @param string $storage_ip the ip address of the storage server to be deleted
     * @return bool
     */
    public function tracker_delete_storage($group_name, $storage_ip){}

    /**
     * upload local file to storage server
     * return assoc array for success, false for error.
     * the returned array includes elements: group_name and filename
     *
     * @param string $local_filename the local filename
     * @param string $file_ext_name the file extension name, do not include dot(.)
     * @param array $meta_list meta data assoc array, such as array('width'=>1024, 'height'=>768)
     * @param string $group_name specify the group name to store the file
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return array|bool
     */
    public function storage_upload_by_filename($local_filename, $file_ext_name='', $meta_list=array(), $group_name='', $tracker_server=array(), $storage_server=array()){}

    /**
     * upload local file to storage server
     * return file_id for success, false for error
     *
     * @param string $local_filename the local filename
     * @param string $file_ext_name the file extension name, do not include dot(.)
     * @param array $meta_list meta data assoc array, such as array('width'=>1024, 'height'=>768)
     * @param string $group_name specify the group name to store the file
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return string|bool
     */
    public function storage_upload_by_filename1($local_filename, $file_ext_name='', $meta_list=array(), $group_name='', $tracker_server=array(), $storage_server=array()){}

    /**
     * upload file buff to storage server
     * return array for success, false for error
     *
     * @param string $file_buff the file content
     * @param string $file_ext_name the file extension name, do not include dot(.)
     * @param array $meta_list meta data assoc array, such as array('width'=>1024, 'height'=>768)
     * @param string $group_name specify the group name to store the file
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return array|bool
     */
    public function storage_upload_by_filebuff($file_buff, $file_ext_name='', $meta_list=array(), $group_name='', $tracker_server=array(), $storage_server=array()){}

    /**
     * upload file buff to storage server
     * return file_id for success, false for error
     *
     * @param string $file_buff the file content
     * @param string $file_ext_name the file extension name, do not include dot(.)
     * @param array $meta_list meta data assoc array, such as array('width'=>1024, 'height'=>768)
     * @param string $group_name specify the group name to store the file
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return string|bool
     */
    public function storage_upload_by_filebuff1($file_buff, $file_ext_name='', $meta_list=array(), $group_name='', $tracker_server=array(), $storage_server=array()){}

    /**
     * upload file to storage server by callback
     * return assoc array for success, false for error.
     * the returned array includes elements: group_name and filename
     *
     * @param array $callback_array the callback assoc array, must have keys:
     *   callback  - the php callback function name callback function prototype as: function upload_file_callback($sock, $args)
     *   file_size - the file size
     *   args      - use argument for callback function
     * @param string $file_ext_name the file extension name, do not include dot(.)
     * @param array $meta_list meta data assoc array, such as array('width'=>1024, 'height'=>768)
     * @param string $group_name specify the group name to store the file
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return array|bool
     */
    public function storage_upload_by_callback(array $callback_array, $file_ext_name='', $meta_list=array(), $group_name='', $tracker_server=array(), $storage_server=array()){}

    /**
     * upload file to storage server by callback
     * return file_id  for success, false for error
     *
     * @param array $callback_array the callback assoc array, must have keys:
     *   callback  - the php callback function name callback function prototype as: function upload_file_callback($sock, $args)
     *   file_size - the file size
     *   args      - use argument for callback function
     * @param string $file_ext_name the file extension name, do not include dot(.)
     * @param array $meta_list meta data assoc array, such as array('width'=>1024, 'height'=>768)
     * @param string $group_name specify the group name to store the file
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return string|bool
     */
    public function storage_upload_by_callback1(array $callback_array, $file_ext_name='', $meta_list=array(), $group_name='', $tracker_server=array(), $storage_server=array()){}

    /**
     * append local file to the appender file of storage server
     * return string/array for success, false for error
     *
     * @param string $local_filename the local filename
     * @param string $group_name the the group name of appender file
     * @param string $appender_filename the appender filename
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return mixed
     */
    public function storage_append_by_filename($local_filename, $group_name, $appender_filename, $tracker_server=array(), $storage_server=array()){}

    /**
     * append local file to the appender file of storage server
     * return file_id for success, false for error
     *
     * @param string $local_filename the local filename
     * @param string $appender_file_id the appender file id
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return string|bool
     */
    public function storage_append_by_filename1($local_filename, $appender_file_id, $tracker_server=array(), $storage_server=array()){}

    /**
     * append file buff to the appender file of storage server
     * return array for success, false for error
     *
     * @param string $file_buff the file content
     * @param string $group_name the the group name of appender file
     * @param string $appender_filename the appender filename
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return array|bool
     */
    public function storage_append_by_filebuff($file_buff, $group_name, $appender_filename, $tracker_server=array(), $storage_server=array()){}

    /**
     * append file buff to the appender file of storage server
     * return file_id  for success, false for error
     *
     * @param string $file_buff the file content
     * @param string $appender_file_id the appender file id
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return string|bool
     */
    public function storage_append_by_filebuff1($file_buff, $appender_file_id, $tracker_server=array(), $storage_server=array()){}

    /**
     * append file to the appender file of storage server by callback
     * return array for success, false for error
     *
     * @param array $callback_array the callback assoc array, must have keys:
     *   callback  - the php callback function name callback function prototype as: function upload_file_callback($sock, $args)
     *   file_size - the file size
     *   args      - use argument for callback function
     * @param string $group_name the the group name of appender file
     * @param string $appender_filename the appender filename
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return array|bool
     */
    public function storage_append_by_callback(array $callback_array, $group_name, $appender_filename, $tracker_server=array(), $storage_server=array()){}

    /**
     * append file buff to the appender file of storage server
     * return file_id  for success, false for error
     *
     * @param array $callback_array the callback assoc array, must have keys:
     *   callback  - the php callback function name callback function prototype as: function upload_file_callback($sock, $args)
     *   file_size - the file size
     *   args      - use argument for callback function
     * @param string $appender_file_id the appender file id
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return string|bool
     */
    public function storage_append_by_callback1(array $callback_array, $appender_file_id, $tracker_server=array(), $storage_server=array()){}

    /**
     * modify appender file by local file
     * return true for success, false for error
     *
     * @param string $local_filename the local filename
     * @param string $group_name the the group name of appender file
     * @param string $appender_filename the appender filename
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return bool
     */
    public function storage_modify_by_filename($local_filename, $group_name, $appender_filename, $tracker_server=array(), $storage_server=array()){}

    /**
     * modify appender file by local file
     * return true for success, false for error
     *
     * @param string $local_filename the local filename
     * @param string $appender_file_id the appender file id
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return bool
     */
    public function storage_modify_by_filename1($local_filename, $appender_file_id, $tracker_server=array(), $storage_server=array()){}

    /**
     * modify appender file by file buff
     * return true for success, false for error
     *
     * @param string $file_buff the file content
     * @param string $group_name the the group name of appender file
     * @param string $appender_filename the appender filename
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return bool
     */
    public function storage_modify_by_filebuff($file_buff, $group_name, $appender_filename, $tracker_server=array(), $storage_server=array()){}

    /**
     * modify appender file by file buff
     * return true for success, false for error
     *
     * @param string $file_buff the file content
     * @param string $appender_file_id the appender file id
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return bool
     */
    public function storage_modify_by_filebuff1($file_buff, $appender_file_id, $tracker_server=array(), $storage_server=array()){}

    /**
     * modify appender file by callback
     * return true for success, false for error
     *
     * @param array $callback_array the callback assoc array, must have keys:
     *   callback  - the php callback function name callback function prototype as: function upload_file_callback($sock, $args)
     *   file_size - the file size
     *   args      - use argument for callback function
     * @param string $group_name the the group name of appender file
     * @param string $appender_filename the appender filename
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return bool
     */
    public function storage_modify_by_callback(array $callback_array, $group_name, $appender_filename, $tracker_server=array(), $storage_server=array()){}

    /**
     * modify appender file by callback
     * return true for success, false for error
     *
     * @param array $callback_array the callback assoc array, must have keys:
     *   callback  - the php callback function name callback function prototype as: function upload_file_callback($sock, $args)
     *   file_size - the file size
     *   args      - use argument for callback function
     * @param string $appender_file_id the appender file id
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return bool
     */
    public function storage_modify_by_callback1(array $callback_array, $appender_file_id, $tracker_server=array(), $storage_server=array()){}

    /**
     * upload local file to storage server as appender file
     * return assoc array for success, false for error.
     * the returned array includes elements: group_name and filename
     *
     * @param string $local_filename the local filename
     * @param string $file_ext_name the file extension name, do not include dot(.)
     * @param array $meta_list meta data assoc array, such as array('width'=>1024, 'height'=>768)
     * @param string $group_name specify the group name to store the file
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return array|bool
     */
    public function storage_upload_appender_by_filename($local_filename, $file_ext_name='', $meta_list=array(), $group_name='', $tracker_server=array(), $storage_server=array()){}

    /**
     * upload local file to storage server as appender file
     * return file_id for success, false for error
     *
     * @param string $local_filename the local filename
     * @param string $file_ext_name the file extension name, do not include dot(.)
     * @param array $meta_list meta data assoc array, such as array('width'=>1024, 'height'=>768)
     * @param string $group_name specify the group name to store the file
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return string|bool
     */
    public function storage_upload_appender_by_filename1($local_filename, $file_ext_name='', $meta_list=array(), $group_name='', $tracker_server=array(), $storage_server=array()){}

    /**
     * upload file buff to storage server as appender file
     * return assoc array for success, false for error.
     * the returned array includes elements: group_name and filename
     *
     * @param string $file_buff the file content
     * @param string $file_ext_name the file extension name, do not include dot(.)
     * @param array $meta_list meta data assoc array, such as array('width'=>1024, 'height'=>768)
     * @param string $group_name specify the group name to store the file
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return array|bool
     */
    public function storage_upload_appender_by_filebuff($file_buff, $file_ext_name='', $meta_list=array(), $group_name='', $tracker_server=array(), $storage_server=array()){}

    /**
     * upload file buff to storage server as appender file
     * return file_id for success, false for error
     *
     * @param string $file_buff the file content
     * @param string $file_ext_name the file extension name, do not include dot(.)
     * @param array $meta_list meta data assoc array, such as array('width'=>1024, 'height'=>768)
     * @param string $group_name specify the group name to store the file
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return string|bool
     */
    public function storage_upload_appender_by_filebuff1($file_buff, $file_ext_name='', $meta_list=array(), $group_name='', $tracker_server=array(), $storage_server=array()){}

    /**
     * upload file to storage server by callback as appender file
     * return assoc array for success, false for error.
     * the returned array includes elements: group_name and filename
     *
     * @param array $callback_array the callback assoc array, must have keys:
     *   callback  - the php callback function name callback function prototype as: function upload_file_callback($sock, $args)
     *   file_size - the file size
     *   args      - use argument for callback function
     * @param string $file_ext_name the file extension name, do not include dot(.)
     * @param array $meta_list meta data assoc array, such as array('width'=>1024, 'height'=>768)
     * @param string $group_name specify the group name to store the file
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return array|bool
     */
    public function storage_upload_appender_by_callback(array $callback_array, $file_ext_name='', $meta_list=array(), $group_name='', $tracker_server=array(), $storage_server=array()){}

    /**
     * upload file to storage server by callback as appender file
     * return file_id  for success, false for error
     *
     * @param array $callback_array the callback assoc array, must have keys:
     *   callback  - the php callback function name callback function prototype as: function upload_file_callback($sock, $args)
     *   file_size - the file size
     *   args      - use argument for callback function
     * @param string $file_ext_name the file extension name, do not include dot(.)
     * @param array $meta_list meta data assoc array, such as array('width'=>1024, 'height'=>768)
     * @param string $group_name specify the group name to store the file
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return string|bool
     */
    public function storage_upload_appender_by_callback1(array $callback_array, $file_ext_name='', $meta_list=array(), $group_name='', $tracker_server=array(), $storage_server=array()){}

    /**
     * upload local file to storage server (slave file mode)
     * return array for success, false for error
     *
     * @param string $local_filename the local filename
     * @param string $group_name the group name of the master file
     * @param string $master_filename the master filename to generate the slave file id
     * @param string $prefix_name the prefix name to generate the slave file id
     * @param string $file_ext_name the file extension name, do not include dot(.)
     * @param array $meta_list meta data assoc array, such as array('width'=>1024, 'height'=>768)
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return array|bool
     */
    public function storage_upload_slave_by_filename($local_filename, $group_name, $master_filename, $prefix_name, $file_ext_name='', $meta_list=array(), $tracker_server=array(), $storage_server=array()){}

    /**
     * upload local file to storage server (slave file mode)
     * return file_id for success, false for error
     *
     * @param string $local_filename the local filename
     * @param string $master_file_id the master file id to generate the slave file id
     * @param string $prefix_name the prefix name to generate the slave file id
     * @param string $file_ext_name the file extension name, do not include dot(.)
     * @param array $meta_list meta data assoc array, such as array('width'=>1024, 'height'=>768)
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return string|bool
     */
    public function storage_upload_slave_by_filename1($local_filename, $master_file_id, $prefix_name, $file_ext_name='', $meta_list=array(), $tracker_server=array(), $storage_server=array()){}

    /**
     * upload file buff to storage server (slave file mode)
     * return array for success, false for error
     *
     * @param string $file_buff the file content
     * @param string $group_name the group name of the master file
     * @param string $master_filename the master filename to generate the slave file id
     * @param string $prefix_name the prefix name to generate the slave file id
     * @param string $file_ext_name the file extension name, do not include dot(.)
     * @param array $meta_list meta data assoc array, such as array('width'=>1024, 'height'=>768)
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return array|bool
     */
    public function storage_upload_slave_by_filebuff($file_buff, $group_name, $master_filename, $prefix_name, $file_ext_name='', $meta_list=array(), $tracker_server=array(), $storage_server=array()){}

    /**
     * upload file buff to storage server (slave file mode)
     * return file_id  for success, false for error
     *
     * @param string $file_buff the file content
     * @param string $master_file_id the master file id to generate the slave file id
     * @param string $prefix_name the prefix name to generate the slave file id
     * @param string $file_ext_name the file extension name, do not include dot(.)
     * @param array $meta_list meta data assoc array, such as array('width'=>1024, 'height'=>768)
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return string|bool
     */
    public function storage_upload_slave_by_filebuff1($file_buff, $master_file_id, $prefix_name, $file_ext_name='', $meta_list=array(), $tracker_server=array(), $storage_server=array()){}

    /**
     * upload file to storage server by callback (slave file mode)
     * return array for success, false for error
     * the returned array includes elements: group_name and filename
     *
     * @param array $callback_array the callback assoc array, must have keys:
     *   callback  - the php callback function name callback function prototype as: function upload_file_callback($sock, $args)
     *   file_size - the file size
     *   args      - use argument for callback function
     * @param string $group_name the group name of the master file
     * @param string $master_filename the master filename to generate the slave file id
     * @param string $prefix_name the prefix name to generate the slave file id
     * @param string $file_ext_name the file extension name, do not include dot(.)
     * @param array $meta_list meta data assoc array, such as array('width'=>1024, 'height'=>768)
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return array|bool
     */
    public function storage_upload_slave_by_callback(array $callback_array, $group_name, $master_filename, $prefix_name, $file_ext_name='', $meta_list=array(), $tracker_server=array(), $storage_server=array()){}

    /**
     * upload file to storage server by callback (slave file mode)
     * return file_id  for success, false for error
     *
     * @param array $callback_array the callback assoc array, must have keys:
     *   callback  - the php callback function name callback function prototype as: function upload_file_callback($sock, $args)
     *   file_size - the file size
     *   args      - use argument for callback function
     * @param string $master_file_id the master file id to generate the slave file id
     * @param string $prefix_name the prefix name to generate the slave file id
     * @param string $file_ext_name the file extension name, do not include dot(.)
     * @param array $meta_list meta data assoc array, such as array('width'=>1024, 'height'=>768)
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return string|bool
     */
    public function storage_upload_slave_by_callback1(array $callback_array, $master_file_id, $prefix_name, $file_ext_name='', $meta_list=array(), $tracker_server=array(), $storage_server=array()){}

    /**
     * delete file from storage server
     * return true for success, false for error
     *
     * @param string $group_name the group name of the master file
     * @param string $remote_filename the filename on the storage server
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return bool
     */
    public function storage_delete_file($group_name, $remote_filename, $tracker_server=array(), $storage_server=array()){}

    /**
     * delete file from storage server
     * return true for success, false for error
     *
     * @param string $file_id the file id to be deleted
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return bool
     */
    public function storage_delete_file1($file_id, $tracker_server=array(), $storage_server=array()){}

    /**
     * truncate appender file to specify size
     * return true for success, false for error
     *
     * @param string $group_name the the group name of appender file
     * @param string $remote_filename the filename on the storage server
     * @param string $truncated_file_size truncate the file size to
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return bool
     */
    public function storage_truncate_file($group_name, $remote_filename, $truncated_file_size='', $tracker_server=array(), $storage_server=array()){}

    /**
     * truncate appender file to specify size
     * return true for success, false for error
     *
     * @param string $file_id the appender file id
     * @param string $truncated_file_size truncate the file size to
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return bool
     */
    public function storage_truncate_file1($file_id, $truncated_file_size='', $tracker_server=array(), $storage_server=array()){}

    /**
     * get file content from storage server
     * return file content for success, false for error
     *
     * @param string $group_name the group name of the master file
     * @param string $remote_filename the filename on the storage server
     * @param int $file_offset file start offset, default value is 0
     * @param int $download_bytes 0 (default value) means from the file offset to the file end
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return string|bool
     */
    public function storage_download_file_to_buff($group_name, $remote_filename, $file_offset=0, $download_bytes=0, $tracker_server=array(), $storage_server=array()){}

    /**
     * get file content from storage server
     * return file content for success, false for error
     *
     * @param string $file_id the file id of the file
     * @param int $file_offset file start offset, default value is 0
     * @param int $download_bytes 0 (default value) means from the file offset to the file end
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return string|bool
     */
    public function storage_download_file_to_buff1($file_id, $file_offset=0, $download_bytes=0, $tracker_server=array(), $storage_server=array()){}

    /**
     * download file from storage server to local file
     * return true for success, false for error
     *
     * @param string $group_name the group name of the master file
     * @param string $remote_filename the filename on the storage server
     * @param string $local_filename the local filename to save the file content
     * @param int $file_offset file start offset, default value is 0
     * @param int $download_bytes 0 (default value) means from the file offset to the file end
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return bool
     */
    public function storage_download_file_to_file($group_name, $remote_filename, $local_filename, $file_offset=0, $download_bytes=0, $tracker_server=array(), $storage_server=array()){}

    /**
     * download file from storage server to local file
     * return true for success, false for error
     *
     * @param string $file_id the file id of the file
     * @param string $local_filename the local filename to save the file content
     * @param int $file_offset file start offset, default value is 0
     * @param int $download_bytes 0 (default value) means from the file offset to the file end
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return bool
     */
    public function storage_download_file_to_file1($file_id, $local_filename, $file_offset=0, $download_bytes=0, $tracker_server=array(), $storage_server=array()){}

    /**
     * return true for success, false for error
     *
     * @param string $group_name the group name of the master file
     * @param string $remote_filename the filename on the storage server
     * @param array $download_callback the download callback array, elements as:
     *   callback  - the php callback function name callback function prototype as: function my_download_file_callback($args, $file_size, $data)
     *   args      - use argument for callback function
     * @param int $file_offset file start offset, default value is 0
     * @param int $download_bytes 0 (default value) means from the file offset to the file end
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return bool
     */
    public function storage_download_file_to_callback($group_name, $remote_filename, array $download_callback, $file_offset=0, $download_bytes=0, $tracker_server=array(), $storage_server=array()){}

    /**
     * return true for success, false for error
     *
     * @param string $file_id the file id of the file
     * @param array $download_callback the download callback array, elements as:
     *   callback  - the php callback function name callback function prototype as: function my_download_file_callback($args, $file_size, $data)
     *   args      - use argument for callback function
     * @param int $file_offset file start offset, default value is 0
     * @param int $download_bytes 0 (default value) means from the file offset to the file end
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return bool
     */
    public function storage_download_file_to_callback1($file_id, array $download_callback, $file_offset=0, $download_bytes=0, $tracker_server=array(), $storage_server=array()){}

    /**
     * set meta data of the file
     * return true for success, false for error
     *
     * @param string $group_name the group name of the master file
     * @param string $remote_filename the filename on the storage server
     * @param array $meta_list meta data assoc array, such as array('width'=>1024, 'height'=>768)
     * @param string $op_type operate flag, can be one of following flags:
     *   FDFS_STORAGE_SET_METADATA_FLAG_MERGE: combined with the old meta data
     *   FDFS_STORAGE_SET_METADATA_FLAG_OVERWRITE: overwrite the old meta data
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return bool
     */
    public function storage_set_metadata($group_name, $remote_filename, array $meta_list, $op_type='', $tracker_server=array(), $storage_server=array()){}

    /**
     * set meta data of the file
     * return true for success, false for error
     *
     * @param string $file_id the file id of the file
     * @param array $meta_list meta data assoc array, such as array('width'=>1024, 'height'=>768)
     * @param string $op_type operate flag, can be one of following flags:
     *   FDFS_STORAGE_SET_METADATA_FLAG_MERGE: combined with the old meta data
     *   FDFS_STORAGE_SET_METADATA_FLAG_OVERWRITE: overwrite the old meta data
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return bool
     */
    public function storage_set_metadata1($file_id, array $meta_list, $op_type='', $tracker_server=array(), $storage_server=array()){}

    /**
     * get meta data of the file
     * return array for success, false for error
     * returned array like: array('width' => 1024, 'height' => 768)
     *
     * @param string $group_name the group name of the master file
     * @param string $remote_filename the filename on the storage server
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return array|bool
     */
    public function storage_get_metadata($group_name, $remote_filename, $tracker_server=array(), $storage_server=array()){}

    /**
     * get meta data of the file
     * return array for success, false for error
     * returned array like: array('width' => 1024, 'height' => 768)
     *
     * @param string $file_id the file id of the file
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return array|bool
     */
    public function storage_get_metadata1($file_id, $tracker_server=array(), $storage_server=array()){}

    /**
     * check file exist
     * return true for exist, false for not exist
     *
     * @param string $group_name the group name of the file
     * @param string $remote_filename the filename on the storage server
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return bool
     */
    public function storage_file_exist($group_name, $remote_filename, $tracker_server=array(), $storage_server=array()){}

    /**
     * check file exist
     * return true for exist, false for not exist
     *
     * @param string $file_id the file id of the file
     * @param array $tracker_server the tracker server assoc array including elements: ip_addr, port and sock
     * @param array $storage_server the storage server assoc array including elements: ip_addr, port and sock
     * @return bool
     */
    public function storage_file_exist1($file_id, $tracker_server=array(), $storage_server=array()){}

    /**
     * return last error no
     *
     * @return int
     */
    public function get_last_error_no(){}

    /**
     * return last error info
     *
     * @return string
     */
    public function get_last_error_info(){}

    /**
     * generate anti-steal token for HTTP download
     * return token string for success, false for error
     *
     * @param string $file_id the file id of the file
     * @param int $timestamp the timestamp (unix timestamp)
     * @return string|bool
     */
    public function http_gen_token($file_id, $timestamp){}

    /**
     * get file info from the filename
     * return assoc array for success, false for error.
     * the assoc array including following elements:
     *   create_timestamp: the file create timestamp (unix timestamp)
     *   file_size: the file size (bytes)
     *   source_ip_addr: the source storage server ip address
     *   crc32: the crc32 signature of the file
     *
     * @param string $group_name the group name of the file
     * @param string $remote_filename the filename on the storage server
     * @return array|bool
     */
    public function get_file_info($group_name, $remote_filename){}

    /**
     * get file info from the file id
     * return assoc array for success, false for error.
     * the assoc array including following elements:
     *   create_timestamp: the file create timestamp (unix timestamp)
     *   file_size: the file size (bytes)
     *   source_ip_addr: the source storage server ip address
     *
     * @param string $file_id the file id (including group name and filename) or remote filename
     * @return array|bool
     */
    public function get_file_info1($file_id){}

    /**
     * return true for success, false for error
     *
     * @param int $sock the unix socket description
     * @param string $buff the buff to send
     * @return bool
     */
    public function send_data($sock, $buff){}

    /**
     * generate slave filename by master filename, prefix name and file extension name
     * return slave filename string for success, false for error
     *
     * @param string $master_filename the master filename / file id to generate the slave filename
     * @param string $prefix_name the prefix name  to generate the slave filename
     * @param string $file_ext_name slave file extension name, can be null or empty (do not including dot)
     * @return string|bool
     */
    public function gen_slave_filename($master_filename, $prefix_name, $file_ext_name=''){}

    /**
     * close tracker connections
     *
     * @return void
     */
    public function close(){}
}