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(){} }
posted on 2021-10-27 23:23 yipianchuyun 阅读(72) 评论(0) 编辑 收藏 举报
