New tips for February 2023

Author: PovilasKorop

README.md

@@ -22,21 +22,21 @@ Or if you want the Chinese version:
 [中文版本](https://github.com/Lysice/laravel-tips-chinese/blob/master/README-zh.md)
 
 ---
-**Update 20 December 2022**: Currently there are **344 tips** divided into 14 sections.
+**Update 20 February 2023**: Currently there are **352 tips** divided into 14 sections.
 
 ## Table of contents
 
-- [DB Models and Eloquent](db-models-and-eloquent.md) (94 tips)
-- [Models Relations](models-relations.md) (35 tips)
+- [DB Models and Eloquent](db-models-and-eloquent.md) (97 tips)
+- [Models Relations](models-relations.md) (36 tips)
 - [Migrations](migrations.md) (15 tips)
-- [Views](views.md) (19 tips)
+- [Views](views.md) (20 tips)
 - [Routing](routing.md) (33 tips)
 - [Validation](validation.md) (24 tips)
-- [Collections](collections.md) (9 tips)
-- [Auth](auth.md) (5 tips)
+- [Collections](collections.md) (8 tips)
+- [Auth](auth.md) (6 tips)
 - [Mail](mail.md) (7 tips)
-- [Artisan](artisan.md) (7 tips)
+- [Artisan](artisan.md) (9 tips)
 - [Factories](factories.md) (8 tips)
 - [Log and debug](log-and-debug.md) (8 tips)
 - [API](api.md) (9 tips)
-- [Other](other.md) (71 tips)
+- [Other](other.md) (72 tips)

artisan.md

@@ -3,6 +3,8 @@
 ⬆️ [Go to main menu](README.md#laravel-tips) ⬅️ [Previous (Mail)](mail.md) ➡️ [Next (Factories)](factories.md)
 
 - [Artisan command parameters](#artisan-command-parameters)
+- [Execute a Closure after command runs without errors or has any errors](#execute-a-closure-after-command-runs-without-errors-or-has-any-errors)
+- [Run artisan commands on specific environments](#run-artisan-commands-on-specific-environments)
 - [Maintenance Mode](#maintenance-mode)
 - [Artisan command help](#artisan-command-help)
 - [Exact Laravel version](#exact-laravel-version)
@@ -27,6 +29,34 @@ $name = $this->anticipate('What is your name?', ['Taylor', 'Dayle']);
 $name = $this->choice('What is your name?', ['Taylor', 'Dayle'], $defaultIndex);
 ```
 
+### Execute a Closure after command runs without errors or has any errors
+
+With Laravel scheduler you can execute a Closure when a command runs without errors with the onSuccess() method and also when a command has any errors with the onFailure() method.
+
+```php
+protected function schedule(Schedule $schedule)
+{
+    $schedule->command('newsletter:send')
+        ->mondays()
+        ->onSuccess(fn () => resolve(SendNewsletterSlackNotification::class)->handle(true))
+        ->onFailure(fn () => resolve(SendNewsletterSlackNotification::class)->handle(false));
+}
+```
+
+Tip given by [@wendell_adriel](https://twitter.com/wendell_adriel)
+
+### Run artisan commands on specific environments
+
+Take control of your Laravel scheduled commands. Run them on specific environments for ultimate flexibility.
+
+```php
+$schedule->command('reports:send')
+    ->daily()
+    ->environments(['production', 'staging']);
+```
+
+Tip given by [@LaraShout](https://twitter.com/LaraShout)
+
 ### Maintenance Mode
 
 If you want to enable maintenance mode on your page, execute the down Artisan command:

auth.md

@@ -3,6 +3,7 @@
 ⬆️ [Go to main menu](README.md#laravel-tips) ⬅️ [Previous (Collections)](collections.md) ➡️ [Next (Mail)](mail.md)
 
 - [Check Multiple Permissions at Once](#check-multiple-permissions-at-once)
+- [Authenticate users with more options](#authenticate-users-with-more-options)
 - [More Events on User Registration](#more-events-on-user-registration)
 - [Did you know about Auth::once()?](#did-you-know-about-authonce)
 - [Change API Token on users password update](#change-api-token-on-users-password-update)
@@ -20,6 +21,24 @@ In addition to `@can` Blade directive, did you know you can check multiple permi
 @endcanany
 ```
 
+### Authenticate users with more options
+
+If you only want to authenticate users that are also "activated", for example, it's as simple as passing an extra argument to `Auth::attempt()`.
+
+No need for complex middleware or global scopes.
+
+```php
+Auth::attempt(
+    [
+        ...$request->only('email', 'password'),
+        fn ($query) => $query->whereNotNull('activated_at')
+    ],
+    $this->boolean('remember')
+);
+```
+
+Tip given by [@LukeDowning19](https://twitter.com/LukeDowning19)
+
 ### More Events on User Registration
 
 Want to perform some actions after new user registration? Head to `app/Providers/EventServiceProvider.php` and add more Listeners classes, and then in those classes implement `handle()` method with `$event->user` object
@@ -97,3 +116,4 @@ Gate::before(function (?User $user, $ability) {
     return $user->hasRole('Super Admin') ? true : null;
 });
 ```
+

collections.md

@@ -7,7 +7,6 @@
 - [Multiple Collection Methods in a Row](#multiple-collection-methods-in-a-row)
 - [Calculate Sum with Pagination](#calculate-sum-with-pagination)
 - [Serial no in foreach loop with pagination](#serial-no-in-foreach-loop-with-pagination)
-- [Higher order collection methods](#higher-order-collection-methods)
 - [Higher order collection message](#higher-order-collection-message)
 - [Get an existing key or insert a value if it doesn't exist and return the value](#get-an-existing-key-or-insert-a-value-if-it-doesnt-exist-and-return-the-value)
 - [Static times method](#static-times-method)
@@ -90,27 +89,6 @@ We can use foreach collection items index as serial no (SL) in pagination.
 
 it will solve the issue of next pages(?page=2&...) index count from continue.
 
-### Higher order collection methods
-
-Collections have higher order methods, this are methods that can be chained , like `groupBy()` , `map()` ... Giving you a fluid syntax. This example calculates the
-price per group of products on an offer.
-
-```php
-$offer = [
-        'name'  => 'offer1',
-        'lines' => [
-            ['group' => 1, 'price' => 10],
-            ['group' => 1, 'price' => 20],
-            ['group' => 2, 'price' => 30],
-            ['group' => 2, 'price' => 40],
-            ['group' => 3, 'price' => 50],
-            ['group' => 3, 'price' => 60]
-        ]
-];
-
-$totalPerGroup = collect($offer['lines'])->groupBy('group')->map(fn($group) => $group->sum('price'));
-```
-
 ### Higher order collection message
 
 Collections also provide support for "higher order messages", which are short-cuts for performing common actions on collections.

db-models-and-eloquent.md

@@ -10,6 +10,9 @@
 - [You can write transaction-aware code](#you-can-write-transaction-aware-code)
 - [Eloquent scopes inside of other relationships](#eloquent-scopes-inside-of-other-relationships)
 - [New `rawValue()` method since Laravel 9.37](#new-rawvalue-method-since-laravel-937)
+- [Load data faster when the targeted value is an integer](#load-data-faster-when-the-targeted-value-is-an-integer)
+- [Load data completed between two timestamps](#load-data-completed-between-two-timestamps)
+- [Pass a raw query to order your results](#pass-a-raw-query-to-order-your-results)
 - [Eloquent where date methods](#eloquent-where-date-methods)
 - [Increments and decrements](#increments-and-decrements)
 - [No timestamp columns](#no-timestamp-columns)
@@ -241,7 +244,7 @@ class User extends Model
           static::created(function ($user) {
                // Will send the email only if the
                // transaction is committed
-               DB::afterCommit(function () use ($user) {
+               DB::afterCoommit(function () use ($user) {
                     Mail::send(new WelcomeEmail($user));
                });
           });
@@ -291,6 +294,50 @@ $fullname = UserModel::where('id', $id)
 
 Tip given by [@LoydRG](https://twitter.com/LoydRG/status/1587689148768567298)
 
+### Load data faster when the targeted value is an integer
+
+Instead of using the 𝘄𝗵𝗲𝗿𝗲𝗜𝗻() method to load a large range of data when the targeted value is an integer, use 𝘄𝗵𝗲𝗿𝗲𝗜𝗻𝘁𝗲𝗴𝗲𝗿𝗜𝗻𝗥𝗮𝘄() which is faster than 𝘄𝗵𝗲𝗿𝗲𝗜𝗻().
+
+```php
+// instead of using whereIn
+Product::whereIn('id', range(1, 50))->get();
+
+// use WhereIntegerInRaw method for faster loading
+Product::whereIntegerInRaw('id', range(1, 50))->get();
+```
+
+Tip given by [@LaraShout](https://twitter.com/LaraShout)
+
+### Load data completed between two timestamps
+
+Use 𝘄𝗵𝗲𝗿𝗲𝗕𝗲𝘁𝘄𝗲𝗲𝗻 to load records between two timestamps, you can pass the fallback value using the null coalescing operator (??).
+
+```php
+// Load tasks completed between two timestamps
+Task::whereBetween('completed_at', [
+    $request->from ?? '2023-01-01',
+    $request->to ??  today()->toDateTimeString(),
+]);
+```
+
+Tip given by [@LaraShout](https://twitter.com/LaraShout)
+
+### Pass a raw query to order your results
+
+You can pass a raw query to order your results.
+
+For example, sorting tasks by how long before the due date they were completed.
+
+```php
+// Sort tasks by the task was completed before the due date
+$tasks = Task::query()
+    ->whereNotNull('completed_at')
+    ->oorderByRaw('due_at - completed_at DESC')
+    ->get();
+```
+
+Tip given by [@cosmeescobedo](https://twitter.com/cosmeescobedo)
+
 ### Eloquent where date methods
 
 In Eloquent, check the date with functions `whereDay()`, `whereMonth()`, `whereYear()`, `whereDate()` and `whereTime()`.
@@ -1134,11 +1181,11 @@ $post->author->name ?? ''
 // But you can do it on Eloquent relationship level:
 // this relation will return an empty App\Author model if no author is attached to the post
 public function author() {
-    return $this->belongsTo('App\Author')->withDefault();
+    return $this->belongsTo(Author::class)->withDefault();
 }
 // or
 public function author() {
-    return $this->belongsTo('App\Author')->withDefault([
+    return $this->belongsTo(Author::class)->withDefault([
         'name' => 'Guest Author'
     ]);
 }

migrations.md

@@ -297,7 +297,7 @@ Schema::create('posts', function (Blueprint $table) {
     $table->id();
     $table->string('title');
     $table->timestamp('added_at')->useCurrent();
-    $table->timespamps();
+    $table->timestamps();
 });
 ```
 

models-relations.md

@@ -4,6 +4,7 @@
 
 - [OrderBy on Eloquent relationships](#orderby-on-eloquent-relationships)
 - [Add where statement to Many-to-Many relation](#add-where-statement-to-many-to-many-relation)
+- [Get the newest (or oldest) item of another relation](#get-the-newest-or-oldest-item-of-another-relation)
 - [Conditional relationships](#conditional-relationships)
 - [Raw DB Queries: havingRaw()](#raw-db-queries-havingraw)
 - [Eloquent has() deeper](#eloquent-has-deeper)
@@ -78,6 +79,28 @@ class Developer extends Model
 
 Tip given by [@cosmeescobedo](https://twitter.com/cosmeescobedo/status/1582904416457269248)
 
+### Get the newest (or oldest) item of another relation
+
+Since Laravel 8.42, in an Eloquent model, you can define a relation that will get the newest (or oldest) item of another relation.
+
+```php
+/**
+ * Get the user's latest order.
+ */
+public function latestOrder()
+{
+    return $this->hasOne(Order::class)->latestOfMany();
+}
+
+/**
+ * Get the user's oldest order.
+ */
+public function oldestOrder()
+{
+    return $this->hasOne(Order::class)->oldestOfMany();
+}
+```
+
 ### Conditional relationships
 
 If you notice that you use same relationship often with additional "where" condition, you can create a separate relationship method.

other.md

@@ -12,6 +12,7 @@
 - [Schedule Laravel job based on time zone](#schedule-laravel-job-based-on-time-zone)
 - [Use assertModelMissing instead assertDatabaseMissing](#use-assertmodelmissing-instead-assertdatabasemissing)
 - [Various options to format diffForHumans()](#various-options-to-format-diffforhumans)
+- [Create custom disks at runtime](#create-custom-disks-at-runtime)
 - [When (NOT) to run "composer update"](#when-not-to-run-composer-update)
 - [Composer: Check for Newer Versions](#composer-check-for-newer-versions)
 - [Auto-Capitalize Translations](#auto-capitalize-translations)
@@ -270,6 +271,22 @@ $user->created_at->diffForHumans([
 ```
 => `"17h, 54m, 50s ago"`
 
+### Create custom disks at runtime
+
+Did you know that you can create custom disks at runtime without the need to have the config in your config/filesystems file?
+
+This can be handy to manage files in custom paths without the need of adding them to the config.
+
+```php
+$avatarDisk = Storage::build([
+    'driver' => 'local',
+    'root' => storage_path('app/avatars'),
+]);
+$avatarDisk->put('user_avatar.jpg', $image);
+```
+
+Tip given by [@wendell_adriel](https://twitter.com/wendell_adriel/)
+
 ### When (NOT) to run "composer update"
 
 Not so much about Laravel, but... Never run `composer update` on production live server, it's slow and will "break" repository. Always run `composer update` locally on your computer, commit new `composer.lock` to the repository, and run `composer install` on the live server.
@@ -527,7 +544,7 @@ If you want to see ALL results, you may go to the GitHub Laravel docs repository
 
 ### Filter route:list
 
-New in Laravel 8.34: `php artisan route:list` gets additional flag `--except-path`, so you would filter out the routes you don't want to see. [See original PR](New in Laravel 8.34: `php artisan route:list` gets additional flag `--except-path`, so you would filter out the routes you don't want to see. [See original PR](https://github.com/laravel/framework/pull/36619))
+New in Laravel 8.34: `php artisan route:list` gets additional flag `--except-path`, so you would filter out the routes you don't want to see. [See original PR](https://github.com/laravel/framework/pull/36619)
 
 ### Blade directive for not repeating yourself
 
@@ -735,7 +752,7 @@ class MigrationsTest extends TestCase
         $this->expectNotToPerformAssertions();
 
 
-        Artisan::call('migrate:fresh', ['--path' => '/database/migrations/task1']);
+       Artisan::call('migrate:fresh', ['--path' => '/database/migrations/task1']);
     }
 }
 ```

views.md

@@ -5,6 +5,7 @@
 - [$loop variable in foreach](#loop-variable-in-foreach)
 - [You can use Blade to generate more than HTML](#you-can-use-blade-to-generate-more-than-html)
 - [Short attribute syntax for Blade Components](#short-attribute-syntax-for-blade-components)
+- [Share one variable with multiple views](#share-one-variable-with-multiple-views)
 - [Does view file exist?](#does-view-file-exist)
 - [Error code Blade pages](#error-code-blade-pages)
 - [View without controllers](#view-without-controllers)
@@ -74,6 +75,29 @@ Short syntax:
 <x-profile :$userId></x-profile>
 ```
 
+### Share one variable with multiple views
+
+Have you ever needed to share one variable with multiple views in Laravel? Here's a simple solution for that.
+
+```php
+use App\Models\Post;
+use Illuminate\Support\Facades\View;
+use Illuminate\Support\Facades\Schema;
+use Illuminate\Support\ServiceProvider;
+
+class AppServiceProvider extends ServiceProvider
+{
+    public function boot()
+    {
+        if (Schema::hasTable('posts')) {
+            View::share('recentPosts', Post::latest()->take(3)->get());
+        }
+    }
+}
+```
+
+Tip given by [@codewithdary](https://twitter.com/codewithdary)
+
 ### Does view file exist?
 
 You can check if View file exists before actually loading it.
@@ -92,7 +116,7 @@ return view()->first(['custom.dashboard', 'dashboard'], $data);
 
 ### Error code Blade pages
 
-If you want to create a specific error page for some HTTP code, like 500 - just create a blade file with this code as filename, in `resources/views/errors/500.blade.php`, or `403.blade.php` etc, and it will automatically be loaded in case of that error code.
+If you want to create a specific error page for some HTTP code, like 503 - just create a blade file with this code as filename, in `resources/views/errors/503.blade.php`, or `403.blade.php` etc, and it will automatically be loaded in case of that error code.
 
 ### View without controllers