如何通过Composer安装 PHP-ICMP 库实现网络探测与 Ping 功能-composer-PHP中文网

php-icmp 不是 composer 可安装包，因其未注册 packagist 且无 composer.json；推荐改用 pear 的 net_ping 或 symfony/process 调用系统 ping 命令，兼顾兼容性与安全性。

如何通过composer安装 php-icmp 库实现网络探测与 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 的可行做法

必须下载源码并手动集成。核心步骤如下：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

从 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 进程有执行权限：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 下大概率静默失败。