PHPackages                             fof/clockwork - 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. [Debugging &amp; Profiling](/categories/debugging)
4. /
5. fof/clockwork

ActiveFlarum-extension[Debugging &amp; Profiling](/categories/debugging)

fof/clockwork
=============

Debug your Flarum forum with Clockwork

1.1.1(3mo ago)05.2k↑59.5%4MITPHPPHP ^8.2CI passing

Since Feb 28Pushed 1mo ago2 watchersCompare

[ Source](https://github.com/FriendsOfFlarum/clockwork)[ Packagist](https://packagist.org/packages/fof/clockwork)[ Docs](https://friendsofflarum.org)[ Fund](https://opencollective.com/fof/donate)[ RSS](/packages/fof-clockwork/feed)WikiDiscussions 2.x Synced yesterday

READMEChangelog (9)Dependencies (6)Versions (21)Used By (0)

FriendsOfFlarum Clockwork
=========================

[](#friendsofflarum-clockwork)

[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667) [![Latest Stable Version](https://camo.githubusercontent.com/da587ddf50173d35fec42ea63b98bb444a3d216d0591a973797dd6000e8f768f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f666f662f636c6f636b776f726b2e737667)](https://packagist.org/packages/fof/clockwork) [![OpenCollective](https://camo.githubusercontent.com/1903c197bb0307e60d6328653532b8a6b9890b898fbc92e314ab39d699491e74/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6f70656e636f6c6c6563746976652d666f662d626c75652e737667)](https://opencollective.com/fof/donate)

A [Flarum](http://flarum.org) extension that integrates [Clockwork](https://underground.works/clockwork/) — a developer tools panel for inspecting and profiling requests in real time.

[![screenshot](https://camo.githubusercontent.com/8997adede46a3968bff05b10684c09b4544f662259b50f7473b11301abd07997/68747470733a2f2f692e696d6775722e636f6d2f6d35356b3852642e706e67)](https://imgur.com/a/JCD6Wk4)

---

What it does
------------

[](#what-it-does)

Once installed and enabled, every HTTP request to your Flarum forum is profiled and stored. You can inspect them using the [Clockwork browser extension](https://underground.works/clockwork/#how-to-use) (available for Chrome and Firefox) or by visiting `/__clockwork` in your browser.

### Performance tab

[](#performance-tab)

- **Timeline** — visualises application boot, request processing, controller logic, and data serialisation broken down by phase.
- **Memory usage** — peak memory consumed per request.

### Database tab

[](#database-tab)

- All SQL queries executed during the request, with bindings, duration, and a stack trace showing where each query originated.

### Cache tab

[](#cache-tab)

- Cache hits, misses, writes, and deletes, with keys and values.

### Queue tab

[](#queue-tab)

- Jobs dispatched during the request, showing job class, queue name, dispatch time, payload, and stack trace.
- When using a real queue driver (Redis, database), each processed job appears as a separate entry with its own timeline, queries, cache operations, and logs — linked back to the HTTP request that dispatched it.

### Redis tab

[](#redis-tab)

- All Redis commands executed during the request or queue job, with parameters, duration, and connection name. Requires [fof/redis](https://github.com/FriendsOfFlarum/redis) to be installed and active.

### Events tab

[](#events-tab)

- Flarum and Laravel events fired during the request, with counts.

### Flarum tab

[](#flarum-tab)

- Installed and enabled extension counts.
- Core version information (Flarum, PHP, MySQL).
- Full extension list with enabled/disabled status.
- Frontend document payload (layout view, app view, page payload) for forum and admin page requests.

---

Installation
------------

[](#installation)

```
composer require fof/clockwork:"*"
```

Enable the extension in your Flarum admin panel. Access is restricted to forum administrators.

---

Updating
--------

[](#updating)

```
composer update fof/clockwork
php flarum cache:clear
```

---

Nginx configuration
-------------------

[](#nginx-configuration)

If you are using the `.nginx.conf` file included with Flarum, add the following **above** the `location /` block to allow Clockwork's assets and data to be served correctly:

```
location ~* /__clockwork/.*\.(css|js|json|png|jpg) {
    try_files /index.php?$query_string /index.php?$query_string;
}
```

---

Browser extension
-----------------

[](#browser-extension)

Install the Clockwork browser extension to view profiling data directly in your browser's developer tools:

- [Chrome](https://chrome.google.com/webstore/detail/clockwork/dmggabnehkmmfmdffgajcflpdjlnoemp)
- [Firefox](https://addons.mozilla.org/en-US/firefox/addon/clockwork-dev-tools/)

Alternatively, visit `https://your-forum.com/__clockwork` to access the built-in web UI without the extension.

---

Links
-----

[](#links)

[![OpenCollective](https://camo.githubusercontent.com/8ea53c451470d1a72789d650c77e2b22eee915f7fbf2cbeeeeaa25f47301efe2/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f6e6174652d667269656e64736f66666c6172756d2d3434414545353f7374796c653d666f722d7468652d6261646765266c6f676f3d6f70656e2d636f6c6c656374697665)](https://opencollective.com/fof/donate)

- [Packagist](https://packagist.org/packages/fof/clockwork)
- [GitHub](https://github.com/FriendsOfFlarum/clockwork)
- [Clockwork](https://underground.works/clockwork/)

An extension by [FriendsOfFlarum](https://github.com/FriendsOfFlarum).

###  Health Score

54

—

FairBetter than 96% of packages

Maintenance86

Actively maintained with recent releases

Popularity24

Limited adoption so far

Community21

Small or concentrated contributor base

Maturity75

Established project with proven stability

 Bus Factor3

3 contributors hold 50%+ of commits

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 ~146 days

Recently: every ~15 days

Total

14

Last Release

48d ago

Major Versions

0.2 → 1.0.02021-06-28

1.0.5 → 2.0.0-beta.12026-03-13

1.x-dev → 2.0.0-beta.22026-03-31

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/16573496?v=4)[IanM](/maintainers/imorland)[@imorland](https://github.com/imorland)

![](https://avatars.githubusercontent.com/u/1630413?v=4)[Gregor Hammerschmidt](/maintainers/GreXXL)[@GreXXL](https://github.com/GreXXL)

![](https://www.gravatar.com/avatar/0538135c1debcef5602dce7ece027909cc832b7a6284ab9189a19aa8de98d60d?d=identicon)[clarkwinkelmann](/maintainers/clarkwinkelmann)

![](https://www.gravatar.com/avatar/1298cdc0b2402a1aa34fb75a254947d655e090d62bd0531311331d369cac934e?d=identicon)[datitisev](/maintainers/datitisev)

---

Top Contributors

[![SychO9](https://avatars.githubusercontent.com/u/20267363?v=4)](https://github.com/SychO9 "SychO9 (17 commits)")[![dsevillamartin](https://avatars.githubusercontent.com/u/6401250?v=4)](https://github.com/dsevillamartin "dsevillamartin (15 commits)")[![imorland](https://avatars.githubusercontent.com/u/16573496?v=4)](https://github.com/imorland "imorland (8 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (8 commits)")[![luceos](https://avatars.githubusercontent.com/u/504687?v=4)](https://github.com/luceos "luceos (8 commits)")[![flarum-bot](https://avatars.githubusercontent.com/u/39334649?v=4)](https://github.com/flarum-bot "flarum-bot (5 commits)")[![davwheat](https://avatars.githubusercontent.com/u/7406822?v=4)](https://github.com/davwheat "davwheat (2 commits)")[![askvortsov1](https://avatars.githubusercontent.com/u/38059171?v=4)](https://github.com/askvortsov1 "askvortsov1 (1 commits)")[![StyleCIBot](https://avatars.githubusercontent.com/u/11048387?v=4)](https://github.com/StyleCIBot "StyleCIBot (1 commits)")

---

Tags

flarumfriendsofflarumflarum

### Embed Badge

![Health badge](/badges/fof-clockwork/health.svg)

```
[![Health](https://phpackages.com/badges/fof-clockwork/health.svg)](https://phpackages.com/packages/fof-clockwork)
```

###  Alternatives

[flarum-lang/russian

Russian language pack for Flarum.

12128.3k](/packages/flarum-lang-russian)[fof/upload

The file upload extension for the Flarum forum with insane intelligence.

191192.5k18](/packages/fof-upload)[flarum-lang/french

French language pack to localize the Flarum forum software plus its official and third-party extensions.

1938.7k](/packages/flarum-lang-french)[fof/byobu

Well integrated, advanced private discussions.

59120.6k13](/packages/fof-byobu)[fof/discussion-language

Specify the language a discussion is written in &amp; sort by language

1034.8k4](/packages/fof-discussion-language)[fof/webhooks

Automatically notify Discord, Slack, and Microsoft Teams when events happen on your Flarum forum.

2419.9k](/packages/fof-webhooks)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
