Laravel 8.77 Released

News

December 22nd, 2021

laravel8.jpg

The Laravel team released 8.77 with attribute cast/accessor improvements, a request date() method to access data as a DateTime instance, MAC address validation, the ability to define custom temporary URLs on storage disks, and the latest changes in the v8.x branch.

Attribute Cast / Accessor Improvements

Taylor Otwell contributed a new way to define attribute accessors and mutators:

1// Old, two-method approach
2public function setTitleAttribute($value)
3{
4 $this->attributes['title'] = strtolower($value);
5}
6 
7// New Approach
8protected function title(): Attribute
9{
10 return new Attribute(
11 set: fn ($value) => strtolower($value),
12 );
13}

Here's an example with both a get and set implementation:

1/**
2 * Get the user's title.
3 */
4protected function title(): Attribute
5{
6 return new Attribute(
7 get: fn ($value) => strtoupper($value),
8 set: fn ($value) => strtolower($value),
9 );
10}

To learn more, check out the pull request description and discussion around this feature.

DateTime Parsing Added to the Request Instance

@Italo contributed a date() method to the request instance, making it convenient to get a date instance from request data:

1// Before
2if ($date = $request->input('when')) {
3 $date = Carbon::parse($datetime);
4}
5 
6// After
7$date = $request->date('when');

Per-connection Predis Prefixes

Ben Tidy contributed the ability to use prefixes on a per-connection basis for Predis. Here’s an example from the pull request of Redis configuration:

1'redis' => [
2 'client' => env('REDIS_CLIENT', 'predis'),
3 
4 'default' => [
5 'host' => env('REDIS_HOST', '127.0.0.1'),
6 'password' => env('REDIS_PASSWORD', null),
7 'port' => env('REDIS_PORT', 6379),
8 'database' => env('REDIS_DB', 0),
9 'prefix' => env('REDIS_PREFIX', 'prefix:'),
10 ],
11 
12 'cache' => [
13 'host' => env('REDIS_HOST', '127.0.0.1'),
14 'password' => env('REDIS_PASSWORD', null),
15 'port' => env('REDIS_PORT', 6379),
16 'database' => env('REDIS_CACHE_DB', 1),
17 'prefix' => env('REDIS_PREFIX', 'prefix2:'),
18 ],
19],

MAC Address Validation Rule

Bilal Al-Massry contributed a mac_address validation rule, to validate a MAC address:

1$trans = $this->getIlluminateArrayTranslator();
2$v = new Validator($trans, ['mac' => 'foo'], ['mac' => 'mac_address']);
3$this->assertFalse($v->passes());
4 
5$trans = $this->getIlluminateArrayTranslator();
6$v = new Validator($trans, ['mac' => '01-23-45-67-89-ab'], ['mac' => 'mac_address']);
7$this->assertTrue($v->passes());
8 
9$trans = $this->getIlluminateArrayTranslator();
10$v = new Validator($trans, ['mac' => '01-23-45-67-89-AB'], ['mac' => 'mac_address']);
11$this->assertTrue($v->passes());

Define Temporary URL Method for Storage

Ash Allen contributed to the ability to define a custom temporary URL logic for the Storage facade. Here are a few examples from the pull request:

1Storage::disk('local')
2 ->buildTemporaryUrlUsing(function ($path, $expiration, $options) {
3 return 'using local';
4 });
5 
6// $url is: 'using local'
7$url = Storage::temporaryUrl('file.jpg', now()->addMinutes(5));

Release Notes

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

v8.77.0

Added

  • Attribute Cast / Accessor Improvements (#40022)
  • Added Illuminate/View/Factory::renderUnless() (#40077)
  • Added datetime parsing to Request instance (#39945)
  • Make it possible to use prefixes on Predis per Connection (#40083)
  • Added rule to validate MAC address (#40098)
  • Added ability to define temporary URL macro for storage (#40100)

Fixed

  • Fixed possible out of memory error when deleting values by reference key from cache in Redis driver (#40039)
  • Added Illuminate/Filesystem/FilesystemManager::setApplication() (#40058)
  • Fixed arg passing in doesntContain (739d847)
  • Translate Enum rule message (#40089)
  • Fixed date validation (#40088)
  • Don’t allow models and except together in PruneCommand.php (f62fe66)

Changed

  • Passthru Eloquent\Query::explain function to Query\Builder:explain for the ability to use database-specific explain commands (#40075)

Filed in:

Paul Redmond

Full stack web developer. Author of Lumen Programming Guide and Docker for PHP Developers.

Laravel News Partners