文件系统

## 简介
编译此扩展无需任何额外的库，但想要 PHP 支持 Linux 的 LFS（large files），需要最新的 glibc，并在编译 PHP 时带上以下标记： -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64。

## 安装/配置

### 需求
构建此扩展不需要其他扩展。

### 安装
使用这些函数不需要安装，它们是 PHP 核心的一部分。

### 运行时配置
这些函数的行为受 php.ini 中的设置影响。

| 名字                     | 默认   | 可修改范围      | 更新日志             |
|--------------------------|------|------------|------------------|
| allow_url_fopen          | "1"  | INI_SYSTEM | &nbsp;           |
| allow_url_include        | "0"  | INI_SYSTEM | 自 PHP 7.4.0 起废弃。 |
| user_agent               | NULL | INI_ALL    | &nbsp;           |
| default_socket_timeout   | "60" | INI_ALL    | &nbsp;           |
| from                     | ""   | INI_ALL    | &nbsp;           |
| auto_detect_line_endings | "0"  | INI_ALL    | 自 PHP 8.1.0 起弃用。 |
| sys_temp_dir             | ""   | INI_SYSTEM | &nbsp;           |

这是配置指令的简短说明。

`allow_url_fopen` `bool`
本选项激活了 URL 形式的 fopen 封装协议使得可以访问 URL 对象例如文件。默认的封装协议提供用 ftp 和 http 协议来访问远程文件，一些扩展库例如 zlib 可能会注册更多的封装协议。

`allow_url_include` `bool`
This option allows the use of URL-aware fopen wrappers with the following functions: include, include_once, require, require_once.

> 注意:
这个设置项需要开启 `allow_url_fopen` 。

`user_agent` `string`
定义 PHP 发送的 User-Agent。

`default_socket_timeout` `int`
指定基于 socket 的流的默认超时时间（秒）。指定一个负值意味着不会超时。

`from` `string`
这个 email 地址在使用 ftp 封装器的时候用于未认证的 FTP 连接，在使用 http 封装器的时候用于 HTTP 连接的消息头中的 From 字段。

`auto_detect_line_endings` `bool`
当设为 On 时，PHP 将检查通过 `fgets()` 和 `file()` 取得的数据中的行结束符号是符合 Unix，MS-DOS，还是 Macintosh 的习惯。

这使得 PHP 可以和 Macintosh 系统交互操作，但是默认值是 Off，因为在检测第一行的 EOL 习惯时会有很小的性能损失，而且在 Unix 系统下使用回车符号作为项目分隔符的人们会遭遇向下不兼容的行为。

`sys_temp_dir` `string`

### 资源类型
文件系统使用 streams 作为资源类型。 Streams 的文档有专门的章节：[Streams](http://www.bixiaguangnian.com/manual/phpfunction/1880.html "Streams")。

## 预定义常量
下列常量由此扩展定义，且仅在此扩展编译入 PHP 或在运行时动态载入时可用。

SEEK_SET (int)

SEEK_CUR (int)

SEEK_END (int)

LOCK_SH (int)

LOCK_EX (int)

LOCK_UN (int)

LOCK_NB (int)

GLOB_BRACE (int)

扩展 {a,b,c} 为匹配“a”、“b”或“c”

> 注意: GLOB_BRACE 在非 GUN 系统无效，像 Solaris 或 Alpine Linux。

GLOB_ERR (int)
默认忽略错误，在读取错误（如目录无法读取）时停止。

GLOB_ONLYDIR (int)
只返回与模式匹配的目录条目

GLOB_MARK (int)
向每个返回的目录添加斜线（在 Windows 上为反斜线）

GLOB_NOSORT (int)
按照目录中出现的顺序返回文件（不排序）。当不使用此 flag 时，路径名按字母顺序排序

GLOB_NOCHECK (int)
如果没有找到匹配该模式的文件，则返回搜索模式

GLOB_NOESCAPE (int)
反斜线不引用元字符

PATHINFO_DIRNAME (int)

PATHINFO_BASENAME (int)

PATHINFO_EXTENSION (int)

PATHINFO_FILENAME (int)

FILE_USE_INCLUDE_PATH (int)
在 include_path 里搜索 filename。

FILE_NO_DEFAULT_CONTEXT (int)

FILE_APPEND (int)
为存在的文件添加内容。

FILE_IGNORE_NEW_LINES (int)
过滤换行（EOL）字符。

FILE_SKIP_EMPTY_LINES (int)
过滤空行。

FILE_BINARY (int)
二进制模式。

> 注意:
此常量无效，仅仅用于向后兼容（forward compatibility）。

FILE_TEXT (int)
文本模式。

> 注意:
此常量无效，仅仅用于向后兼容（forward compatibility）。

INI_SCANNER_NORMAL (int)
普通的 INI 扫描模式。

INI_SCANNER_RAW (int)
原始（Raw） INI 扫描模式。

INI_SCANNER_TYPED (int)
Typed INI 扫描模式。

FNM_NOESCAPE (int)
禁用反斜线转义

FNM_PATHNAME (int)
字符串里的斜杠只匹配指定模式里的斜杠。

FNM_PERIOD (int)
字符串里的起始点号必须完全匹配指定模式里的点号。

FNM_CASEFOLD (int)
大小写不敏感的匹配，GNU 扩展的一部分。