3 文件操作

1       文件操作

1.1    touch

可以用来创建文件。

(PHP 4, PHP 5, PHP 7, PHP 8)

touch — 设定文件的访问和修改时间

1.1.1    说明

touch(string $filename, int $time = time(), int $atime = ?): bool

尝试将由 filename 给出的文件的访问和修改时间设定为给出的 time。 注意访问时间总是会被修改的，不论有几个参数。

如果文件不存在，则会被创建。

1.1.2    参数

filename

要设定的文件名。

time

要设定的时间。如果没有提供参数 time 则会使用当前系统的时间。

atime

如果给出了这个参数，则给定文件的访问时间会被设为 atime，否则会设置 为time。如果没有给出这两个参数，则使用当前系统时间。

1.1.3    返回值

成功时返回 true， 或者在失败时返回 false。

1.2     copy

(PHP 4, PHP 5, PHP 7, PHP 8)

copy — 拷贝文件

1.2.1    说明

copy(string $source, string $dest, resource $context = ?): bool

将文件从 source 拷贝到 dest。

如果要移动文件的话，请使用 rename() 函数。

1.2.2   参数

source

源文件路径。

dest

目标路径。如果 dest 是一个 URL，则如果封装协议不支持覆盖已有的文件时拷贝操作会失败。

警告

如果目标文件已存在，将会被覆盖。

context

A valid context resource created with stream_context_create().

1.2.3   返回值

成功时返回 true， 或者在失败时返回 false。

1.3    rename

可用于移动文件。

(PHP 4, PHP 5, PHP 7, PHP 8)

rename — 重命名一个文件或目录

1.3.1    说明

rename(string $oldname, string $newname, resource $context = ?): bool

尝试把 oldname 重命名为 newname，必要时会在不同目录间移动。 如果重命名文件时 newname 已经存在，将会覆盖掉它。 如果重命名文件夹时 newname 已经存在，本函数将导致一个警告。

1.3.2   参数

oldname

原名

注意:

用于 oldname 中的封装协议必须和用于 newname 中的相匹配。

newname

新的名字。

注意: 在 Windows 上，如果 newname 已经存在，它必须是可写的。 否则 rename() 将失败，并导致 E_WARNING。

context

注意: 在 PHP 5.0.0 中增加了对上下文（Context）的支持。有关上下文（Context）的说明参见 Streams。

1.3.3   返回值

成功时返回 true， 或者在失败时返回 false。

1.4     unlink

(PHP 4, PHP 5, PHP 7, PHP 8)

unlink — 删除文件

1.4.1    说明

unlink(string $filename, resource $context = ?): bool

删除 filename。和 Unix C 的 unlink() 函数相似。 发生错误时会产生一个 E_WARNING 级别的错误。

1.4.2   参数

filename

文件的路径。

context

注意: 在 PHP 5.0.0 中增加了对上下文（Context）的支持。有关上下文（Context）的说明参见 Streams。

1.4.3   返回值

成功时返回 true， 或者在失败时返回 false。

1.5     filesize

(PHP 4, PHP 5, PHP 7, PHP 8)

filesize — 取得文件大小

1.5.1    说明

filesize(string $filename): int

取得指定文件的大小。

1.5.2   参数

filename

文件的路径。

1.5.3   返回值

返回文件大小的字节数，如果出错返回 false 并生成一条 E_WARNING 级的错误。

注意: 因为 PHP 的整数类型是有符号整型而且很多平台使用 32 位整型，对 2GB 以上的文件，一些文件系统函数可能返回无法预期的结

1.6     is_file

(PHP 4, PHP 5, PHP 7, PHP 8)

is_file — 判断给定文件名是否为一个正常的文件

1.6.1    说明

is_file(string $filename): bool

判断给定文件名是否为一个正常的文件。

1.6.2   参数

filename

文件的路径。

1.6.3   返回值

如果文件存在且为正常的文件则返回 true，否则返回 false。

注意: 因为 PHP 的整数类型是有符号整型而且很多平台使用 32 位整型，对 2GB 以上的文件，一些文件系统函数可能返回无法预期的结果。

1.7     file_exists

(PHP 4, PHP 5, PHP 7, PHP 8)

file_exists — 检查文件或目录是否存在

1.7.1    说明

file_exists(string $filename): bool

检查文件或目录是否存在。

1.7.2    参数

filename

文件或目录的路径。

在 Windows 中要用 //computername/share/filename 或者 \\computername\share\filename 来检查网络中的共享文件。

1.7.3    返回值

如果由 filename 指定的文件或目录存在则返回 true，否则返回 false。

注意:

This function will return false for symlinks pointing to non-existing files.

注意:

The check is done using the real UID/GID instead of the effective one.

注意: 因为 PHP 的整数类型是有符号整型而且很多平台使用 32 位整型，对 2GB 以上的文件，一些文件系统函数可能返回无法预期的结果。