php函数手册;php 函数 收藏 0

100个最常用的PHP函数（记得收藏哦）

下面的列表是最常用的前 100 个 PHP 函数：它们是最常用的 PHP 中自带的函数。

这些函数被命名使用，并从 1 到 100 进行排序。 其他的 4500 个函数现在还没在排名中。 下面频率列表表示在 PHP 代码中使用此函数的频率：参考资料来自于 1900 个 PHP 开源项目。 他们使用了 Exakat static analysis engine 静态分析引擎的 1.2.5 版本进行了审核。平均值是在一个项目中调用此函数的次数。有些函数是被封装使用的，而另一些则是主要函数。

比如说，5 个项目里面有 4 个用到了 count 函数，函数被调用大概 150 次。说明它很流行且被大量使用。

单击函数名跳转到 PHP 文档。在 Top 100 文章的底部有一些总结见解。

• 最常用的 PHP 函数是字符串函数，然后是数组函数，接着是文件函数。 （运算函数不在此列主要是因为他们通常基于运算符）
• 每个函数的链接都指向其对应的文档，事实上许多函数经过发展以及获得了许多新特性，例如：count() 的第二个参数，dirname() 的第二个参数以及 preg_match() 和 str_replace() 接受数组作为参数等。有很多彩蛋。
• 以上 100 个函数没有近期要废弃的计划。
• 在非内置库中，mbstring 排名第一、curl 第二，然后是 gd、filter 和 iconv。
• md5 是最常用的加密函数，其次是 Sha1 (#147)。
• print_r 出现在 1/3 的项目代码里面的某处，任何地方 …
• 由于 dirname(dirname(dirname())) 的调用，dirname 的使用频率非常高。
• array、echo、print、empty、isset 这些没有纳入此排名，它们的使用度肯定是非常高的。
• 如下几个函数应该用运算符替代 : array_push, is_object, func_get_arg, chr, call_user_func。
• 相当多的调用是为了知道值的类型。
• 数据库函数没有在这里排名：他们经常使用类，但功能仍然很频繁。可能是另一个前 100 名？
• 相比写入文件 PHP 更多的应用于读取文件。它还解码 base64。
• 使用键排序比使用值或使用键更频繁。
• 通常使用 file_get_contents 读取文件，使用 fwrite 写入文件。

如果你正在学习 PHP，最好回顾一下这里排名的 100 个功能。它们是你加入一个编码团队后最常找到的功能。它们不是唯一的，但遇到它们时你会不那么惊讶。

PHP 8：函数和方法

作者 | Deepak Vohra

译者 | 刘雅梦

策划 | 丁晓昀

本文属于专题文章《深入浅出 PHP 8》。 根据w3tech的数据，PHP 仍然是 Web 上使用最广泛的脚本语言之一，77.3%的网站使用 PHP 进行服务器端编程。PHP 8 带来了许多新特性和其他改进，我们将在本系列文章中进行探讨。PHP 8.0 添加了对多个函数和方法相关特性的支持，其中一些是对现有特性的改进，而另一些则是全新的特性。PHP 8.1 中增强的可调用语法可用于通过可调用对象创建匿名函数。命名函数参数可以与位置参数一起使用，另外还有一个好处，即命名参数没有顺序，可以通过它们的名称来传达含义。纤程（Fiber）是可中断的函数，增加了对多任务的支持。

对象继承是大多数面向对象语言（包括 PHP）所使用的编程范式。它可以从任何扩展类中重写公共和受保护的方法，以及在类中定义的类属性和常量。在 PHP 中，公共方法不能通过更严格的访问来重新实现，例如将 public 方法设为 private 。为了演示这一点，考虑一个扩展了类 A 的类 B，它重新实现了类 A 中一个公共方法。

运行时，脚本会生成如下的一条错误信息：

相反，在类中定义的私有方法不是继承的，可以在扩展它的类中重新实现。例如，类 B 在下面的脚本中扩展了类 A，并重新实现了类 A 中一个私有方法。

在 PHP 8.0 之前，对扩展类中私有方法的重新声明应用了两个限制：不允许更改 final 和 static 修饰符。如果 private 方法被声明为 final ，则不允许扩展类重新声明该方法。如果私有方法被声明为静态的，那么它将在扩展类中保持静态。而且，如果私有方法没有static 修饰符，则不允许扩展类添加static 修饰符。在 PHP 8 中，这两个限制都被取消了。以下脚本在 PHP 8 中能正常运行。

PHP 8 中唯一的私有方法限制是强制使用 private final 构造函数，当使用静态工厂方法作为替代时，有时会使用private final来禁用构造函数。

该脚本生成如下的错误信息：

在 PHP 8 中，单个可变参数可以替换任意数量的函数参数。考虑下面的脚本，其中类 B 扩展了类 A，并用一个可变参数替换函数 sortArray 的三个参数。

可以使用多个参数调用类 B 中的 sortArray 函数。

输出结果如下所示：

可调用（callable）是可以被调用的 PHP 表达式，例如实例方法、静态方法或可调用对象。例如，可调用可用于为方法调用创建简短的表达式。在 PHP 8.1 中，可以用新的可调用语法：

AVariableCallableExpression(…)

AVariableCallableExpression 表示一个变量可调用表达式。省略号…包含在语法中。

这有两个问题：

1. 语法涉及字符串和数组
2. 在创建可调用时，作用域不会被维护。为了演示这一点，请考虑如下用于对数组进行排序的脚本，其中 getSortArrayMethod() 方法返回 sortArray() 方法的可调用项，[$this，\’sortArray\’] 。

该脚本会生成如下的错误信息：

使用 Closure::fromCallable([$this, \’sortArray\’]) 而不是 [$this, \’sortArray\’] 可以解决作用域问题，但使用 Closure::fromCallable 方法会使调用变得冗长。新的可调用语法解决了作用域和语法冗长的问题。使用新的可调用语法，函数变为：

数组根据输出进行排序：

新语法可以与涉及字符串和数组的传统语法结合使用，以解决作用域问题。创建可调用的作用域将保持不变。

新的可调用语法也可以与静态方法一起使用，如下面的脚本所示，该脚本包含一个静态函数。

输出结果与之前的相同：

以下是调用方法的等效方法：

以下是调用静态方法的等效方法：

即使函数声明了形参，也可以使用新的可调用语法。

如果一个方法声明了任意参数，则必须使用它的参数来调用可调用对象。

简化的可调用语法可以用于任意的 PHP 可调用表达式。用于对象创建的 new 运算符不支持可调用语法，因为可调用语法 AVariableCallableExpression(…) 没有指定构造函数参数的规定，这可能是必需的。以下是不支持的示例：

生成的错误信息为：

以下的脚本演示了受支持的所有可调用表达式。

PHP 8.0 的另一个新特性是支持在函数的参数列表末尾添加一个尾逗号，以提高可读性。任何尾逗号都将被忽略。尾逗号可能并不总是有用的，但如果参数列表很长，或者参数名称很长，则可能会有用，因此可以垂直列出它们。闭包使用列表也支持尾逗号。

PHP 8.0 不支持在必选参数之前声明可选参数。在必选参数之前声明的可选参数都是隐式的必选参数。

下面的脚本演示了必选参数的隐式顺序，以及尾逗号的使用。

输出如下所示：

可空参数不会被视为可选参数，可以使用 $param=null 形式或显式可空类型在必选参数之前声明，脚本如下所示：

PHP 8.0 除了已经支持的位置形参和实参之外，还增加了对命名函数形参和实参的支持。命名参数在函数调用中的传递语法如下所示：

命名参数的一些好处如下所示：

• 可以为函数参数指定一个有意义的名称，使它们能够自我记录
• 按名称传递时，参数与顺序无关
• 可以任意跳过默认值。在下面的脚本中， array_hashtable 函数声明了命名参数。 该函数传递的实参值可以带参数名，也可以不带参数名。当传递位置实参时，使用函数形参声明顺序。但传递命名实参时，可以使用任意顺序。

输出结果为：

命名实参和位置实参可以在同一函数调用中使用。对相同的示例函数 array_hashtable 一起使用混合参数调用。

输出结果为：

请注意，命名参数只能用于位置参数之后。下面的脚本颠倒了顺序，在命名参数之后使用位置参数：

该脚本生成的错误信息为：

即使使用命名参数，也不推荐在必选参数之前声明可选参数，脚本如下所示：

输出将包括已弃用（不推荐）信息：

当在必选命名形参之后使用可选命名形参时，命名实参可用于跳过函数调用中的一个或多个可选形参，脚本如下所示：

输出结果为：

你可以只使用可选参数的子集来调用函数，而不用考虑它们的顺序。

输出结果如下所示：

即使使用可选参数的子集调用函数，也不能在命名参数之后使用位置参数，脚本如下所示：

生成的错误信息以下所示：

PHP 8.1 改进了命名实参特性，在解包实参后支持命名实参，脚本如下所示：

输出如下所示：

但是，命名的参数不能盖前面的参数，脚本如下所示：

输出如下所示：

在 PHP 8.0 之前，如果在静态上下文中调用非静态方法，或者静态调用，则只会收到一条已弃用（不推荐）的信息。使用 8.0，你现在会收到一条错误信息。此外， $this 在静态上下文中是未定义的。为了演示这一点，请考虑如下的脚本，其中使用静态语法 A::aNonStaticMethod() 调用了非静态方法 aNonStaticMethod() 。

如果你运行这个脚本，将会得到如下的错误信息：

PHP 8.1 添加了对纤程（Fiber）多任务的支持。纤程是一个可中断的函数，它具有自己的堆栈。纤程可以从调用堆栈中的任何位置挂起，然后再恢复。新的 Fiber 类是一个 final 类，它支持以下的公共方法：

纤程只能启动一次，但可以挂起并恢复多次。下面的脚本通过使用纤程在数组上执行不同类型的排序来演示多任务处理。纤程在每次排序后都会挂起，然后再恢复执行不同类型的排序。

输出如下所示：

如果纤程在第一次挂起后没有再恢复，则只进行一种类型的排序，这可以通过注释掉对 resume() 的两次调用来实现。

输出的是第一次排序的结果：

PHP 8.0 引入了一个名为 Stringable 的新接口，它只提供一个方法 __toString() 。 __toString() 方法如果在类中提供，将隐式实现 Stringable 接口。考虑提供 __toString() 方法的类 A。

该脚本从 Stringable 的类型检查中返回 1。

然而，反之则不然。如果类实现了 Stringable 接口，则必须显式提供 __toString() 方法，因为该方法不会自动添加，比如：

PHP 8 引入了许多属于其标准库的新函数。

str_contains 函数返回一个 bool 值，用于指示作为第一个参数的字符串是否包含作为第二个参数的字符串。以下脚本将返回 false ：

下面的脚本返回 1，或 true：

str_starts_with 函数返回一个bool 值 ，指示作为第一个参数的字符串是否以作为第二个参数的字符串开头。以下脚本将返回 false 。

下面的脚本将返回 1，或 true。

str_ends_with 函数返回一个bool 值 ，指示作为第一个参数的字符串是否以作为第二个参数的字符串结尾。以下脚本将返回 false 。

下面的脚本将返回 1，或 true。

fdiv 函数将两个数字相除并返回一个 float 值，脚本如下所示：

输出为：

fdatasync 函数在 Windows 上的别名为 fsync ，用于将数据同步到文件上的流中。为了演示它的用法，在包含要运行的 PHP 脚本的脚本目录中创建一个空文件 test.txt 。运行脚本：

随后，打开 test.txt 文件会发现包含如下的文本：

array_is_list 函数返回布尔值，用于指示给定的数组是否为列表。数组必须从 0 开始，键必须是连续的整数，并且顺序正确。下面的脚本演示了 array_is_list 函数：

输出为：

魔术方法是 PHP 中用于覆盖默认操作的特殊方法。它们包括如下的方法，其中构造函数 __construct() 可能是大家最熟悉的：

从 PHP 8.0 开始，魔术方法定义的签名必须要是正确的，这意味着如果在方法参数或返回类型中使用类型声明，则它们必须与文档中的声明相同。新的 __toString() 方法的返回类型必须要声明为 string 。下面的演示将返回类型声明为 int ：

将生成如下的错误信息：

但是，未通过定义声明返回类型的函数（如构造函数）不能声明返回类型，即使是 void 返回类型也不行。示例如下脚本所示：

该脚本将返回如下的错误信息：

所有魔术方法，除了少数例外（例如 __construct() ）外，都必须声明为具有公共可见性。为了演示这一点，声明了一个带有 private 可见性的 __callStatic 。

输出的警告信息为：

尽管可以省略混合返回类型，但方法签名也必须相同。例如，在下面的脚本中，类 A 声明了 __callStatic 而没有指定其返回类型，而类 B 将其第一个参数定义为int ：

输出的错误信息如下所示：

在 PHP 8.1 中，大多数内部方法，即内部类中的方法，都已经“试探性地”开始声明返回类型。试探性地暗示，虽然在 8.1 中只会引发不推荐（Deprecation）通知，但在 9.0 版中，则会输出错误条件信息。因此，任何扩展类都必须声明与内部类相兼容的返回类型，否则将会引发已弃用（不推荐）通知。为了演示这一点，扩展内部类 Directory 并重新声明没有返回类型的函数 read() ：

该脚本将生成已弃用（不推荐）通知：

但是，以下脚本是可以的：

添加 #[\\ReturnTypeWillChange] 属性能抑制已弃用（不推荐）通知：

虽然包含有关方法参数的详细信息的异常堆栈跟踪对调试非常有用，但你可能不希望输出某些敏感参数的参数值，例如与密码和凭据关联的参数值。PHP 8.2 引入了一个名为 \\SensitiveParameter 的新属性，这样，如果使用 \\SensitivyParameter 属性注解方法的参数，则该参数的值不会在异常堆栈跟踪中输出。

为了演示这一点，考虑下面的脚本，其中函数 f1 具有与 \\SensitiveParameter 属性关联的参数 $password 。

为了演示 \\SensitiveParameter 特性，该函数只是抛出一个异常。调用函数：

请注意，异常堆栈跟踪不包含 $password 参数的值，而是列出了 Object(SensitiveParameterValue) 。

内置函数 utf8_encode() 和 utf8_decode() 经常被误解，因为它们的名称意味着对任何字符串进行编码/解码。实际上，这些函数仅用于编码/解码 ISO8859-1，即“Latin-1”字符串。此外，它们生成的错误信息对于调试来说描述性不够。PHP 8.2 已经弃用了这些函数。下面的脚本使用了它们：

对于 PHP 8.2，会输出已弃用（不推荐）通知：

在 PHP 8.2 中，函数 iterator_count 和 iterator_to_array 接受所有可迭代的对象。 iterator_to_array() 函数将迭代器的元素复制到数组中。 iterator_count() 函数对数组的元素进行计数。这些函数接受一个 $iterator 作为第一个参数。在 PHP 8.2 中，$iterator 参数的类型已从 Traversable 扩展为 Traversable|array ，以便接受任意的可迭代值。

下面的脚本演示了它们在 arrays 和 Traversables 中的使用。

输出如下所示：

在这篇 PHP 8 系列文章中，我们讨论了与函数和方法相关的新特性，其中最突出的是命名函数的形参/实参、简化的可调用语法和被称为纤程（Fiber）的可中断函数。

在本系列的下一篇文章中，我们将介绍 PHP 类型系统的新特性。

原文链接：

https://www.infoq.com/articles/php8-functions-methods/

相关阅读：

PHP 8：注解、match 表达式及其他改进

PHP 8：类和枚

本文作者及来源:Renderbus瑞云渲染农场https://www.renderbus.com