08.swoole_async_IO


Table of Contents


1.swoole_async_readfile

功能:异步读取文件内容
函数原型:

  1. swoole_async_readfile(string $filename, mixed $callback);

参数说明:

参数 描述
filename 待读取的文件名
callback 读取结束的回调函数

回调函数原型:

  1. function callback($filename, $content);

回调函数参数说明:

参数 描述
filename 文件名
content 读取到的文件内容

说明:
swoole_async_readfile会将文件内容全部复制到内存,所以不能用于大文件的读取
如果要读取超大文件,请使用swoole_async_read函数
swoole_async_readfile最大可读取4M的文件,受限于SW_AIO_MAX_FILESIZE
示例:

  1. swoole_async_readfile( __DIR__."/Test.txt", function($filename, $content) {
  2. echo "$filename: $content";
  3. });

2.swoole_async_writefile

功能:异步写文件
函数原型:

  1. swoole_async_writefile(string $filename, string $content, mixed $callback);

参数说明:

参数 描述
filename 待写入的文件名
content 待写入的文件内容
callback 写入结束的回调函数

回调函数原型:

  1. function callback($filename);

回调函数参数说明:

参数 描述
filename 文件名

说明:
swoole_async_writefile最大可写入4M的文件,也可以不指定回调函数
示例:

  1. swoole_async_writefile('test.log', "This is a test log", function($filename) {
  2. echo "wirte ok.\n";
  3. });

3.swoole_async_read

功能:异步分段读文件
函数原型:

  1. swoole_async_read(string $filename, mixed $callback, int $trunk_size = 8192);

参数说明:

参数 描述
filename 待读取的文件名
callback 读取结束的回调函数
trunk_size 每次读取的字节数

回调函数原型:

  1. function callback($filename, $content);

回调函数参数说明:

参数 描述
filename 文件名
content 读取到的文件内容,如果为空代表文件已读完。

说明:
swoole_async_read每次读取trunk_size个字节,读完后会自动调用callback函数
在callback回调函数中,可以通过return true/false来控制是否继续读取文件。返回true代表继续读取,返回false代表停止读取。 示例:

  1. swoole_async_read( __DIR__."/Test.txt" , function($filename, $content){
  2. if( empty( $content ) ) {
  3. return false;
  4. } else {
  5. echo "$filename: $content";
  6. return true;
  7. }
  8. } , 8192 );

4.swoole_async_write

功能:异步写文件
函数原型:

  1. bool swoole_async_write(string $filename, string $content, int $offset = -1, mixed $callback = NULL);

参数说明:

参数 描述
filename 待写入的文件名
content 待写入的文件内容
offset 写入文件的位置
callback 写入结束的回调函数

回调函数原型:

  1. function callback($filename, $writen);

回调函数参数说明:

参数 描述
filename 文件名
writen 本次调用已经写入的字节数

说明:
swoole_async_write过传入的offset参数来确定写入的位置,当offset为-1时表示追加写入到文件的末尾
示例:

  1. swoole_async_write( 'test_1.log', "This is a test log\n" , -1 , function( $filename, $writen ){
  2. echo "$filename: write $writen byte\n";
  3. });

5.swoole_async_dns_lookup

功能:将域名解析为IP地址
函数原型:

  1. bool swoole_async_dns_lookup(string $host, mixed $callback);

参数说明:

参数 描述
filename 待查询的地址
callback 查询结束的回调函数

回调函数原型:

  1. function callback($host, $ip);

回调函数参数说明:

参数 描述
filename 文件名
writen 本次调用已经写入的字节数

说明:
当DNS查询失败时,比如域名不存在,回调函数传入的$ip为空
示例:

  1. swoole_async_dns_lookup("www.baidu.com", function($host, $ip){
  2. echo "{$host} : {$ip}\n";
  3. });