phpwatch / array_key_first_last-polyfill
一个简单的补丁,使 PHP 7.3 的 array_key_first 和 array_key_last 函数对所有版本可用。
Requires
- php: ^5.3 || ^7.0 || ^8.0
Requires (Dev)
- phpunit/phpunit: ^4.8.36 || ^5.7 || ^6.5 || ^7.0 || ^8.0 || ^9.0
This package is auto-updated.
Last update: 2022-11-27 17:40:56 UTC
README
一个补丁,将 PHP 7.3 的 array_key_first 和 array_key_last 函数引入 PHP 5.3 及以后版本。
所有 PHP 7 版本现已停用,为减少升级差距,该项目现在已存档在 GitHub 上,并在 Packagist 上标记为废弃。它将继续工作,但强烈建议依赖此补丁的应用程序迁移到 PHP 8 或更高版本。.
概述
此库提供了一层兼容层,用于引入 PHP 7.3 中的 array_key_first
和 array_key_last
函数。它们提供了完整的功能,但来自用户空间的 PHP 代码。请注意,PHP 7.3 内置的上述函数速度很快,且内存友好,因为它们是用 C 语言编写的。但是,如果您有一个需要这些函数的库,您可以使用此库透明地将该功能引入任何 PHP 5.3 或更高版本的版本。
先决条件
- PHP 5.3 或更高版本。
安装
最简单的方法是使用 composer 安装。
composer require phpwatch/array_key_first_last-polyfill
如果系统中的 array_key_first
和 array_key_last
函数不可用,composer 自动加载器将无缝自动加载由该库提供的文件,以提供相同的功能。
如果您不能使用 Composer,尝试说服做出该决定的人,现在已经不再是 2012 年了。如果那不起作用,您可以在 src/
目录中手动加载这些函数。
用法
用法与 PHP 7.3 本地 array_key_first
和 array_key_last
函数完全相同。
确保包含该文件。如果您使用 Composer,请包含其自动加载文件。如果 array_key_first
和 array_key_last
函数是本地可用的,则此库根本不会加载。如果您不使用 Composer 自动加载器,您需要手动 require
src
目录中的文件。
以下是使用 array_key_first
和 array_key_last
函数的示例。下面的示例应在任何 PHP 版本 5.3 及以后版本中工作,即使 array_key_first
和 array_key_last
函数不是本地可用的。
$array = array(1, 2, 3, 4, 5, 6); $firstKey = array_key_first($array); // 0 $lastKey = array_key_last($array); // 5
开发、测试和贡献
欢迎贡献。请打开一个问题或发送一个 pull-request。请确保在基于 Linux 的平台和 Windows 上运行测试。Windows 使用 CRLF 行结束符,这可能导致您将断言硬编码为期望 LF/CR 偏好平台的特定位置时测试失败。
请注意,从GitHub下载zip文件时,不包含测试和其他开发依赖项。这是为了保持库的大小较小。您需要克隆存储库或将其分支以获取完整源代码。