php-inventory 需手动添加 VCS 仓库并配置 autoload；Class not found 因命名空间/路径不匹配或未执行 dump-autoload；v3 升级需适配 symlink 参数及 PHP 8.1+；Laravel 中须手动绑定服务。

Composer 安装 php-inventory 时提示 “Package not found”

php-inventory 并非 Packagist 官方注册包，直接 composer require php-inventory/php-inventory 会失败。它通常以 GitHub 仓库形式存在，需手动添加仓库源或使用 VCS 方式安装。

• 确认项目根目录下 composer.json 中已声明 "repositories"，例如：

  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/your-vendor/php-inventory"
    }
  ]

• 运行 composer require your-vendor/php-inventory:dev-main（注意替换为实际 vendor 名和分支名）
• 若该库未设 autoload 规则，需在 composer.json 中补全：

  "autoload": {
    "psr-4": {
      "Inventory\": "src/"
    }
  }

  ，再执行 composer dump-autoload

调用 InventoryManager 类时抛出 Class 'InventoryInventoryManager' not found

这是典型的自动加载失效问题，根源常在于命名空间与文件路径不匹配，或未触发 autoload 重生成。

• 检查 src/InventoryManager.php 文件顶部是否声明了 namespace Inventory;
• 确认该文件位于 src/ 目录下（与 composer.json 中 "psr-4" 配置一致）
• 不要手动 require 或 include 类文件——Composer 的 autoloader 会接管，否则易引发重复定义或路径错误
• 运行 composer install 或 composer update 后，务必验证 vendor/autoload.php 是否被正确引入（通常在项目入口如 index.php 中）

升级 php-inventory 导致资产扫描逻辑异常

该库的 scan() 方法行为在 v2.x 和 v3.x 间有 breaking change：v3 默认启用递归软链接解析，而旧项目可能依赖旧版“跳过 symlink”的默认行为。

amphp

使用 AMPHP 框架编写非阻塞异步 PHP 代码，依赖 revolt/event-loop、amphp/amp ^3 及完整 amphp/* 生态（http‑server、http‑client 等）。

下载

• 查看 CHANGELOG.md 或对比 InventoryScanner::scan() 的参数签名变化
• v3+ 版本需显式传参控制 symlink 行为：

  $scanner->scan($path, ['follow_symlinks' => false]);

• 若项目中大量使用 new InventoryManager()，建议封装一层适配器，隔离版本差异
• 注意 v3 要求 PHP >= 8.1，升级前检查 composer.json 中 "php" 约束是否兼容

在 Laravel 项目中注入 InventoryService 失败

Laravel 不会自动绑定第三方库的服务类，InventoryService 需手动注册到容器。

立即学习“PHP免费学习笔记（深入）”；

• 在 AppServiceProvider::register() 中添加：

  $this->app->singleton('inventory.scanner', function ($app) {
      return new InventoryScanner();
  });

• 避免在 config/app.php 的 providers 数组里硬编码第三方服务提供者——php-inventory 没有实现 ServiceProvider 接口
• 若使用 Laravel 10+，可借助 PHP attributes 注册绑定，但前提是库本身支持构造函数注入依赖（检查其 Scanner 是否接受 Filesystem 等实例）

实际集成中最容易卡在仓库配置和 autoload 映射上，而不是代码逻辑本身。别急着写业务，先跑通 composer show your-vendor/php-inventory 和 var_dump(class_exists('Inventory\Scanner'))。