[Skill 名] php-vuln-scanner

PHP 依存関係脆弱性スキャナー（php-vuln-scanner）

PHP プロジェクトの Composer 依存関係をスキャンし、既知のセキュリティ脆弱性（CVE/Advisory）を特定し、ルート/エントリポイントとの関連性を推論するフレームワークを提供します。

入力

• source_path：ソースコードのルートディレクトリ

サポート対象：

• composer.json
• composer.lock
• ディレクトリの再帰検索（複数のサブモジュールで composer.lock を検索）

ルールと出力

• ルールマッチング：組み込み/外部ルールセット（例：references/php-vulnerability.yaml、存在する場合は優先）を使用します。
• 出力先：

  {output_path}/vuln_report/
  {project_name}_composer_vuln_report_{timestamp}.md

スキャンフロー（必須）

相互検証の推奨事項：プロジェクト環境で composer audit を実行できる場合は、その出力と本スキルによるルールマッチング結果を相互比較して、CVE のカバレッジを向上させることをお勧めします。composer audit は Packagist のリアルタイムアドバイザリデータベースを使用しており、本スキルの組み込みルールセットに存在する可能性のある時間的盲点を補完できます。両者の和集合を最終的な脆弱性リストとしてください。

1. 依存関係の列挙
   • composer.lock を解析してパッケージ名とバージョンを取得します。
   • 複数モジュールの場合、モジュールごとにグループ化して出力します。
2. 脆弱性マッチング
   • 既知の CVE ルールに対して影響バージョン範囲をマッチングします。
3. トリガーポイント分析（フレームワーク）
   • 既知の高リスクコンポーネントが入り込む可能性のある機能領域を特定します：ルーティングエントリ、シリアライズ/テンプレート、アップロード/ダウンロード、認証チェーン。
   • php-route-mapper を使用してルートを出力した後、「影響を受けるルートの推論」を行うことをお勧めします。
4. コンポーネント->ルート関連付けの推論（必須、欠落している場合はパイプラインを駆動できません）
   • 入力依存関係：routes_{timestamp}.md と params_{timestamp}.md を読み取ります（shared/IO_PATH_CONVENTION.md と一致します。個別に保存される場合は通常 route_mapping/ 下の同名ファイルです。パイプライン結合時は総レポートの同等章を読み取ります）。
   • 証拠の優先順位：
     1. コード内で直接当該コンポーネントのクラス/関数を参照している場合（例：use Vendor\\Pkg\\{value}、new {value}、Vendor\\{value}::）
     2. テンプレート/シリアライズ/アップロード/ネットワーク関連の「既知のアクセスポイント」を通じて当該コンポーネントが存在する機能領域を特定する場合（その後ルートを逆引きします）
     3. 名前のみに基づく推論は最終手段です：⚠️要検証 と明記する必要があります。
   • 各脆弱性コンポーネントについて以下を出力します：
     • コンポーネントのコード参照位置（ファイルパス + 関数/クラス名、行番号がない場合は「要特定」と記述しますが、ファイルパスは提供します）
     • コンポーネントがトリガーする可能性のあるシンク機能領域（SQL/TPL/DESER/FILE/UPLOAD/SSRF/XSS/AUTH など）
     • 推論される影響を受けるルート/エントリポイント（ルートエントリを個別にリストアップする必要があります。省略は禁止です。各エントリには route_id とルート文字列の両方を指定し、php-route-tracer に直接フィードバックできるようにする必要があります）。

出力レポート構造（必須）

# {project_name} - Composer コンポーネント脆弱性スキャンレポート
生成時間: {timestamp}
分析パス: {source_path}

## リスク統計
（Critical/High/Medium/Low で分類し、省略してはなりません）

## 脆弱性の詳細（個別にリストアップ）
=== [CVE-xxxx-xxxx] {コンポーネント} {バージョン} ===
- 影響バージョン:
- 現在バージョン:
- 深刻度:
- 可能性のあるトリガーポイント（推論フレームワーク）:
- コード参照位置（証拠）:
  - ファイル: path/to/xxx.php
  - 証拠: 関数/クラス/呼び出しスニペット（最小限の特定可能なスニペットを提供する必要があります）
- 影響を受けるルート/エントリポイント（route-mapper と組み合わせて、「推論理由」を提供します）:
- ルートリスト（個別にリストアップし、省略は禁止です）:（`route_id` とルート文字列の両方を指定する必要があります）
- 推論理由（1/2/3 のどの優先順位の証拠方法であるかを明確にする必要があります）
- 修正提案:

主要コンポーネントトリガーポイントマトリックス（必須：パイプラインフェーズ 3 を駆動するために使用）

| コンポーネント | ルール/影響レベル | 対応するシンク機能領域 | 影響を受けるルート/エントリポイント数 | 影響を受けるルート/エントリポイント（個別にリストアップ） | 証拠レベル（直接参照/機能領域/要検証） |