PHP函数学习总结

version_compare（比较php版本）

用法：

version_compare(string $version1, string $version2, ?string $operator = null): int|bool

//示例
$result = version_compare(PHP_VERSION, '8.0.0') >= 0 ? 'ok' : 'fail';

echo $result;

// 输出ok证明当前版本大于等于8.0.0，输出fail证明当前版本小于8.0.0

参数：

version1：第一个版本数

version2：第二个版本数

operator:可选运算符。可能运算符有：<、lt、<=、le、 >、gt、>=、ge、==、 =、eq、!=、<>、ne。此参数区分大小写，它的值应该是小写的。

返回值：

默认情况下，在第一个版本低于第二个时，version_compare() 返回 -1；如果两者相等，返回 0；第二个版本更低时则返回 1。

当使用了可选参数 operator 时，如果关系是操作符所指定的那个，函数将返回 true，否则返回 false。

extension_loaded（检查是否加载扩展）

用法：

extension_loaded(string $extension): bool

//示例
$result = extension_loaded('pdo') ? 'ok' : 'fail';

echo $result;

// 输出ok证明已加载PDO扩展，输出fail证明没有加载

参数：

extension：扩展名称，大小写不敏感。

返回值：

如果 extension 指定的扩展已加载，返回 true，否则返回 false。

session_save_path（ 读取/设置当前会话的保存路径）

用法：

session_save_path(?string $path = null): string|false

// path为空时，返回当前会话的保存路径

参数：

path：指定会话数据保存的路径。如果已经指定且不为 null，保存数据的路径将会改变。 必须在调用 session_start() 函数之前调用 session_save_path() 函数。

注意:

在某些操作系统上，建议使用可以高效处理 大量小尺寸文件的文件系统上的路径来保存会话数据。 例如，在 Linux 平台上，对于会话数据保存的工作而言，reiserfs 文件系统会比 ext2fs 文件系统能够提供更好的性能。

返回值：

返回保存会话数据的路径， 或者在失败时返回 false。

is_dir（判断是否为目录）

用法：

is_dir(string $filename): bool

参数：

filename：文件路径，如果 filename 是相对文件名，会相对于当前工作目录进行检查。如果 filename 是符号链接或者硬链接，然后解析链接并检查。如果启用了 open_basedir，则会应用更多限制。

返回值：

如果文件名存在，并且是个目录，返回 true，否则返回false。

is_writable（判断是否可以写入）

用法：

is_writable(string $filename): bool

参数：

filename：要检查的文件名称

注意：

如果文件存在并且可写则返回 true。filename 参数可以是一个允许进行是否可写检查的目录名。

记住 PHP 也许只能以运行 webserver 的用户名（通常为 'www'）来访问文件。

返回值：

如果文件 filename 存在并且可写则返回 true。 

scandir（列出指定路径中的文件和目录）

用法：

scandir(string $directory, int $sorting_order = SCANDIR_SORT_ASCENDING, ?resource $context = null): array|false

返回 array，包含有 directory 中的文件和目录。

 参数：

directory：要被浏览的目录路径

sorting_order：默认是 0，表示按字母升序排列。如果设置为 SCANDIR_SORT_DESCENDING 或者 1，则表示按字母降序排列。如果设置为 SCANDIR_SORT_NONE，则返回未排列的结果

返回值：

成功则返回包含有文件名的 array，如果失败则返回 false。如果 directory 不是个目录，则返回布尔值 false 并生成一条 E_WARNING 级的错误。

opendir（打开目录句柄）

用法：

opendir(string $directory, ?resource $context = null): resource|false

// 示例

// 获取目录下所有的文件
if ($handle = opendir($dir)) {

  // 读取目录中的所有文件
  while (false !== ($file = readdir($handle))) {

        // 排除当前目录和上级目录
        if ($file != "." && $file != "..") {

        // 将文件名称存入数组
        $files[] = $file;

         }
   }

  // 关闭目录
  closedir($handle);
}

参数：

directory：要打开的目录路径

打开一个目录句柄，可用于之后的closedir()，readdir() 和 rewinddir()调用中

返回值：

 如果成功则返回目录句柄的 resource， 或者在失败时返回 false。

closedir（关闭目录句柄）

用法：

closedir(?resource $dir_handle = null): void

关闭由 dir_handle 指定的目录流。流必须之前被 opendir() 所打开。

参数：

dir_handle：目录句柄的 resource，之前由opendir()所打开的。如果目录句柄没有指定，那么会假定为是opendir()
所打开的最后一个句柄。

返回值：

没有返回值

readdir（读取文件名）

用法：

readdir(?resource $dir_handle = null): string|false

 返回目录中下一个文件的文件名。文件名以在文件系统中的排序返回。

参数：

dir_handle：目录句柄的 resource，之前由opendir()打开

返回值：

成功则返回文件名 或者在失败时返回false

ucfirst（将字符串的首字母转换为大写）

用法：

ucfirst(string $string): string

// 示例

$foo = 'hello world!';
$foo = ucfirst($foo);             // Hello world!

$bar = 'HELLO WORLD!';
$bar = ucfirst($bar);             // HELLO WORLD!
$bar = ucfirst(strtolower($bar)); // Hello world!

将 string 的首字符（如果首字符是 "a"（0x61）到 "z"（0x7a）范围内的 ASCII 字符）转换为大写字母，并返回这个字符串。

注意字母的定义取决于当前区域设定。例如，在默认的 “C” 区域，字符 umlaut-a（ä）将不会被转换。

参数：

string：输入字符串。

返回值：

返回结果字符串。

 

strtolower — 将字符串转化为小写

用法：

strtolower(string $string): string

//示例
$str = "Mary Had A Little Lamb and She LOVED It So";
$str = strtolower($str);
echo $str; // 打印 mary had a little lamb and she loved it so

将 string 中所有的 ASCII 字母字符转换为小写并返回。

"A"（0x41）到 "Z"（0x5a）范围内的字节会通过将每个字节值加 32 转为相应的小写字母。

这可用于转换用 UTF-8 编码的字符串中的 ASCII 字符，但会忽略多字节 UTF-8 字符。要转换多字节非 ASCII 字符，请使用mb_strtolower()

参数值： 

string：输入字符串。

返回值：

返回转换后的小写字符串。

strtoupper — 将字符串转化为大写

用法：

strtoupper(string $string): string

// 示例
$str = "Mary Had A Little Lamb and She LOVED It So";
$str = strtoupper($str);
echo $str; // 打印 MARY HAD A LITTLE LAMB AND SHE LOVED IT SO

将 string 中所有 ASCII 字母字符转换为大写并返回。

"a"（0x61）到 "z"（0x7a）范围内的字节会通过将每个字节值减 32 转为相应的大写字母。

这可用于转换用 UTF-8 编码的字符串中的 ASCII 字符，但会忽略多字节 UTF-8 字符。要转换多字节非 ASCII 字符，请使用mb_strtoupper()
 

参数值： 

string：输入字符串。

返回值：

返回转换后的大写字符串。