# Coroutine::fread [TOC] 協程方式讀取文件。 ~~~ function Coroutine::fread(resource $handle, int $length = 0); ~~~ > 需要`2.0.11`或更高版本 ## 參數 * `$handle`文件句柄，必須是`fopen`打開的文件類型`stream`資源 * `$length`讀取的長度，默認為`0`，表示讀取文件的全部內容 ## 返回值 讀取成功返回字符串內容，讀取失敗返回`false` ## 版本差異 `4.0.4`以下版本`fread`方法不支持非文件類型的`stream`，如`STDIN`、`Socket`，請勿使用`fread`操作此類資源。 `4.0.4`以上版本`fread`方法支持了非文件類型的`stream`資源，底層會自動根據`stream`類型選擇使用`AIO`線程池或`EventLoop`實現。 ## 示例 ~~~ use Swoole\Coroutine as co; $fp = fopen(__DIR__ . "/defer_client.php", "r"); co::create(function () use ($fp) { fseek($fp, 256); $r = co::fread($fp); var_dump($r); }); ~~~