php 8.6给socket_addrinfo_lookup增加了可选的错误码输出参数,解析失败时可以据此区分eai_again等类别。使用前确认目标8.6的sockets扩展实际提供该签名;部分函数参考页可能尚未同步参数列表,版本迁移说明与目标源码应一起核对。

PHP官方文档中的DNS错误码相关说明。 图源:PHP Documentation Group(CC BY3.0)。
使用目标CLI环境
将代码保存为lookup.php,在有sockets扩展的PHP 8.6 CLI中执行;错误写入STDERR。示例只访问系统解析器,不对外开放主机名查询接口。
对固定主机读取地址与错误码
<?php if (PHP_VERSION_ID < 80600 || !extension_loaded('sockets')) { throw new RuntimeException('需要PHP 8.6和sockets'); }
$errorCode = 0;
$addresses = socket_addrinfo_lookup('localhost', '443', [
'ai_family' => AF_UNSPEC,
'ai_socktype' => SOCK_STREAM,
], $errorCode);
if ($addresses === false) {
$temporary = defined('EAI_AGAIN') && $errorCode === EAI_AGAIN;
fwrite(STDERR, ($temporary ? 'temporary lookup failure' : 'lookup failure') . ' code=' . $errorCode . PHP_EOL);
exit(1);
}
foreach ($addresses as $address) {
echo json_encode(socket_addrinfo_explain($address), JSON_THROW_ON_ERROR), PHP_EOL;
}
按失败类别决定后续策略
临时解析失败可进入有次数与总时限的重试队列;名称不存在、参数错误和系统失败则应分开处理。不要对所有错误无限重试,也不要把不同平台上EAI常量的数字值写死到配置。系统解析器返回哪些地址,受主机、网络和操作系统配置影响。
不要把解析成功视为访问授权
本例只解析localhost,不创建远端连接。真实服务若接受主机输入,还需防止内部地址访问、DNS变化及重定向绕过;一份地址列表并不能替代完整可信目标策略。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。

PHP 8.6新增常量列表的相关章节。 图源:PHP Documentation Group(CC BY3.0)。
第四参数是引用输出,示例先初始化为整数0。与旧版本共用代码时应分支处理签名差异,而不是依赖静默忽略多余参数;日志也不宜无条件暴露内部域名和网络拓扑。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










