Porro - Site Health icon

Porro - Site Health

Version 0.6.0

November 16, 2026
  • Disconnect from Porro. A site connected from the control panel now has a Disconnect button beside Open in Porro on Site health, for admins and users with Connect the site to Porro. It asks first, saying what stops and what carries on, then tells Porro and deletes the key from the site's database. The key goes even if Porro can't be reached; Site health then says Porro wasn't told, and the workspace sees the site as not reporting. The checks in the control panel carry on, and the workspace keeps the site and its history until someone removes it in Porro. You can connect again at any time.
  • php craft porro/disconnect does the same from the terminal, asking first (--force to skip the question, which a script with no terminal needs).
  • A staging or local copy never disconnects: a copy of the live database holds the live site's key, so that would switch the live site off in Porro. There is no button there, and the command refuses unless you add --live.
  • A site connected with PORRO_KEY in its environment has no button: Site health says to remove PORRO_KEY from the environment and deploy, and the command says the same.
  • When the site has been removed in Porro, or given a new key there, the next report is turned away. The site now deletes the old key and Site health says what happened and when, with Connect to Porro to carry on, instead of reporting into nothing. A key in the environment is never deleted.
  • Requires porro/php-core 0.3.9.

Version 0.5.0

November 16, 2026
  • Connect to Porro from the control panel. On the live site, Site health has a Connect to Porro button in place of the porro/connect command: it opens Porro to sign in and approve, and the site is connected when the browser comes back. No key to copy. The key is made on the site and kept in its database, encrypted with Craft's security key; PORRO_KEY in the environment still wins, so sites connected that way are unchanged. Requires porro/php-core 0.3.8, and php craft migrate/all (or applying the update in the control panel) for the new porro_settings table.
  • A new Connect the site to Porro permission, under Porro with Block, unblock and safelist IPs, decides who sees the button. Admins always have it. Without it, Site health shows the command as before.
  • A copy whose CRAFT_ENVIRONMENT isn't production, or with devMode on, shows why it doesn't connect instead of the button. Once connected from the control panel, Site health says which workspace the site is connected to.
  • php craft porro/status says where the key came from: PORRO_KEY, or connected from the control panel.

Version 0.4.0

November 16, 2026
  • Sign in from Porro: with Porro's Sign in to client sites on, Sign in to Craft on the site page in Porro opens the control panel signed in, without a password. Porro posts a one-time, 60-second ticket to /porro/sign-in; the site redeems it with Porro using its own site key and signs in the Craft user with the member's email. It never creates users or changes permissions, only signs in active users who can use the control panel, signs in nobody when two accounts share the email, and asks before switching someone already signed in as another user. It skips Craft's two-step verification, relying on Porro's sign-in, and doesn't elevate the session. It's on for the live site and off on staging and local copies unless they set PORRO_SIGN_IN=true; PORRO_SIGN_IN=false turns it off on the site.
  • php craft porro/cron sends a report straight away once the cron line is added or found and the site is connected, so Porro stops saying cron is missing without waiting 15 minutes. With no PORRO_KEY it says so and sends nothing.
  • With porro/php-core 0.3.6, the cron line points at the current folder on zero-downtime deploys rather than the release folder, which broke after the next deploy. It runs plain php, so a PHP upgrade doesn't break it, and a stale line Porro added earlier is replaced rather than joined by a second.
  • The README has a Scheduling reports section: how to run porro/report on Forge, Ploi, Servd, Craft Cloud, Envoyer, cPanel, Plesk and plain servers.

Version 0.3.6

October 29, 2026
  • With Cloudflare in front of a load balancer that trustedHosts names, requests are now counted as through Cloudflare instead of straight to the server, on an IP's page and in what's recorded. Visitor IPs and blocking were already right.

Version 0.3.5

October 29, 2026
  • Links to porro.dev from the README, the Plugin Store listing and the control panel now carry UTM params, so Porro can tell which connector a visit came from.

Version 0.3.4

October 28, 2026
  • A suspicious request no longer touches the database. It appends one short line to storage/runtime/porro/activity.buf on its server, and the lines are recorded in batches: one read and one write per IP and hour, however big the flood. Requires porro/php-core 0.3.5.
  • The buffer is flushed now and then after a suspicious request, whenever a server hasn't flushed for a minute, before the Activity, IP and Site health pages read activity, and by the 15-minute report and porro/blocklist. php craft porro/activity/flush flushes on demand, or every minute from cron. Flags and the exposed-file alert can lag a little. Blocking is unchanged.
  • Counts are exact again during a flood: sampling only applies when requests are recorded straight away.
  • PORRO_ACTIVITY_BUFFER moves the file, or false turns batching off. Where storage can't be written, requests are recorded straight away, as before.

Version 0.3.3

