PHP Manual
后退 |  | 前进

# XXXVII. 文件系统函数库

# 简介

# 需求

无需外部库文件就可以加入本扩展模块的支持。

# 安装

这些函数作为 PHP 核心的一部分，无需被安装即可使用。

# 运行时配置

这些函数的行为受 `php.ini` 的影响。

表格 1. 文件系统和流配置选项

名称 | 默认值 | 作用范围
--- | --- | ---
allow_url_fopen | "1" | PHP_INI_ALL
user_agent | NULL | PHP_INI_ALL
default_socket_timeout | "60" | PHP_INI_ALL
from | NULL | ??
auto_detect_line_endings | "Off" | PHP_INI_ALL

以下是该配置选项的简要解释。

allow_url_fopen boolean

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

  > 注: 本选项是版本 4.0.3 发行后立即引进的。4.0.3 以及以前的版本只能在编译时通过配置项 --disable-url-fopen-wrapper 来取消此特性。

  警告
  Windows 版在 PHP 4.3.0 之前，下列函数不支持远程文件访问：include()，include_once(), require()，require_once() 和 参考 LIII, 图像函数库 扩展库中的 imagecreatefromXXX 函数。

user_agent string

  定义 PHP 发送的 User-Agent。

default_socket_timeout integer

  基于 socket 的流的默认超时时间（秒）。

  > 注: 本配置参数是 PHP 4.3.0 引进的。

from="joe@example.com" string

  定义匿名 ftp 的密码（你的 email 地址）。

auto_detect_line_endings boolean

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

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

  > 注: 本配置参数是 PHP 4.3.0 引进的。

# 资源类型

# 预定义常量

以下常量由本扩展模块定义，因此只有在本扩展模块被编译到 PHP 中，或者在运行时被动态加载后才有效。

`GLOB_BRACE` (integer)

`GLOB_ONLYDIR` (integer)

`GLOB_MARK` (integer)

`GLOB_NOSORT` (integer)

`GLOB_NOCHECK` (integer)

`GLOB_NOESCAPE` (integer)

`PATHINFO_DIRNAME` (integer)

`PATHINFO_BASENAME` (integer)

`PATHINFO_EXTENSION` (integer)

`FILE_USE_INCLUDE_PATH` (integer)

`FILE_APPEND` (integer)

`FILE_IGNORE_NEW_LINES` (integer)

`FILE_SKIP_EMPTY_LINES` (integer)

# 参见

相关函数参见目录函数库和程序执行函数库小节。

后退 | 起点 | 前进
filepro | 上一级 | basename