# 고급

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 출력에 실행하므로 원래 동작과의 차이가 있으면 즉시 실패합니다. 그 결과 릴리스 1.7.0 기준 4,427개의 테스트가 통과했으며(TailwindCSS v4.3.3 기준), 유틸리티, 변형, 지시문, 플러그인, CLI 및 보조 라이브러리를 다룹니다.

## 페이지

- **[아키텍처](https://tailwindphp.inline0.dev/ko/docs/advanced/architecture)** — 컴파일 파이프라인(parse → scan → compile → optimize → minify), 소스 구성, `lightningcss`에 해당하는 구성, `@port-deviation` 마커 규칙.
- **[캐싱 및 축소](https://tailwindphp.inline0.dev/ko/docs/advanced/caching)** — 파일 기반 출력 캐시(`cache`, `cacheTtl`, `clearCache()`), 컴파일러 상태 캐시(`stateCacheFile`), CSS 축소기의 기능.
- **[성능 및 테스트](https://tailwindphp.inline0.dev/ko/docs/advanced/performance)** — PHP 전용 최적화, TailwindCSS와의 동등성을 검증하는 방법, 코드 품질 기준.
- **[호환성 및 업그레이드](https://tailwindphp.inline0.dev/ko/docs/advanced/compatibility)** — 요구 사항, 추적하는 TailwindCSS 버전, TailwindCSS와의 알려진 차이점, 릴리스별 업그레이드 참고 사항.