# Coroutine::fgets 协程方式按行读取文件内容。 ```php function Coroutine::fgets(resource $handle); ``` `Co::fgets`底层使用了`php_stream`缓存区，默认大小为`8192`字节，可使用`stream_set_chunk_size`设置缓存区尺寸。 > 需要`2.1.1`或更高版本 > `fgets`函数仅可用于文件类型的`stream`资源 参数 ---- * `$handle`文件句柄，必须是`fopen`打开的文件类型`stream`资源 返回值 ---- * 读取到`EOL`（`\r`或`\n`）将返回一行数据，包括`EOL` * 未读取到`EOL`，但内容长度超过`php_stream`缓存区`8192`字节，将返回`8192`字节的数据，不包含`EOL` * 达到文件末尾`EOF`时，返回空字符串，可用`feof`判断文件是否已读完 * 读取失败返回`false`，使用`swoole_last_error`函数获取错误码 示例 --- ```php $fp = fopen(__DIR__ . "/defer_client.php", "r"); go(function () use ($fp) { $r = co::fgets($fp); var_dump($r); }); ```