Laravel Page Speed Laravel Package

Added

• ✨ FormatsBytes Trait: Extracted shared formatBytes() utility into VinkiusLabs\LaravelPageSpeed\Traits\FormatsBytes, eliminating code duplication across ApiPerformanceHeaders and ApiHealthCheck. Both middlewares now use the trait with the complete unit scale (B, KB, MB, GB, TB).

Fixed

• 🧹 ApiHealthCheck: Removed unused use Illuminate\Support\Facades\Queue import (dead code).
• 🧹 ApiResponseCompression: Removed unused use Symfony\Component\HttpFoundation\Response import (dead code).
• 🧹 ElideAttributes: Simplified regex for disabled and selected attributes — removed redundant (.*?) capture group that served no purpose after the [^ >]* character class.

Changed

• 📝 RemoveComments: Marked removeSingleLineCommentFromLine() as [@deprecated](https://github.com/deprecated) — the production pipeline uses removeSingleLineCommentsFromContent() instead, which correctly handles multi-line template literals and complex regex literals.
• 📝 InlineCss: Documented static $uniqueCounter behavior in long-running processes (Laravel Octane, Swoole) for maintainability clarity.
• ♻️ ApiPerformanceHeaders: formatBytes() now includes TB unit (previously stopped at GB) via the shared FormatsBytes trait.

Fixed

• 🐛 ApiCircuitBreaker: Fixed cache driver inconsistency — circuit breaker state now uses the configured API_CACHE_DRIVER instead of the default cache driver, ensuring consistent state sharing in distributed environments.
• 🐛 ApiPerformanceHeaders: Fixed X-Performance-Warning header being silently overwritten when both high query count and slow request conditions triggered simultaneously. Both warnings are now combined.
• 🐛 ApiHealthCheck: Fixed queue health check returning a false positive ok status without actually probing the queue driver. Now calls Queue::connection()->size() to verify connectivity.
• 🐛 ApiETag: Fixed unconditional Cache-Control header overwrite that could conflict with application-level or other middleware caching directives. Now respects existing headers.
• 🐛 ApiResponseCache: Removed unnecessary new Response() instantiation in shouldCache() — uses isEnable() directly.

Changed

• 🛡️ PageSpeed Base: Added Content-Type guard in the base handle() method — web middleware now skips non-HTML responses (application/json, application/xml, etc.), preventing silent data corruption on misconfigured middleware groups.
• 🛡️ TrimUrls: Protocol stripping (https:, http:) is now limited to src, href, and action attributes only, preventing corruption of JavaScript strings, meta tags, and SVG namespaces.
• 🛡️ ApiSecurityHeaders: Changed X-XSS-Protection from deprecated 1; mode=block to 0 as recommended by MDN, relying on CSP for XSS protection instead.
• 📦 composer.json: Simplified PHP version constraint from ^8.2 || ^8.3 to ^8.2, which correctly covers PHP 8.2, 8.3, 8.4, and future 8.x releases.

• 🙏 Special Thanks: Huge thanks to [@DmytroGural](https://github.com/DmytroGural) for contributing these fixes and performance optimizations in PR #217!

Fixed

• 🐛 PageSpeed Base Class: Fixed PCRE stack exhaustion and blank pages in replaceInsideHtmlTags by utilizing the s (PCRE_DOTALL) modifier to avoid nested groups, and added fallback to original content to prevent page breaks on regex failures.
• 🐛 CollapseWhitespace Middleware: Fixed issue where Livewire and Alpine.js attributes (wire:snapshot, wire:effects, x-data, x-init) were corrupted during minification by explicitly preserving them.

Changed

• ⚡ CollapseWhitespace Middleware: Optimized restorePreservedContent by replacing foreach + str_replace loop with native strtr(), significantly improving performance on large HTML payloads.

Fixed

• 🐛 RemoveComments Middleware: Removed broken logPerformanceMetrics() call that passed pre-computed elapsed time instead of raw start time, resulting in wildly inaccurate debug metrics (~1.7 billion ms). The parent PageSpeed::handle() already provides correct, debug-only performance logging.
• 🐛 InlineCss Middleware: Fixed state leak across requests in persistent environments (Laravel Octane, Swoole). Instance properties $class, $style, and $inline are now reset at the beginning of each apply() call.
• 🐛 PageSpeed Base Class: Removed stale static $isEnabled cache that was never cleared, causing runtime configuration changes to be silently ignored in persistent environments.
• 🐛 ApiResponseCache Middleware: Removed orphaned docblock for a deleted supportsTags() method and corrected invalidateCache() return type from [@return](https://github.com/return) void to [@return](https://github.com/return) bool.
• 🐛 Config: Removed duplicate *.doc entry in the skip list.

Changed

• 🧪 Updated ConfigTest to validate correct behavior: isEnable() now reflects runtime configuration changes instead of returning a stale cached value.

Added

• ✅ Laravel 13.x support (#215 by @laravel-shift)
• ✅ PHPUnit 12.x support (^12.5.12)
• ✅ Orchestra Testbench 11.x support

Changed

• 📦 Updated illuminate/support constraint to ^10.0 || ^11.0 || ^12.0 || ^13.0
• 📦 Updated phpunit/phpunit constraint to ^10.5 || ^11.0 || ^12.5.12
• 📦 Updated orchestra/testbench constraint to ^8.0 || ^9.0 || ^10.0 || ^11.0
• 🔄 CI/CD testing matrix expanded to include Laravel 13 on PHP 8.3
• 📝 Updated documentation references to include Laravel 13

Fixed

• 🐛 InlineCss Middleware: Fixed regex pattern to prevent matching framework-specific class attributes (Issues #75, #133, #154)
  • Changed from /class="(.*?)"/ to /(?<![-:])class="(.*?)"/i using negative lookbehind
  • Now correctly ignores ng-class (AngularJS), :class (Alpine.js), v-bind:class (Vue.js)
  • Horizon dashboard now works correctly with InlineCss (Issue #133)
  • AngularJS applications with ng-class work correctly (Issue #75)
  • Alpine.js :class shorthand works correctly (Issue #154)
  • Vue.js v-bind:class works correctly

Added

• ✅ New test suite InlineCssJavaScriptFrameworksTest with 7 comprehensive tests (42 assertions)
• ✅ Tests for AngularJS ng-class compatibility
• ✅ Tests for Alpine.js :class shorthand compatibility
• ✅ Tests for Vue.js v-bind:class compatibility
• ✅ Tests for mixed framework scenarios

⚠️ BREAKING CHANGES

• PHP Requirements: Minimum PHP version increased to 8.2 (was 8.0)
• Laravel Support: Removed support for Laravel 6.x, 7.x, 8.x, and 9.x
• Dependencies: Updated minimum versions for all dependencies

Added

• ✅ Laravel 12.x support
• ✅ Laravel 11.x support
• ✅ PHPUnit 11.x support
• ✅ PHP 8.3 support
• ✅ New tests for ServiceProvider (5 tests)
• ✅ New tests for HtmlSpecs entity (4 tests)
• ✅ GitHub Actions workflow for automated testing

Changed

• 📦 Updated Laravel support to ^10.0 || ^11.0 || ^12.0
• 📦 Updated PHP requirement to ^8.2 || ^8.3
• 📦 Updated PHPUnit to ^10.5 || ^11.0
• 📦 Updated Orchestra Testbench to ^8.0 || ^9.0 || ^10.0
• 📦 Updated Mockery to ^1.6
• 🧪 Migrated all tests from [@test](https://github.com/test) annotation to test_* method naming convention
• 🧹 Removed deprecated $defer property from ServiceProvider
• ✨ Added void return types to ServiceProvider methods
• 📋 Updated phpunit.xml.dist to PHPUnit 11.5 schema

Removed

• ❌ Laravel 6.x, 7.x, 8.x, 9.x support (use v2.x for older Laravel versions)
• ❌ PHP 8.0 and 8.1 support (use v2.x for PHP 8.0/8.1)
• ❌ Deprecated $defer property from ServiceProvider

Testing

• 🎯 Test coverage increased from 24 to 33 tests (37.5% increase)
• ✅ All 33 tests passing with 125 assertions
• 🔄 CI/CD testing across PHP 8.2/8.3 with Laravel 10/11/12/13

Migration Guide

From v2.x to v3.x

Requirements:

• Update PHP to 8.2 or 8.3
• Update Laravel to 10.x, 11.x, or 12.x

Steps:

1. Update your composer.json:

{
    "require": {
        "php": "^8.2 || ^8.3",
        "laravel/framework": "^10.0 || ^11.0 || ^12.0",
        "vinkius-labs/laravel-page-speed": "^3.0"
    }
}

2. Run composer update:

composer update vinkius-labs/laravel-page-speed

3. Clear config cache:

php artisan config:clear
php artisan cache:clear

Breaking Changes:

• If you're extending the ServiceProvider class, remove the $defer property
• If you have custom middleware extending package middleware, ensure compatibility with Laravel 10+

Staying on v2.x:

If you need to stay on Laravel 6-9 or PHP 8.0/8.1, use version constraint:

{
    "require": {
        "vinkius-labs/laravel-page-speed": "^2.1"
    }
}

See previous releases for v2.x changelog.