# 高级

TailwindPHP 是将 TailwindCSS 4.x 移植到纯 PHP 的 1:1 版本。核心原则是忠实还原：代码库逐文件复刻原始 TypeScript 项目——文件名和组织结构都相同——因此 TailwindCSS 中的任何行为在 PHP 中都有明确对应位置，也能毫无猜测地跟踪上游变更。

任何**不属于**TailwindCSS 移植版本的内容，都集中放在一个明确标记的位置：`src/_tailwindphp/`。该目录包含特定于 PHP 的辅助工具——重新实现的 Rust `lightningcss` 变换（`LightningCss.php`）、CSS 压缩器（`CssMinifier.php`），以及位于 `TailwindPHP\Lib\*` 命名空间下的配套库移植版本（`lib/`：clsx、tailwind-merge、CVA）。`src/` 下的其他所有内容都对应 TailwindCSS 中的某个文件。

正确性通过 Tailwind 自带的测试套件验证。测试用例直接从 TailwindCSS 的 `.test.ts` 文件中提取，并针对 PHP 输出运行，因此任何偏离原始行为的情况都会立即导致失败。结果是有 4,427 项测试通过（发布版本 1.7.0，针对 TailwindCSS v4.3.3），覆盖工具、变体、指令、插件、CLI 以及配套库。

## 页面

- **[架构](https://tailwindphp.inline0.dev/zh/docs/advanced/architecture)** — 编译流水线（解析 → 扫描 → 编译 → 优化 → 压缩）、源码布局、对应的 `lightningcss`，以及 `@port-deviation` 标记约定。
- **[缓存与压缩](https://tailwindphp.inline0.dev/zh/docs/advanced/caching)** — 基于文件的输出缓存（`cache`、`cacheTtl`、`clearCache()`）、编译器状态缓存（`stateCacheFile`），以及 CSS 压缩器的作用。
- **[性能与测试](https://tailwindphp.inline0.dev/zh/docs/advanced/performance)** — 特定于 PHP 的优化、如何验证与 TailwindCSS 的一致性，以及代码质量门槛。
- **[兼容性与升级](https://tailwindphp.inline0.dev/zh/docs/advanced/compatibility)** — 要求、跟踪的 TailwindCSS 版本、与 TailwindCSS 的已知差异，以及各版本的升级说明。