krubio/perfect-web-kit
Composer 安装命令：
composer require krubio/perfect-web-kit
包简介
Shared PHP 8.5 web-UI toolkit: typed HTTP API client, request/session helpers, fail-closed auth guard, PSR-3 error handling, env loader, and asset utilities.
README 文档
README
Shared PHP 8.5 web-UI toolkit used by the Consigngold storefront (curser-pos-web)
and SaaS admin (curser-pos-admin). It centralizes cross-cutting infrastructure
that was previously duplicated and drifted between the two UI applications.
Contents
| Component | Purpose |
|---|---|
PerfectApp\WebKit\Http\ApiClient |
JSON HTTP client with required timeouts, typed responses, transport exceptions, and bounded retries on idempotent requests only. |
PerfectApp\WebKit\Http\ApiResponse |
Immutable response with classified status helpers. |
PerfectApp\WebKit\Http\ApiClientOptions |
Validated options: base URL, connect/total timeout, TLS mode, retry policy. |
PerfectApp\WebKit\Http\Cookie\CookieJar |
Parse Set-Cookie headers and rebuild a single Cookie request header. |
PerfectApp\WebKit\Request\StringKeyed |
Narrow mixed-key arrays to string-keyed maps. |
PerfectApp\WebKit\Request\ServerParam |
Typed accessor over a $_SERVER snapshot. |
PerfectApp\WebKit\Request\RequestValue |
Narrow mixed values to string/int/float/bool without unsafe casts. |
PerfectApp\WebKit\Session\SessionCookieConfig |
Secure, __Host--capable cookie parameter setter for session_*. |
PerfectApp\WebKit\Auth\FailClosedAuthGuard |
"Deny unless explicitly authenticated" guard for UI requests. |
PerfectApp\WebKit\Bootstrap\PhpErrorHandling |
PSR-3 error/shutdown handler install, with dev/prod display toggle. |
PerfectApp\WebKit\Bootstrap\EnvFileLoader |
Dotenv parser that produces an immutable EnvConfig; does not mutate $_ENV. |
PerfectApp\WebKit\Logging\BootstrapLogger |
Tiny STDERR PSR-3 logger for pre-container bootstrap use. |
PerfectApp\WebKit\Util\UsDateDisplay |
mm-dd-YYYY / dd-mm-YYYY formatting with naive-midnight and timezone rules. |
Assets
assets/sortable-tables.js— PHP-natural-order client-side.data-tablesort.assets/date-from-to-sync.js— Keeps#from/#todate-range inputs coherent on the client.
Storefront / admin ship these files from their asset pipelines; they should be served directly by the web server with long-lived cache headers.
Bin
vendor/bin/check-git-path-case-collisions.php— fail CI when tracked paths collide case-insensitively.vendor/bin/apply-codeception-windows-regex-fix.php— patch vendor Codeception socodecept run functionalworks on Windows / PHP 8.5.
Testing
composer install
composer test
composer phpstan
统计信息
- 总下载量： 1.97k
- 月度下载量： 0
- 日度下载量： 0
- 收藏数： 0
- 点击次数： 0
- 依赖项目数： 0
- 推荐数： 0
其他信息
- 授权协议： MIT
- 更新时间： 2026-04-21