FastDFS接口API文档.docx

一 命令行的上传：上传命令1./usr/local/bin/fdfs_upload_file 例如：系统根目录下有个文件需要上传到dfs服务器上：/ cairo-1.2.0.tar.gz执行上传命令如下：/usr/local/bin/fdfs_upload_file /etc/fdfs/client.conf /cairo-1.2.0.tar.gz返回值如下：group3/M00/00/00/wKgAUE5yh7DZXQcEACiWWseqpak.tar.gz此信息返回的是文件存储的路径及文件名信息。上传命令2（测试上传，请务必不要在生产线上使用，统一使用第一种上传）：/usr/local/bin/fdfs_test upload 例如：上传同上一样的文件：/usr/local/bin/fdfs_test /etc/fdfs/client.conf upload /cairo-1.2.0.tar.gz返回值如下：INFO - base_path=/home/yuqing/fastdfs, connect_timeout=30, network_timeout=60, tracker_server_count=1, anti_steal_token=0, anti_steal_secret_key length=0tracker_query_storage_store_list_without_group: server 1. group_name=group3, ip_addr=0, port=23000group_name=group3, ip_addr=0, port=23000storage_upload_by_filenamegroup_name=group3, remote_filename=M00/00/00/wKgAUE5yiVK0VEpSACiWWseqpak.tar.gzsource ip address: 0file timestamp=2011-09-16 07:25:06file size=2659930file crc32=3349849513file url: 0:8090/group3/M00/00/00/wKgAUE5yiVK0VEpSACiWWseqpak.tar.gzstorage_upload_slave_by_filenamegroup_name=group3, remote_filename=M00/00/00/wKgAUE5yiVK0VEpSACiWWseqpak_big.tar.gzsource ip address: 0file timestamp=2011-09-16 07:25:06file size=2659930file crc32=3349849513file url: 0:8090/group3/M00/00/00/wKgAUE5yiVK0VEpSACiWWseqpak_big.tar.gz以上返回信息中：1. INFO信息返回了存储服务器的系统信息2. Group_name:返回了storage服务器的id信息3. remote_filename:返回了storage的存储路径。4. source_ip address:返回了tracker server的ip地址。5. file timestamp:返回时间戳6. file size：返回文件大小7. file url：返回上传文件的url地址二 命令行的删除：/usr/local/bin/fdfs_delete_file groupid/file_name例如：删除上面上传的文件/usr/local/bin/fdfs_delete_file /etc/fdfs/client.conf group3/M00/00/00/wKgAUE5yiVK0VEpSACiWWseqpak.tar.gz三 下载：/usr/local/bin/fdfs_download_file local_filename例如下载上面上传的文件：/usr/local/bin/fdfs_download_file /etc/fdfs/client.conf group3/M00/00/00/wKgAUE5yiVK0VEpSACiWWseqpak_big.tar.gz /cairo.tar.gz其中：config_file:只客户端下载配置文件 File_id：指文件的路径 local_filename:指下载到本地后修改的文件名。基于php的API注解：Filename是storage返回的remote_filenamefile_id是including group name and filenamegroup是storage的组名timestamp是时间戳local_filename本地文件名file_ext_name文件扩展名meta_list详细文件属性列表tracker_server Fast的服务器地址storage_server group地址获取FastDFS的版本：fastdfs_client_version()返回值类型：字符串获取错误记录数：fastdfs_get_last_error_no()返回值类型：int获取错误信息：fastdfs_get_last_error_info()返回值类型：字符串获取产生反偷令牌函数：fastdfs_http_gen_token(string file_id, int timestamp)返回值类型：string通过文件名得到文件详细信息：fastdfs_get_file_info(string group_name, string filename)返回值类型：array包括信息：时间戳 文件大小 源地址通过文件id获取文件信息：fastdfs_get_file_info1(string file_id)返回值类型：array包括信息：时间戳 文件大小 源地址由主文件名产生从文件名：string fastdfs_gen_slave_filename(string master_filename, string prefix_name , string file_ext_name)返回值：字符串返回信息：从文件名，出错返回error上传本地文件到服务器：array fastdfs_storage_upload_by_filename(string local_filename, string file_ext_name, array meta_list, string group_name, array tracker_server, array storage_server)返回值：array上传本地文件到服务器：string fastdfs_storage_upload_by_filename1(string local_filename, string file_ext_name, string meta_list, string group_name, array tracker_server, array storage_server)返回值：string例如：fastdfs_storage-upload_by_filename1(/zxy.jpg, null, array(), null, $tracker, $storage);上传文件到存储服务器的缓存。fastdfs_storage_upload_by_filebuff(string file_buff, string file_ext_name, string meta_list, string group_name, array tracker_server, array storage_server)返回值：array上传本地文件到存储服务器：fastdfs_storage_upload_appender_by_filename(string local_filename, string file_ext_name, array meta_list, string group_name, array tracker_server, array storage_server)返回值：array删除storage上的文件：fastdfs_storage_delete_file(string group_name, string remote_filename , array tracker_server, array storage_server)返回值：boolean删除storage上的文件：fastdfs_storage_delete_file1(string file_id, array tracker_server, array storage_server)返回值：boolean下载文件：（请根据调用情况使用下载函数，url的下载可以直接参考组合url地址）fastdfs_storage_download_file_to_buff(string group_name, string remote_filename , long file_offset, long download_bytes,array tracker_server, array storage_server)返回值：string下载文件：fastdfs_storage_download_file_to_buff1(string file_id , long file_offset, long download_bytes,array tracker_server, array storage_server)返回值：string下载文件到本地：fastdfs_storage_download_file_to_file(string group_name, string remote_filename, string local_filename , long file_offset, long download_bytes, array tracker_server, array storage_server)返回值：boolean设置文件元数据属性：fastdfs_storage_set_metadata(string group_name, string remote_filename,array meta_list , string op_type, array tracker_server, array storage_server)返回值：boolean设置文件元数据：fastdfs_storage_get_metadata(string group_name, string remote_filename, array tracker_server, array storage_server)返回值：boolean连接服务器：fastdfs_connect_server(string ip_addr, int port)返回值：array：Ip地址 Port断开服务器连接：fastdfs_disconnect_server(array server_info)返回值：boolean状态测试：（主要测试storage的状态）fastdfs_active_test(array server_info)返回值：boolean获取一个tracker server连接：fastdfs_tracker_get_connection()返回值：boolean连接到所有的trackerfastdfs_tracker_make_all_connections()返回值：boolean关闭所有的tracker连接：fastdfs_tracker_close_all_connections()返回值：boolean获得小组统计信息fastdfs_tracker_list_groups(string group_name, array tracker_server)返回值：array获取storage信息fastdfs_tracker_query_storage_store(string group_name, array tracker_server)返回值：array连接所有的trackerfastdfs_tracker_make_all_connections()返回值：boolean获取存储服务器的信息：fastdfs_tracker_query_storage_