PHP 項目接入 Stanford Moss 代碼查重系統完整指南

什麼是 Moss？

Moss (Measure Of Software Similarity) 是斯坦福大學開發的代碼相似度檢測系統，廣泛用於課程作業防作弊、開源項目抄襲排查、企業代碼審計。支持 C、C++、Java、Python、PHP、JavaScript 等 20+ 語言，通過特徵指紋算法識別結構相似代碼片段，甚至能檢測變量重命名、語句重排等混淆手段。

一、 獲取用戶 ID（userid）

Moss 免費開放，但需註冊賬號：

1. 發送郵件至 moss@moss.stanford.edu
2. 正文包含兩行：
   registeruser
mail your_email@example.com
3. 等待自動回覆，獲得專屬 `userid`（通常即郵箱前綴或分配的數字 ID）。

二、 PHP 客戶端部署

1. 下載 SDK： 訪問 MOSS-PHP，下載 `moss.php` 放入項目 `vendor/` 或 `library/` 目錄。
2. Composer 安裝（推薦）： `composer require phhere/moss-php`（若庫已發布至 Packagist）。

三、 基礎使用範例

<?php
require_once 'vendor/autoload.php'; // 或 include 'moss.php';

$userid = 'your_moss_userid'; // 替換為你的 userid
$moss = new Moss($userid);

// 設置檢測語言（影響解析器選擇）
$moss->setLanguage('php'); // 可選：c, cc, java, python, javascript, php...

// 添加待檢測文件（支持通配符）
$moss->addFilesByWildcard('app/**/*.php'); // 遞歸掃描
// 或單個文件
$moss->addFile('src/Core/Database.php');

// 添加基準文件（不參與相似度計算，僅作為參考庫）
$moss->addBaseFile('vendor/laravel/framework/src/Illuminate/Database/Connection.php');

// 可選：提交備註
$moss->setCommentString('Quarterly code audit 2024-Q3');

// 發送並獲取報告 URL
$reportUrl = $moss->send();
echo "Moss 報告地址: $reportUrl\n";
// 輸出示例: https://moss.stanford.edu/results/123456789

四、 進階配置與自動化

1. CI/CD 集成（GitHub Actions 示例）

# .github/workflows/moss-check.yml
name: Moss Code Similarity Check
on: [pull_request]
jobs:
  moss:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Setup PHP
        uses: shivammathur/setup-php@v2
        with: { php-version: '8.2' }
      - name: Install Moss PHP SDK
        run: composer require --dev phhere/moss-php
      - name: Run Moss Scan
        env:
          MOSS_USERID: ${{ secrets.MOSS_USERID }}
        run: |
          php -r '
            require "vendor/autoload.php";
            $m = new Moss(getenv("MOSS_USERID"));
            $m->setLanguage("php");
            $m->addFilesByWildcard("app/**/*.php");
            $url = $m->send();
            echo "::notice ::Moss Report: $url";
          '

2. 批量多語言掃描腳本

$langMap = [
    'php'  => ['app/**/*.php', 'src/**/*.php'],
    'js'   => ['resources/js/**/*.js', 'resources/vue/**/*.vue'],
    'sql'  => ['database/migrations/*.php'], // 遷移文件實為 PHP
];
foreach ($langMap as $lang => $patterns) {
    $moss = new Moss($userid);
    $moss->setLanguage($lang);
    foreach ($patterns as $p) $moss->addFilesByWildcard($p);
    $url = $moss->send();
    file_put_contents("moss_report_{$lang}.txt", $url . PHP_EOL, FILE_APPEND);
}

五、 結果解讀與處理建議

• 相似度 > 80%： 極高概率為直接複製，需人工核實業務邏輯是否合理（如公共庫代碼）。
• 50%~80%： 疑似參考重寫，關注核心算法/數據結構是否一致。
• 報告連結有效期： 通常 14 天，建議自動下載 HTML 報告歸檔：
  `wget -q -O "moss_$(date +%F).html" "$reportUrl"`

六、 常見問題排查

結語

將 Moss 接入代碼審查流程，能以極低成本建立「代碼原創性」基線。配合 Git Hooks、CI Gates、定期全量掃描，構建從開發提交到發布上線的多層防作弊/防抄襲體系，守護技術資產純淨度。