PHP-ICMP 不是 Composer 可安装包，因其未注册 Packagist 且无 composer.json；推荐改用 PEAR 的 Net_Ping 或 symfony/process 调用系统 ping 命令，兼顾兼容性与安全性。
PHP-ICMP 不是 Composer 可安装的常规包
直接运行 composer require php-icmp 会失败——这个库根本不在 Packagist 上，也没有官方维护的 Composer 包。它是一个纯 PHP 实现的 ICMP 工具，依赖原始 socket 操作，且长期未更新（最后一次提交在 2016 年），作者也未发布任何 composer.json 或注册到 Packagist。
常见错误现象包括：Package php-icmp not found、Could not find a version of package php-icmp matching your minimum-stability，本质是包不存在，不是配置或网络问题。
手动引入 php-icmp 的可行做法
必须下载源码并手动集成。核心步骤如下：
- 从 GitHub 克隆或下载仓库：
https://github.com/pear/Net_Ping（注意：真正可用、兼容现代 PHP 的其实是 PEAR 的Net_Ping，而非名字带 “ICMP” 的冷门项目；php-icmp 原始 repo 已归档，且不支持 PHP 7.4+ 的socket_create参数变更） - 用 Composer 加载本地路径：
{ "autoload": { "psr-4": { "Net\": "vendor/pear/net_ping/Net/" } } }然后运行composer dump-autoload - 或者更轻量：直接 require
Net/Ping.php文件（需确保allow_url_include = Off不干扰，且已启用sockets扩展）
替代方案：用 symfony/process 调用系统 ping 命令更可靠
99% 的生产场景下，调用系统 ping 更稳定、权限可控、无需 root，且避免 PHP socket 权限和 SELinux 限制。
立即学习“PHP免费学习笔记（深入）”；
- 先确认 PHP 进程有执行权限：
exec('ping -c 1 8.8.8.8', $output, $returnCode)—— 若$returnCode !== 0，检查disable_functions是否禁用了exec或shell_exec - 用
symfony/process更安全：$process = new Process(['ping', '-c', '1', '-W', '3', '8.8.8.8']); $process->run(); if ($process->isSuccessful()) { /* 解析 $process->getOutput() */ } - 注意 Windows 路径差异：
ping -n 1而非-c，且超时参数是-w不是-W
真要写原生 ICMP？得直面 socket 权限和 PHP 版本坑
若坚持用原始 socket 发送 ICMP 包（比如绕过系统命令审计），必须满足三个硬条件：
- PHP 编译时启用了
--enable-sockets（多数 Docker 镜像默认关闭） - 脚本以 root 或 CAP_NET_RAW 权限运行（
sudo setcap cap_net_raw+ep $(readlink -f $(which php))） - PHP 8.0+ 中
socket_create(AF_INET, SOCK_RAW, getprotobyname('icmp'))会抛Permission denied，除非明确授权，且部分云环境（如 AWS Lambda、某些容器平台）根本禁用 RAW socket
ICMP 探测里最易被忽略的不是代码怎么写，而是权限模型和运行时上下文 —— 同一段代码，在本地 CLI 成功，在 Nginx + PHP-FPM 下大概率静默失败。
