PHPackages frosh/tools - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. frosh/tools ActiveShopware-platform-plugin[Utility & Helpers](/categories/utility) frosh/tools =========== Provides some basic things for managing the Shopware Installation 3.12.0(3w ago)88858.1k↓52.1%42[2 issues](https://github.com/FriendsOfShopware/FroshTools/issues)[3 PRs](https://github.com/FriendsOfShopware/FroshTools/pulls)2MITPHPCI passing Since Sep 7Pushed 3w ago4 watchersCompare [ Source](https://github.com/FriendsOfShopware/FroshTools)[ Packagist](https://packagist.org/packages/frosh/tools)[ RSS](/packages/frosh-tools/feed)WikiDiscussions main Synced 2w ago READMEChangelog (10)Dependencies (13)Versions (133)Used By (2) Frosh Tools =========== [](#frosh-tools) [![License: MIT](https://camo.githubusercontent.com/08cef40a9105b6526ca22088bc514fbfdbc9aac1ddbf8d4e6c750e3a88a44dca/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75652e737667)](LICENSE.md)[![Shopware](https://camo.githubusercontent.com/512ff54b0e281285e59fda21e1589af8d85c3bce5a80fcc1cc29fca07252fbb1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53686f70776172652d362e36253230253743253230362e372d3138396566662e737667)](https://www.shopware.com/)[![Packagist](https://camo.githubusercontent.com/dc7cdf2c317fb5ed4214efb29228e68ba70179d5fafe3fa8cfdb9baa7cba16ad/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f66726f73682f746f6f6c732e737667)](https://packagist.org/packages/frosh/tools) **Operator toolkit for Shopware 6** — health checks, cache & queue ops, security audits, logs, Elasticsearch tooling, and more, directly in the Administration. Maintained by [FriendsOfShopware](https://friendsofshopware.com). Repository: [github.com/FriendsOfShopware/FroshTools](https://github.com/FriendsOfShopware/FroshTools) --- Why Frosh Tools? ---------------- [](#why-frosh-tools) Shopware shops accumulate operational work that usually needs SSH, Redis CLIs, Elasticsearch dashboards, or ad-hoc scripts. Frosh Tools brings those day-to-day tasks into the Admin under **Settings → Plugins → Tools**, so merchants and developers can inspect and act without leaving the browser. For operatorsFor developersClear caches & compile themesSystem health + performance recommendationsInspect queues and scheduled tasksFeature flags, state machines, webhooksRead production logsElasticsearch console & index lifecycleSecurity overview + SBOM exportFile integrity for core and extensionsMonitor tasks/queues via CLI mail alertsRedis namespace/tag cleanup helpersCompatible with **Shopware 6.6 and 6.7**. --- Screenshots ----------- [](#screenshots) Full HD (1920×1080) captures from Shopware **6.7** Administration. Images are WebP for a smaller repo footprint. Only screens that show real product value are included — empty states (disabled Elasticsearch, unconfigured Shopmon marketing CTA) are omitted on purpose. ### System Status [](#system-status) Live health checks (PHP, MySQL, queue, tasks, …) plus performance recommendations with documentation-oriented guidance. [![System Status](docs/images/system-status.webp)](docs/images/system-status.webp) ### Security Center [](#security-center) Dependency advisories, runtime end-of-life checks, configuration risks, file integrity — and **Export SBOM** (CycloneDX 1.7 from `composer.lock`). [![Security Center](docs/images/security-center.webp)](docs/images/security-center.webp) ### Cache Manager [](#cache-manager) List cache pools, clear individual pools, compile the theme, and clear PHP OPcache. [![Cache Manager](docs/images/cache.webp)](docs/images/cache.webp) ### Statistics [](#statistics) OPcache hit rate/memory, cache backend metrics, and database server statistics. [![Statistics](docs/images/statistics.webp)](docs/images/statistics.webp) ### Queue Manager [](#queue-manager) Transport overview (Doctrine, Redis, AMQP, …), message sizes, worker heartbeat, browse/retry/delete messages, purge or reset. [![Queue Manager](docs/images/queue.webp)](docs/images/queue.webp) ### Scheduled Tasks [](#scheduled-tasks) Inspect all tasks, edit interval & next run, run a single task, register missing tasks. [![Scheduled Tasks](docs/images/scheduled-tasks.webp)](docs/images/scheduled-tasks.webp) ### State Machine Viewer [](#state-machine-viewer) Interactive diagrams for order, payment, delivery, and other registered state machines. [![State Machine Viewer](docs/images/state-machines.webp)](docs/images/state-machines.webp) ### Log Viewer [](#log-viewer) Browse any file under `var/log/` from the Admin. [![Log Viewer](docs/images/log-viewer.webp)](docs/images/log-viewer.webp) ### Feature Flags [](#feature-flags) List core and extension feature flags; toggle where supported. [![Feature Flags](docs/images/feature-flags.webp)](docs/images/feature-flags.webp) ### Webhooks [](#webhooks) Dedicated list/detail UI for Shopware webhooks (including inline search). [![Webhooks](docs/images/webhooks.webp)](docs/images/webhooks.webp) --- Features -------- [](#features) ### Administration — Tools module [](#administration--tools-module) AreaCapabilities**System Status**Health checkers (PHP/FPM, MySQL, queue lag, scheduled tasks, composer audit summary, debug/prod mode, …) and a large set of **performance recommendations** (admin worker, mail-over-queue, increment storage, OPcache flags, ES, product-stream indexing, …).**Security Center**Severity overview; Packagist dependency advisories; PHP / MySQL / Symfony / Shopware EOL; environment risks; **core & extension file integrity**; **CycloneDX 1.7 SBOM export**.**Cache**Pool listing with clear actions, theme compile, OPcache clear.**Statistics**OPcache, cache-adapter, and database metrics for capacity troubleshooting.**Queue**Multi-transport support (Doctrine, Redis, AMQP, fallback); browse without consuming (or fetch+requeue); retry failed messages; purge transport; reset queue.**Scheduled Tasks**List, run, deactivate; edit interval & next execution; register tasks.**State Machines**Diagram viewer for any registered state machine.**Log Viewer**Read `var/log/*.log` in the browser.**Feature Flags**Inspect and toggle flags from core/plugins.**Elasticsearch**Status, indices, reindex, alias switch, unused/orphaned cleanup, console. Optional `show_all_indices`.**Fastly**Purge all / by URL and basic stats when Fastly is configured.**Shopmon**Optional integration setup for external Shopmon monitoring.**Webhooks**Separate Admin module to create, search, and manage webhooks.### Status badge in the Admin header [](#status-badge-in-the-admin-header) The Shopware version indicator is extended with a compact **health status** (success / warning / error) so problems surface without opening Tools. ### Console commands [](#console-commands) CommandPurpose`frosh:dev:robots-txt`Block crawlers on test shops (`-r` to revert)`frosh:composer-plugin:update`Update Composer-managed plugins`frosh:monitor `Email alert when queues/tasks exceed grace times`frosh:es:delete-unused-indices`Delete unused Elasticsearch indices`frosh:extension:checksum:check [name]`Verify extension file integrity`frosh:extension:checksum:create [name]`Create extension checksum manifests`frosh:redis-namespace:list`List Redis namespaces *(experimental)*`frosh:redis-namespace:cleanup`Clean Redis namespaces (`--dry-run` supported) *(experimental)*`frosh:redis-tag:cleanup`Clean Redis tags`frosh:twig:warmup`Warm Twig template cache`frosh-tools:health-check-json`Print merged health-check results as JSON (CI / monitoring)--- Requirements ------------ [](#requirements) - Shopware **6.6** or **6.7** - PHP version required by your Shopware minor - Admin ACL privilege `frosh_tools:read` (and webhook privileges where applicable) --- Installation ------------ [](#installation) ### Composer (recommended) [](#composer-recommended) ``` composer require frosh/tools bin/console plugin:refresh bin/console plugin:install --activate FroshTools bin/console cache:clear ``` ### Shopware Store package [](#shopware-store-package) ``` composer require store.shopware.com/froshtools bin/console plugin:refresh bin/console plugin:install --activate FroshTools bin/console cache:clear ``` > Store installs need a valid `packages.shopware.com` Composer auth token. ### From Git (development) [](#from-git-development) ``` git clone https://github.com/FriendsOfShopware/FroshTools.git custom/plugins/FroshTools shopware-cli extension prepare custom/plugins/FroshTools shopware-cli extension build custom/plugins/FroshTools bin/console plugin:refresh bin/console plugin:install --activate FroshTools bin/console cache:clear ``` After activation, open **Settings → Plugins → Tools** (or search for “Tools” in the Admin). --- Configuration ------------- [](#configuration) Optional Symfony config — create `config/packages/frosh_tools.yaml`: ``` frosh_tools: # Skip specific health/performance checkers by id (when needed) checker: disabled_checks: [] # Paths that File Checker should not offer to restore file_checker: exclude_files: - vendor/shopware/core/FirstFile.php - vendor/shopware/core/SecondFile.php # Elasticsearch manager: list every index instead of only Shopware prefixes elasticsearch: show_all_indices: false ``` Plugin system config (Admin → Extensions → Frosh Tools): - **Monitor mail address** — recipient for `frosh:monitor` - **Default queue grace time** (minutes) — when a pending message is considered stuck - **Exclude failed queues** — ignore transports whose name contains `failed` (default on) - **Queues to monitor** — optional allowlist, e.g. `async, low_priority` - **Per-queue grace times** — optional overrides, e.g. `async:15, low_priority:60` - **Task grace time** (minutes) — when a scheduled task is considered stuck JSON Schema for IDE validation: [`frosh-tools-schema.json`](frosh-tools-schema.json). --- Monitoring & CI hooks ------------------------- [](#monitoring--ci-hooks) ``` # Human-oriented mail alert (cron) bin/console frosh:monitor # Machine-readable health snapshot bin/console frosh-tools:health-check-json ``` Wire the JSON command into uptime checks, deploy gates, or external monitors. The Security Center **Export SBOM** action produces a CycloneDX 1.7 document suitable for dependency scanners. --- Development ----------- [](#development) ``` # Format / static checks via shopware-cli (Docker) composer format composer check # PHPUnit (from a Shopware project that requires this plugin) composer phpunit ``` Admin sources live under `src/Resources/app/administration`. Rebuild with: ``` shopware-cli extension build custom/plugins/FroshTools # or, from the Shopware root: bin/build-administration.sh ``` --- Links ----- [](#links) - [GitHub Issues](https://github.com/FriendsOfShopware/FroshTools/issues) — bugs & feature requests - [FriendsOfShopware](https://friendsofshopware.com) - [Shopware Store listing](https://store.shopware.com/) (search “Frosh Tools”) - Maintainer: [Soner Sayakci (@shyim)](https://github.com/shyim) --- License ------- [](#license) [MIT](LICENSE.md) ### Health Score 66 — FairBetter than 99% of packages Maintenance95 Actively maintained with recent releases Popularity55 Moderate usage in the ecosystem Community33 Small or concentrated contributor base Maturity69 Established project with proven stability Bus Factor1 Top contributor holds 56.3% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~16 days Recently: every ~4 days Total 110 Last Release 25d ago Major Versions 1.3.3 → 2.1.32024-07-22 1.3.4 → 2.2.02024-08-15 1.3.5 → 2.5.02025-01-08 1.4.0 → 2.6.12025-03-20 2.6.2 → 3.0.02025-04-29 ### Community Maintainers ![](https://www.gravatar.com/avatar/7c45ef9077b73fce78afbfab2fa27e611a453dd77de003e2785ac84105d02bef?d=identicon)[shyim](/maintainers/shyim) --- Top Contributors [![shyim](https://avatars.githubusercontent.com/u/6224096?v=4)](https://github.com/shyim "shyim (342 commits)")[![tinect](https://avatars.githubusercontent.com/u/135993?v=4)](https://github.com/tinect "tinect (119 commits)")[![schneider-felix](https://avatars.githubusercontent.com/u/69912882?v=4)](https://github.com/schneider-felix "schneider-felix (20 commits)")[![M-arcus](https://avatars.githubusercontent.com/u/25648755?v=4)](https://github.com/M-arcus "M-arcus (20 commits)")[![stefanpoensgen](https://avatars.githubusercontent.com/u/22468102?v=4)](https://github.com/stefanpoensgen "stefanpoensgen (19 commits)")[![deepsource-autofix[bot]](https://avatars.githubusercontent.com/in/57168?v=4)](https://github.com/deepsource-autofix[bot] "deepsource-autofix[bot] (18 commits)")[![PheysX](https://avatars.githubusercontent.com/u/28557712?v=4)](https://github.com/PheysX "PheysX (11 commits)")[![Isengo1989](https://avatars.githubusercontent.com/u/8600299?v=4)](https://github.com/Isengo1989 "Isengo1989 (6 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (4 commits)")[![dneustadt](https://avatars.githubusercontent.com/u/9033214?v=4)](https://github.com/dneustadt "dneustadt (4 commits)")[![wexotht](https://avatars.githubusercontent.com/u/6597273?v=4)](https://github.com/wexotht "wexotht (3 commits)")[![roboshyim](https://avatars.githubusercontent.com/u/235691247?v=4)](https://github.com/roboshyim "roboshyim (3 commits)")[![stephan4p](https://avatars.githubusercontent.com/u/40059275?v=4)](https://github.com/stephan4p "stephan4p (3 commits)")[![ImgBotApp](https://avatars.githubusercontent.com/u/31427850?v=4)](https://github.com/ImgBotApp "ImgBotApp (3 commits)")[![wannevancamp](https://avatars.githubusercontent.com/u/3399877?v=4)](https://github.com/wannevancamp "wannevancamp (3 commits)")[![MelvinAchterhuis](https://avatars.githubusercontent.com/u/26538915?v=4)](https://github.com/MelvinAchterhuis "MelvinAchterhuis (2 commits)")[![danielDHH](https://avatars.githubusercontent.com/u/98386071?v=4)](https://github.com/danielDHH "danielDHH (2 commits)")[![deepsourcebot](https://avatars.githubusercontent.com/u/60907429?v=4)](https://github.com/deepsourcebot "deepsourcebot (2 commits)")[![dpopov00](https://avatars.githubusercontent.com/u/79976317?v=4)](https://github.com/dpopov00 "dpopov00 (2 commits)")[![gecolay](https://avatars.githubusercontent.com/u/47757176?v=4)](https://github.com/gecolay "gecolay (2 commits)") --- Tags shopware6-plugin ### Embed Badge ![Health badge](/badges/frosh-tools/health.svg) ``` [![Health](https://phpackages.com/badges/frosh-tools/health.svg)](https://phpackages.com/packages/frosh-tools) ``` ### Alternatives [craftcms/cms Craft CMS 3.6k3.7M3.4k](/packages/craftcms-cms)[civicrm/civicrm-core Open source constituent relationship management for non-profits, NGOs and advocacy organizations. 762297.9k53](/packages/civicrm-civicrm-core)[tempest/framework The PHP framework that gets out of your way. 2.3k37.6k21](/packages/tempest-framework)[cognesy/instructor-php The complete AI toolkit for PHP: unified LLM API, structured outputs, agents, and coding agent control 326127.9k1](/packages/cognesy-instructor-php)[adyen/adyen-shopware6 Official Shopware 6 Plugin to connect to Payment Service Provider Adyen 25119.6k](/packages/adyen-adyen-shopware6)[terminal42/contao-mp_forms An extension for Contao Open Source CMS to create multi steps forms using the form generator 2535.6k7](/packages/terminal42-contao-mp-forms) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)