导读：fastdfs_get_last_error_no(),'info'=>fastdfs_get_last_error_info(),'act'=>$act)privatestatic$in..
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(){} }
更多文章请关注《万象专栏》
转载请注明出处：https://www.wanxiangsucai.com/read/cv4701