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(){}
}