Upgrade von Laravel 8 auf 9

{
  "require": {
    "php": "^8.0.2",
    "laravel/framework": "^9.0",
    "spatie/laravel-ignition": "^1.0"
  },
  "require-dev": {
    "nunomaduro/collision": "^6.1"
  }
}

composer update

# Nur bei Nutzung von Mailgun ergänzen
composer require symfony/mailgun-mailer symfony/http-client

# Bei Nutzung von Postmark das SwiftMailer-Paket entfernen und ersetzen
composer remove wildbit/swiftmailer-postmark
composer require symfony/postmark-mailer symfony/http-client

// Laravel 8.x: SwiftMailer-basiert
$this->withSwiftMessage(function ($message) {
    $message->getHeaders()->addTextHeader('Custom-Header', 'Header Value');
});

// Laravel 9.x: Symfony-Mailer-basiert
use Symfony\Component\Mime\Email;

$this->withSymfonyMessage(function (Email $message) {
    $message->getHeaders()->addTextHeader('Custom-Header', 'Header Value');
});

return [
    'mailers' => [
        'smtp' => [
            // Konfiguration in Laravel 8.x
            'stream' => [
                'ssl' => [
                    'verify_peer' => false,
                ],
            ],

            // Konfiguration in Laravel 9.x
            'verify_peer' => false,
        ],
    ],
];

# Amazon-S3-Treiber
composer require -W league/flysystem-aws-s3-v3 "^3.0"

# FTP-Treiber
composer require league/flysystem-ftp "^3.0"

# SFTP-Treiber
composer require league/flysystem-sftp-v3 "^3.0"

return [
    'disks' => [
        'public' => [
            'driver' => 'local',
            // Nur aktivieren, wenn Schreibfehler eine Exception auslösen sollen
            'throw' => true,
        ],
    ],
];

// Suche und Aktualisierung von name in der Tabelle des verwandten Modells
$user->roles()->updateOrCreate([
    'name' => 'Administrator',
]);

// Beim Anlegen zusätzlich created_by mergen
$user->roles()->firstOrCreate([
    'name' => 'Administrator',
], [
    'created_by' => $user->id,
]);

public function set($model, $key, $value, $attributes)
{
    // In Laravel 9 kann null übergeben werden
    if ($value === null) {
        return [
            'address_line_one' => null,
            'address_line_two' => null,
        ];
    }

    if (! $value instanceof AddressModel) {
        throw new InvalidArgumentException('Bitte ein AddressModel übergeben.');
    }

    return [
        'address_line_one' => $value->lineOne,
        'address_line_two' => $value->lineTwo,
    ];
}

use Illuminate\Support\Facades\Http;

// Nur für langlaufende API-Aufrufe den Timeout verlängern
$response = Http::timeout(120)->get('https://example.com/api/status');

// Bei Override einer Core-Klasse den Rückgabetyp angleichen
public function offsetGet($key): mixed
{
    return parent::offsetGet($key);
}

return [
    'pgsql' => [
        // Laravel 8.x
        'schema' => 'public',

        // Laravel 9.x
        'search_path' => 'public',
    ],
];

// Vorher
$this->assertDeleted($user);

// Nachher
$this->assertModelMissing($user);

// Ziel-Pfad statt fest codiert über langPath() auflösen
$this->publishes([
    __DIR__.'/../lang' => app()->langPath('vendor/package-name'),
]);

// Vorher
'password' => ['required', 'password'],

// Nachher
'password' => ['required', 'current_password'],

$collection->when(function ($collection) {
    // Der hier zurückgegebene Wert wird als Bedingung ausgewertet
    return false;
}, function ($collection) {
    // Da false zurückkam, wird dies nicht ausgeführt
    $collection->merge([1, 2, 3]);
});

use Illuminate\Support\Facades\Validator;

public function boot()
{
    // Nur aktivieren, wenn das alte Laravel-8-Verhalten benötigt wird
    Validator::includeUnvalidatedArrayKeys();
}