Laravel 8.81 Released

The Laravel team released 8.81 with a string scan method, the ability to disable caching in Attribute accessors, a getOrPut() collection method, and more:

#Stringable Scan Method

Amir Rami contributed a scan method to stringable implemented using PHP's sscanf function:

$this->assertSame(
    [123456],
    $this->stringable('SN/123456')
         ->scan('SN/%d')
         ->toArray()
);
 
$this->assertSame(
    ['Otwell', 'Taylor'],
    $this->stringable('Otwell, Taylor')
         ->scan('%[^,],%s')
         ->toArray()
);
 
$this->assertSame(
    ['filename', 'jpg'],
    $this->stringable('filename.jpg')
         ->scan('%[^.].%s')
         ->toArray()
);

#Disable Caching in Attribute Accessors

Declan Norton contributed to the ability to disable caching for attributes being accessed via the new Attribute class. You can use the new API in a few ways:

public function finish(): Attribute
{
    return Attribute::getWithoutCaching(
        fn () => $this->start->addSeconds($this->duration)
    );
}
 
// or
 
public function finish(): Attribute
{
    return Attribute::get(
        fn () => $this->start->addSeconds($this->duration)
    )->disableObjectCaching();
}

Here's an explanation of the use-case from the pull request's description:

I often find myself adding virtual accessors to construct objects based on other attributes within the model, most commonly DateTime instances.

Currently, the result of an accessor is cached if it's an object and only invalidated if the attribute's mutator is called. Scalar types are unaffected.

#Get or Put Collection Method

@eusonlito contributed a getOrPut method to collections which simplifies the use-case where you either want to get an existing key or put the value if it doesn't exist and return the value:

// Still valid,
if ($this->collection->has($key) === false) {
    $this->collection->put($key, $this->create($data));
}
 
return $this->collection->get($key);
 
// Using the `getOrPut()` method with closure
return $this->collection->getOrPut($key, fn () => $this->create($data));
 
// Or pass a fixed value
return $this->collection->getOrPut($key, $value);

#Release Notes

You can see the complete list of new features and updates below and the diff between 8.80.0 and 8.81.0 on GitHub. The following release notes are directly from the changelog:

#v8.81.0

#Added

• Added Illuminate/Support/Stringable::scan() (#40472)
• Allow caching to be disabled for virtual attributes accessors that return an object (#40519)
• Added better bitwise operators support (#40529, def671d)
• Added getOrPut on Collection (#40535)
• Improve PhpRedis flushing (#40544)
• Added Illuminate/Support/Str::flushCache() (#40620)

#Fixed

• Fixed Str::headline/Str::studly with unicode and add Str::ucsplit method (#40499)
• Fixed forgetMailers with MailFake (#40495)
• Pruning Models: Get the default path for the models from a method instead (#40539)
• Fix flushdb for predis cluste (#40446)
• Avoid undefined array key 0 error (#40571)

#Changed

• Allow whitespace in PDO dbname for PostgreSQL (#40483)
• Allows authorizeResource method to receive arrays of models and parameters (#40516)
• Inverse morphable type and id filter statements to prevent SQL errors (#40523)
• Bump voku/portable-ascii to v1.6.1 (#40588, #40610)