PHP-Nmap 库无法通过 Composer 安装，因其未注册 Packagist、缺失 composer.json 和 PSR-4 自动加载配置；推荐改用活跃维护的 spatie/nmap，支持 fluent 接口、超时控制与结果解析。
PHP-Nmap 库本身不支持通过 Composer 直接安装——它没有在 Packagist 注册，也没有 composer.json 文件，强行 composer require 会报 Could not find package php-nmap/php-nmap 错误。
为什么 composer require php-nmap/php-nmap 会失败
这个库最早由 GitHub 用户 php-nmap/php-nmap 维护，但项目长期未更新（最后一次提交在 2016 年），既未发布稳定版 tag，也未提交到 Packagist。Composer 默认只拉取 Packagist 上注册的包，而该库连基本的 composer.json 都缺失（原始仓库里根本没有）。
- 尝试手动添加
"php-nmap/php-nmap": "dev-master"到repositories并 require，会触发Invalid argument supplied for foreach()—— 因为它的代码结构不符合 PSR-4 自动加载规范 - 即使用
vcs类型仓库强制引入，autoload配置缺失导致类无法自动加载，必须手动require文件 - 它依赖系统已安装的
nmap命令行工具，且仅封装了极简的参数拼接逻辑，无超时控制、无错误码解析、无并发支持
替代方案：用 Composer 引入更现代的扫描封装库
推荐改用 spatie/nmap —— 它是活跃维护的 Composer 友好包，提供 fluent 接口、异常处理、结果解析和超时配置。
- 执行
composer require spatie/nmap即可安装 - 确保系统已安装
nmap命令（Ubuntu/Debian：sudo apt install nmap；macOS：brew install nmap） - 基础用法示例：
$nmap = \Spatie\Nmap\Nmap::create();
$result = $nmap
->scan('127.0.0.1')
->topPorts(10)
->timeout(10)
->run();
foreach ($result->hosts as $host) {
echo $host->ip . ' is ' . $host->status . "\n";
}
- 它默认使用
exec()调用系统nmap，不依赖扩展，兼容 PHP 7.4+ - 注意：Web 服务器用户（如 www-data）需有执行
nmap的权限，否则会静默失败或抛出Permission denied
如果坚持用原始 php-nmap，只能手动集成
你得放弃 Composer 管理，转为手动下载+硬编码路径加载。
立即学习“PHP免费学习笔记（深入）”；
- 从
https://github.com/php-nmap/php-nmap/archive/master.zip下载源码，解压后把PhpNmap.php放到项目lib/目录下 - 在代码中显式
require_once 'lib/PhpNmap.php'; - 调用方式极简但脆弱：
$nmap = new PhpNmap();
$result = $nmap->scan('127.0.0.1', '-sP'); // 注意：参数必须自己拼，无校验
// $result 是原始字符串输出，需自行 <code>preg_match</code> 解析
- 它不检查
nmap是否存在，也不捕获 stderr，出错时$result可能为空或混杂错误信息 - 无超时机制，若目标主机不可达，PHP 进程可能卡死（取决于系统 exec 默认行为）
真正麻烦的不是“怎么装”，而是“装完之后怎么可靠地拿到结果”。原始 php-nmap 把解析责任全甩给使用者，而 spatie/nmap 至少把 XML 输出解析、主机/端口对象化这些事做了。如果你要写自动化扫描服务，别省那几行 require —— 权限、超时、错误反馈，每一条都得亲手补全。
