高级

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 以及配套库。

页面

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