October 28, 2026
  • Porro → Blocking → Set up Cloudflare: a setup page with three steps that tick themselves off. It lists the token's two permission policies as Cloudflare's dashboard names them (Zone WAF Rules: Edit and Zone: Read on the site's domain, Account Rule Lists: Edit on the account), the .env line with a copy button, and a Connect to Cloudflare button for users who can manage blocking. It says plainly that porro_blocklist is shared by every site on the Cloudflare account. The Blocking page's Cloudflare row now links to it.
  • Account-owned Cloudflare tokens work, through porro/php-core 0.3.2 and later.
  • Suspicious activity, the Cloudflare connection and nginx check-ins now live in Porro's own porro_cache table, so php craft clear-caches/all on deploy no longer wipes the Activity page and its 48 hours of history. Run php craft migrate/all (or apply the update in the control panel). Until then, Craft's cache is used as before.
  • Expired activity rows are cleared hourly by the housekeeping job, and state saved in Craft's cache by earlier versions is carried across once.
  • The IP details page sums up what an IP did over 48 hours, flagged or not:
    • requests per hour, total requests, and how many a block turned away;
    • first and last seen;
    • what its probes were after, e.g. "Exposed services: Docker, MLflow";
    • the responses it got, its hosts and methods;
    • its top paths with their last status, and its user agents.
  • The page also shows how many requests came through Cloudflare and how many came straight to the server. When some came straight to the server, it says that blocking at Cloudflare won't stop them.
  • Once an IP is flagged, all its requests are counted, within 5 minutes; ordinary visitors still cost nothing. Requires porro/php-core 0.3.4, which also bounds what a flood can write: past 300 requests from one IP in an hour, counts are sampled and shown as "about".
  • The method recorded is the one actually sent, so X-Http-Method-Override or _method can't hide a POST flood or grow a record. The IP page reads 48 hours in one query, and expired rows are cleared now and then without cron.

Version 0.3.2

October 28, 2026
  • On zero-downtime deploys (Forge, Envoyer, Deployer), the nginx deny file and the setup page's example config now use a path that outlives the release: shared storage's real path, or the current symlink. A path inside releases/{id} went stale after the next deploy, and nginx -t failed once that release was cleaned up. If your nginx config includes a releases/… path, change it to the one the setup page now shows.
  • The daily blocklist housekeeping on sites without Porro's cron line (protected lists, expired entries, the country file) runs from Craft's queue, so the first Activity or Blocking page of the day no longer waits on the downloads.
  • Requires porro/php-core 0.3.1.

Version 0.3.1

October 28, 2026
  • The plugin's description, on Packagist and in the Plugin Store, covers suspicious activity and IP blocking as well as site health.
  • The README shows Activity, IP details and Blocking, with screenshots.

Version 0.3.0

October 28, 2026
  • Reporting now defaults to off outside production (CRAFT_ENVIRONMENT other than production, prod or live, or devMode on), so a local or staging copy with the live .env doesn't report as the live site. An explicit PORRO_ENABLED=true still reports from anywhere. porro/status and porro/report say why reporting is off.
  • Reports carry CRAFT_ENVIRONMENT (or ENVIRONMENT) as the environment, never the host name Craft falls back to when neither is set.
  • Added Activity: probes for secrets and admin tools, failed sign-ins, 404 bursts and form floods from the last 24 hours, worst first, with each IP's details (network, verified reverse DNS, Tor and Spamhaus lists, fake crawlers) and what it did here.
  • Added Blocking: block an IP or range for 7 days, 30 days or for good, and safelist addresses. Blocked IPs get a 403 before Craft handles the request. Every block and safelist asks first. The full lists have their own searchable, filterable pages.
  • Block at Cloudflare's edge (PORRO_CLOUDFLARE_TOKEN, php craft porro/cloudflare connect) or in nginx (PORRO_BLOCK_NGINX, with a setup page that tracks each server), as the Laravel, Statamic and Filament connectors do.
  • Always protected: Cloudflare, Forge, Google's and Bing's crawlers and private ranges can't be blocked; the Blocking page lists each with why. Forge and the crawlers can be switched off.
  • Suspicious activity shows on Site health too.
  • New permission: Block, unblock and safelist IPs.
  • The control panel nav item is now Porro, with Site health, Activity and Blocking under it.
  • Requires porro/php-core 0.3. Adds the porro_blocklist and porro_safelist tables (php craft up).

Version 0.2.1

October 24, 2026
  • A critical Craft or plugin update now shows as Act now rather than Needs attention.
  • Check again now fetches everything again: PHP and Craft support dates, security advisories, Craft's own update check and Porro's findings. Before, it only re-ran the checks on cached data.
  • The HTTP client stops reading a response once it's over php-core's size limit.
  • Requires porro/php-core 0.2.1: requests to Porro are signed for their method and path, and local issues are only hidden when Porro has raised the same thing.
  • Reports describe the site's database (engine, version, whether it's on the same server, managed provider), so Porro can flag an end-of-life MySQL, MariaDB or PostgreSQL. Only the socket or host is read from the DSN, and neither it, the database name nor any credentials leave the site.

Version 0.2.0

October 23, 2026
  • Added a Porro Site Health control panel section and dashboard widget. Without a Porro account they check security advisories in composer.lock, PHP and Craft support dates, Craft and plugin updates, dev mode, migrations and the queue. Once connected they also check cron and show the site's open Porro findings, linking into Porro.
  • Access follows Craft's Access Porro permission; admins always have it.
  • Added a plugin icon: the Porro mark.
  • Requires porro/php-core 0.2.

Version 0.1.5

October 22, 2026
  • Backup reports from control panel visits and plugin or Craft updates, for when cron is missing, throttled to one per 15 minutes across every server sharing the cache.

Version 0.1.4

October 20, 2026
  • Added porro/report --deploy for deploy scripts.

Version 0.1.3

October 20, 2026
  • Reports include the site's npm lock file.

Version 0.1.2

October 20, 2026
  • porro/connect tells Porro whether cron already runs porro/report.

Version 0.1.1

October 20, 2026
  • php craft porro/cron adds the cron line on its own.

Version 0.1.0

October 20, 2026
  • First release.