swoole_client->sendfile
最后更新于:2022-04-02 06:36:41
# swoole\_client->sendfile
[TOC]
发送文件到服务器,本函数是基于`sendfile`操作系统调用实现,在`1.7.5`以上版本可用。
~~~
bool swoole_client->sendfile(string $filename, int $offset = 0, int $length = 0)
~~~
> `sendfile`不能用于`UDP`客户端和`SSL`隧道加密连接
## 参数
* `$filename`指定要发送文件的路径
* `$offset`上传文件的偏移量,可以指定从文件的中间部分开始传输数据。此特性可用于支持断点续传。
* `$length`发送数据的尺寸,默认为整个文件的尺寸
## 返回值
* 如果传入的文件不存在,将返回`false`
* 执行成功返回`true`
## 注意事项
* `$length`,`$offse`t参数在`1.9.11`或更高版本可用
* 如果是同步`client`,`sendfile`会一直阻塞直到整个文件发送完毕或者发生致命错误
* 如果是异步`client`,`sendfile`会异步发送,当发生致命错误时会回调`onError`
';