Skip to content

Conversation

@adamtomat
Copy link
Member

@adamtomat adamtomat commented Oct 9, 2025

Dependency Upgrades

Upgrades major version of most packages. This will form the basis of an 8.0 release.

Breaking Changes

PHP - 8.1 - 8.4

Support for PHP < 8.1 has been removed.

Laminas Zend Framework Bridge removed

Any imports that start with Zend\Diactoros must be re-written to Laminas\Diactoros

Facades - blast/facades removed

Blast facades was 10 years out of date, and has been removed. We've decided to take ownership of this code.

All facades will need to be modified as follows:

<?php

namespace Rareloop\Lumberjack\Facades;

- use Blast\Facades\AbstractFacade;
+ use Rareloop\Lumberjack\Facades\AbstractFacade;

class Session extends AbstractFacade
{
    protected static function accessor()
    {
        return 'session';
    }
}

Internally, any calls to \Blast\Facades\FacadeFactory should be replaced by \Rareloop\Lumberjack\FacadeManager

Future work on this looks like adding Laravel-style mocking features.

Encryption

Brought a forked version of Dcrypt into the core that supports PHP 8.4. This requires a namespace update if you are using this anywhere:

-use Dcrypt\AesCbc;
+use Rareloop\Lumberjack\Dcrypt\AesCbc;

Log levels

We now use Monolog\Level objects throughout Lumberjack. Any instances of Monolog\Logger need to be replaced.

For example:

'logs' => [
    'enabled' => true,
    'path' => false,
-    'level' => Monolog\Logger::ERROR,
+    'level' => Monolog\Level::Error,
],

Non-breaking changes

Ignition

We've moved from symfony/debug to spatie/ignition - mirroring #56. This addresses deprecation warnings in #52.

Composer

To support composer update --prefer-lowest we had to set minimum versions on multiple sub-dependencies as composer was bringing in versions that do not support PHP 8.4. These are:

require:

+"illuminate/support": "^10.49",
+"illuminate/pipeline": "^10.49",
+"spatie/backtrace": "^1.8.1",
+"illuminate/conditionable": "^10.49",
+"guzzlehttp/guzzle": "^7.10",
+"spatie/flare-client-php": "^1.10.1"

require-dev:

+"antecedent/patchwork": "^2.2.3"

Copy link
Collaborator

@tommitchelmore tommitchelmore left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Minor comments

@adamtomat adamtomat merged commit 3f67f14 into master Oct 15, 2025
16 checks passed
@adamtomat adamtomat deleted the chore/upgrade-dependencies branch October 15, 2025 11:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants