大网数据广告活动
PHP 语言与运行手册

stream_get_line · 从资源流里读取一行直到给定的定界符

· 52CE 我爱测

当读取到 length 个字节数就结束,或者当在读取的非空字符串中发现 ending (不包含到返回值里)也结束,又或者遇到了 EOF 也结束(总之以上条件中哪个先出现就以哪个为准)。

stream_get_line

(PHP 5, PHP 7, PHP 8)

stream_get_line — 从资源流里读取一行直到给定的定界符

说明

function stream_get_line(resource $stream, int $length, string $ending = ""): string|false

从给定的资源流里读取一行。

当读取到 length 个字节数就结束,或者当在读取的非空字符串中发现 ending (不包含到返回值里)也结束,又或者遇到了 EOF 也结束(总之以上条件中哪个先出现就以哪个为准)。

这个函数与 fgets() 几乎是相同的,唯一的区别是在这个函数里面允许指定行尾的定界符,而不是使用标准的 \n, \r 还有 \r\n ,并且返回值中不包含定界符。(翻译注:也可以把 \n 等作为定界符传入 ending )

参数

stream

一个有效的文件句柄。

length

需要从句柄中读取的最大字节数。不支持负值。 0 表示默认的套接字块大小(socket chunk size),即 8192 字节。

ending

可选参数,字符串定界符。

返回值

返回一个字符串,该字符串的内容根据 length 字节数从 stream 里读取, 或者在失败时返回 false。

参见

  • fread() - 读取文件(可安全用于二进制文件)
  • fgets() - 从文件指针中读取一行
  • fgetc() - 从文件指针中读取字符

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。