shlink

v5.1.0 Breaking

This release includes breaking changes for platform teams planning a safe upgrade.

Published 1mo API Development

View tool

✓ No known CVEs patched

Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

laminas mezzio php rest url-shortener

ReleasePort's take

Light signal

editorial:auto 1mo

Shlink v5.1.0 adds a browser‑condition feature for dynamic redirects and introduces an indexed SHA‑256 column to speed up URL existence checks.

Why it matters: The new indexed `long_url_hash` (SHA‑256) improves URL existence check performance; developers should evaluate its impact on query latency after upgrade.

Summary

AI summary

Updates Deprecated, https://github.com/shlinkio/shlink/issues/2487, and https://github.com/shlinkio/shlink/issues/2555 across a mixed release.

Changes in this release

Type	Severity	Summary	CVE
Feature	Medium	Adds new browser condition for dynamic redirects supporting specific browsers. Adds new browser condition for dynamic redirects supporting specific browsers. Source: llm_adapter@2026-06-11 Confidence: high	—
Dependency	Low	Updates docker image to PHP 8.5 runtime. Updates docker image to PHP 8.5 runtime. Source: llm_adapter@2026-06-11 Confidence: high	—
Performance	Medium	Adds indexed `long_url_hash` column (SHA-256) to improve URL existence checks. Adds indexed `long_url_hash` column (SHA-256) to improve URL existence checks. Source: llm_adapter@2026-06-11 Confidence: high	—
Refactor	Low	Migrates request input mapping, filtering and validation to `cuyz/valinor` library. Migrates request input mapping, filtering and validation to `cuyz/valinor` library. Source: llm_adapter@2026-06-11 Confidence: high	—

Full changelog

Changed

#2487 Create a new long_url_hash column, which is an indexed binary sha256 hash of the long URL. Use it when checking if a URL exists for a particular long URL, improving performance thanks to the index.
#2555 Update docker image to PHP 8.5.
#2590 Migrate to cuyz/valinor for request input mapping, filtering and validation.

Added

#2585 Add new browser condition for dynamic redirects system.

This condition accepts the values chrome, firefox, edge, safari, opera and android_browser, to redirect to different places based on specific known web browsers.
#2583 Support redis clusters with sentinels which have their own ACL authentication.

Removed

Nothing

Fixed

Nothing

Deprecated

Nothing

View diff on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Share on X Share on Bluesky

Track shlink

Get notified when new releases ship.

About shlink

The definitive self-hosted URL shortener

All releases →