# 上級者向け

TailwindPHPはTailwindCSS 4.xを純粋なPHPに1対1で移植したものです。忠実性を基本方針とし、コードベースはオリジナルのTypeScriptプロジェクトをファイル名も構成も含めてそのまま再現しています。これにより、TailwindCSSの各動作にPHP内の対応箇所が明確にあり、上流の変更も推測に頼らず追跡できます。

TailwindCSSポートに属さないものはすべて、明確に区分された1か所にあります: `src/_tailwindphp/`。このディレクトリにはPHP専用のヘルパーが含まれています。Rustの`lightningcss`変換（`LightningCss.php`）、CSSミニファイア（`CssMinifier.php`）、および`TailwindPHP\Lib\*`名前空間下の関連ライブラリの移植版（`lib/`: clsx、tailwind-merge、CVA）です。`src/`以下のそれ以外のすべては、TailwindCSS内のファイルに対応しています。

正確性はTailwind独自のテストスイートに照らして検証されます。テストケースはTailwindCSSの`.test.ts`ファイルから直接抽出され、PHPの出力に対して実行されるため、元の動作から少しでもずれればすぐに失敗します。その結果、ユーティリティ、バリアント、ディレクティブ、プラグイン、CLI、関連ライブラリを網羅する4,427件のテストに合格しています（リリース1.7.0、TailwindCSS v4.3.3に対して）。

## ページ

- **[アーキテクチャ](https://tailwindphp.inline0.dev/ja/docs/advanced/architecture)** — コンパイルパイプライン（parse → scan → compile → optimize → minify）、ソースの構成、`lightningcss`相当機能、`@port-deviation`マーカー規約。
- **[キャッシュとミニファイ](https://tailwindphp.inline0.dev/ja/docs/advanced/caching)** — ファイルベースの出力キャッシュ（`cache`、`cacheTtl`、`clearCache()`）、コンパイラー状態のキャッシュ（`stateCacheFile`）、CSSミニファイアの動作。
- **[パフォーマンスとテスト](https://tailwindphp.inline0.dev/ja/docs/advanced/performance)** — PHP固有の最適化、TailwindCSSとの同等性の検証方法、コード品質の基準。
- **[互換性とアップグレード](https://tailwindphp.inline0.dev/ja/docs/advanced/compatibility)** — 要件、追跡対象のTailwindCSSバージョン、TailwindCSSとの既知の差異、各リリースのアップグレード情報。