고급

Markdown으로 보기 GitHub에서 수정 문서 위치 3843abd

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 및 보조 라이브러리를 다룹니다.

페이지

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