Add current requirements section, import note, and upgrade checklist

Author: dereuromark

docs/en/appendices/phpunit-upgrade.md

@@ -1,6 +1,17 @@
 # PHPUnit Upgrade
 
-CakePHP 5 supports PHPUnit 11 and 12. This guide covers migrating from older PHPUnit versions.
+This guide covers the PHPUnit version requirements and migration steps for CakePHP 5.x applications.
+
+## Current Requirements
+
+CakePHP 5.x requires **PHPUnit ^11.5.3 or ^12.1.3**. This means:
+
+- PHPUnit 11.5.3+ requires **PHP 8.2** or later
+- PHPUnit 12.1.3+ requires **PHP 8.3** or later
+
+> [!NOTE]
+> PHPUnit 10 is no longer supported in CakePHP 5.x. If you are still on PHPUnit 10,
+> you must upgrade to PHPUnit 11 or 12.
 
 ## phpunit.xml Adjustments
 
@@ -99,6 +110,8 @@ Common attribute replacements:
 | `@covers` | `#[CoversClass(ClassName::class)]` |
 | `@test` | `#[Test]` |
 
+Remember to import the attribute classes from `PHPUnit\Framework\Attributes`.
+
 ### Test Doubles for Abstract Classes Deprecated
 
 Methods for creating mock objects for abstract classes and traits are hard-deprecated. Testing traits in isolation from the classes that use them is discouraged.
@@ -152,3 +165,13 @@ vendor/bin/rector process tests/
 ```
 
 Configure Rector with PHPUnit rulesets to handle data provider static conversion, annotation to attribute migration, and other changes automatically.
+
+## Upgrade Checklist
+
+Before upgrading PHPUnit versions, ensure:
+
+1. Your test suite runs without deprecation warnings on your current PHPUnit version
+2. All data providers are `public static` methods
+3. You are using attributes instead of annotations (required for PHPUnit 12)
+4. Mock expectations only use `createMock()`, not `createStub()`
+5. Run `vendor/bin/phpunit --migrate-configuration` after upgrading

docs/ja/appendices/phpunit-upgrade.md

@@ -1,6 +1,17 @@
 # PHPUnit アップグレード
 
-CakePHP 5 は PHPUnit 11 および 12 をサポートしています。このガイドでは、古いバージョンの PHPUnit からの移行について説明します。
+このガイドでは、CakePHP 5.x アプリケーションの PHPUnit バージョン要件と移行手順について説明します。
+
+## 現在の要件
+
+CakePHP 5.x は **PHPUnit ^11.5.3 または ^12.1.3** が必要です:
+
+- PHPUnit 11.5.3+ は **PHP 8.2** 以降が必要です
+- PHPUnit 12.1.3+ は **PHP 8.3** 以降が必要です
+
+> [!NOTE]
+> CakePHP 5.x では PHPUnit 10 はサポートされなくなりました。まだ PHPUnit 10 を使用している場合は、
+> PHPUnit 11 または 12 にアップグレードする必要があります。
 
 ## phpunit.xml の調整
 
@@ -96,6 +107,8 @@ public function testSomething(): void
 | `@covers` | `#[CoversClass(ClassName::class)]` |
 | `@test` | `#[Test]` |
 
+アトリビュートクラスは `PHPUnit\Framework\Attributes` からインポートして下さい。
+
 ### 抽象クラスのテストダブルが非推奨に
 
 抽象クラスおよびトレイトのモックオブジェクトを作成するメソッドが非推奨になりました。トレイトを使用するクラスから分離してテストすることは推奨されません。
@@ -149,3 +162,13 @@ vendor/bin/rector process tests/
 ```
 
 Rector の PHPUnit ルールセットを設定することで、data provider の static 変換、アノテーションからアトリビュートへの移行などの変更を自動的に処理できます。
+
+## アップグレードチェックリスト
+
+PHPUnit のバージョンをアップグレードする前に、以下を確認して下さい:
+
+1. 現在の PHPUnit バージョンでテストスイートが非推奨の警告なしに実行できること
+2. すべての data provider が `public static` メソッドであること
+3. アノテーションではなくアトリビュートを使用していること（PHPUnit 12 で必須）
+4. モックのエクスペクテーションが `createStub()` ではなく `createMock()` のみを使用していること
+5. アップグレード後に `vendor/bin/phpunit --migrate-configuration` を実行すること