在 alpine 容器中使用 php 时，如果 gettimeofday() 函数不可用或报错，通常是因为当前使用的 php 版本（如 php 8.2+）默认移除了该函数，或者编译时未包含必要的扩展。解决办法是改用标准的 time() 函数获取秒级时间戳，或使用 microtime(true) 获取微秒级浮点数时间戳。这两个函数是 php 核心内置的，在所有 alpine 环境均可用，且能完全替代旧版行为。
如何替换 gettimeofday 获取高精度时间
要获取带微秒精度的时间戳，应使用 microtime(true)。该函数返回一个浮点数，整数部分为秒，小数部分为微秒。这与旧版 gettimeofday() 返回数组中的 usec 和 sec 字段逻辑一致，但更简洁且跨平台兼容。
$result = microtime(true); echo $result; // 输出类似 1698765432.123456
运行上述代码将直接输出当前时间的浮点数值。开发者可直接将此值用于性能计时、日志记录或需要高精度的场景。无需任何额外配置，Alpine 镜像自带的 PHP 均支持此函数。
立即学习“PHP免费学习笔记（深入）”；
如何处理 gettimeofday 移除后的兼容性代码
如果项目中存在大量依赖 gettimeofday() 返回数组结构的旧代码，建议封装一个兼容层函数。该函数内部调用 microtime(true) 并格式化为与原 API 一致的关联数组，从而在不修改业务逻辑的前提下完成迁移。
function get_time_compat() {
$now = microtime(true);
return [
'sec' => (int) $now,
'usec' => (int) (($now - (int) $now) * 1000000),
];
}
print_r(get_time_compat());
执行这段代码会输出形如 [sec] => 1698765432 [usec] => 123456 的结构。这种封装方式确保了即使底层实现变更，上层调用者仍可使用熟悉的键名 sec 和 usec。对于新开发的功能，推荐直接使用 microtime(true) 以避免维护兼容层带来的开销。
为什么 Alpine 中某些 PHP 版本不再提供 gettimeofday
PHP 8.2 正式移除了 gettimeofday() 函数，因为 POSIX 标准已不推荐依赖该系统调用，且其返回值在不同操作系统间存在细微差异。Alpine Linux 基于 musl libc，其行为与 glibc 略有不同，因此官方在打包 PHP 时选择彻底移除该函数以统一行为。开发者应转向使用 PHP 核心提供的 time() 或 microtime()，这些函数在 musl 环境下表现稳定且符合现代 PHP 规范。
