[main] Adjusts for Laravel 11 (#64)

* Adjusts for Laravel 11

* Update resources/docs/blade/creating-chirps.md

Co-authored-by: Julius Kiekbusch <[email protected]>

* Update installation.md

* formatting
"

* Update installation.md

---------

Co-authored-by: Taylor Otwell <[email protected]>
Co-authored-by: Julius Kiekbusch <[email protected]>

Author: 3 people

resources/docs/blade/creating-chirps.md

@@ -47,22 +47,11 @@ We are also going to place these routes behind two [middleware](https://laravel.
 
 use App\Http\Controllers\ChirpController;// [tl! add]
 use Illuminate\Support\Facades\Route;
-// [tl! collapse:start]
-/*
-|--------------------------------------------------------------------------
-| Web Routes
-|--------------------------------------------------------------------------
-|
-| Here is where you can register web routes for your application. These
-| routes are loaded by the RouteServiceProvider within a group which
-| contains the "web" middleware group. Now create something great!
-|
-*/
 
 Route::get('/', function () {
     return view('welcome');
 });
-// [tl! collapse:end]
+
 Route::get('/dashboard', function () {
     return view('dashboard');
 })->middleware(['auth', 'verified'])->name('dashboard');
@@ -429,13 +418,17 @@ class User extends Authenticatable
     ];
 
     /**
-     * The attributes that should be cast.
+     * Get the attributes that should be cast.
      *
-     * @var array<string, string>
+     * @return array<string, string>
      */
-    protected $casts = [
-        'email_verified_at' => 'datetime',
-    ];
+    protected function casts(): array
+    {
+        return [
+            'email_verified_at' => 'datetime',
+            'password' => 'hashed',
+        ];
+    }
     // [tl! collapse:end]
     public function chirps(): HasMany// [tl! add:start]
     {
@@ -478,7 +471,14 @@ You can learn more about Laravel's mass assignment protection in the [documentat
 
 ## Updating the migration
 
-The only thing missing is extra columns in our database to store the relationship between a `Chirp` and its `User` and the message itself. Remember the database migration we created earlier? It's time to open that file to add some extra columns:
+During the creation of the application, Laravel already applied the default migrations that are included in the `database/migrations` directory. You may inspect the current database structure by using the `php artisan db:show` and `php artisan db:table` commands:
+
+```shell
+php artisan db:show
+php artisan db:table users
+```
+
+So, the only thing missing is extra columns in our database to store the relationship between a `Chirp` and its `User` and the message itself. Remember the database migration we created earlier? It's time to open that file to add some extra columns:
 
 ```php filename=databases/migrations/&amp;lt;timestamp&amp;gt;_create_chirps_table.php
 <?php

resources/docs/blade/deleting-chirps.md

@@ -16,17 +16,6 @@ We'll start again by updating our routes to enable the `chirps.destroy` route:
 use App\Http\Controllers\ChirpController;
 use Illuminate\Support\Facades\Route;
 
-/*
-|--------------------------------------------------------------------------
-| Web Routes
-|--------------------------------------------------------------------------
-|
-| Here is where you can register web routes for your application. These
-| routes are loaded by the RouteServiceProvider within a group which
-| contains the "web" middleware group. Now create something great!
-|
-*/
-
 Route::get('/', function () {
     return view('welcome');
 });

resources/docs/blade/editing-chirps.md

@@ -14,17 +14,6 @@ First we will update our routes file to enable the `chirps.edit` and `chirps.upd
 use App\Http\Controllers\ChirpController;
 use Illuminate\Support\Facades\Route;
 
-/*
-|--------------------------------------------------------------------------
-| Web Routes
-|--------------------------------------------------------------------------
-|
-| Here is where you can register web routes for your application. These
-| routes are loaded by the RouteServiceProvider within a group which
-| contains the "web" middleware group. Now create something great!
-|
-*/
-
 Route::get('/', function () {
     return view('welcome');
 });

resources/docs/blade/installation.md

@@ -15,7 +15,7 @@ composer create-project laravel/laravel chirper
 > **Note**
 > You will need a [supported version of PHP](https://www.php.net/supported-versions.php) before continuing. You may check your installation by running the `php -v` command. Alternatively, you may follow the <a href="#docker">instructions for Docker</a>.
 
-After the project has been created, start Laravel's local development server using the Laravel's Artisan CLI serve command:
+For simplicity, Composer's `create-project` command will automatically create a new SQLite database at `database/database.sqlite` to store your application's data. After the project has been created, start Laravel's local development server using Laravel Artisan's `serve` command:
 
 ```none
 cd chirper
@@ -28,12 +28,6 @@ Once you have started the Artisan development server, your application will be a
 <img src="/img/screenshots/fresh.png" alt="A fresh Laravel installation" class="dark:hidden rounded-lg border shadow-lg" />
 <img src="/img/screenshots/fresh-dark.png" alt="A fresh Laravel installation" class="hidden dark:block rounded-lg border-gray-700 shadow-lg" />
 
-For simplicity, you may use SQLite to store your application's data. To instruct Laravel to use SQLite instead of MySQL, update your new application's `.env` file and remove all of the `DB_*` environment variables except for the `DB_CONNECTION` variable, which should be set to `sqlite`:
-
-```ini
-DB_CONNECTION=sqlite
-```
-
 <a name="docker"></a>
 ### Installation via Docker
 
@@ -47,7 +41,7 @@ curl -s "https://laravel.build/chirper" | bash
 
 Sail installation may take several minutes while Sail's application containers are built on your local machine.
 
-By default, the installer will pre-configure Laravel Sail with a number of useful services for your application, including a MySQL database server. You may [customize the Sail services](https://laravel.com/docs/installation#choosing-your-sail-services) if needed.
+By default, the installer will pre-configure Laravel Sail with a number of useful services for your application, including a MySQL database server if you wish to use MySQL instead of SQLite. You may [customize the Sail services](https://laravel.com/docs/installation#choosing-your-sail-services) if needed.
 
 After the project has been created, you can navigate to the application directory and start Laravel Sail:
 
@@ -94,12 +88,6 @@ Breeze will install and configure your front-end dependencies for you, so we jus
 npm run dev
 ```
 
-Finally, open another terminal in your `chirper` project directory and run the initial database migrations to populate the database with the default tables from Laravel and Breeze:
-
-```shell
-php artisan migrate
-```
-
 If you refresh your new Laravel application in the browser, you should now see a "Register" link at the top-right. Follow that to see the registration form provided by Laravel Breeze.
 
 <img src="/img/screenshots/register.png" alt="Laravel registration page" class="rounded-lg border dark:border-none shadow-lg" />

resources/docs/inertia/creating-chirps.md

@@ -49,17 +49,6 @@ use App\Http\Controllers\ChirpController;// [tl! add]
 use Illuminate\Foundation\Application;
 use Illuminate\Support\Facades\Route;
 use Inertia\Inertia;
-// [tl! collapse:start]
-/*
-|--------------------------------------------------------------------------
-| Web Routes
-|--------------------------------------------------------------------------
-|
-| Here is where you can register web routes for your application. These
-| routes are loaded by the RouteServiceProvider within a group which
-| contains the "web" middleware group. Now create something great!
-|
-*/
 
 Route::get('/', function () {
     return Inertia::render('Welcome', [
@@ -69,7 +58,7 @@ Route::get('/', function () {
         'phpVersion' => PHP_VERSION,
     ]);
 });
-// [tl! collapse:end]
+
 Route::get('/dashboard', function () {
     return Inertia::render('Dashboard');
 })->middleware(['auth', 'verified'])->name('dashboard');
@@ -519,13 +508,17 @@ class User extends Authenticatable
     ];
 
     /**
-     * The attributes that should be cast.
+     * Get the attributes that should be cast.
      *
-     * @var array<string, string>
+     * @return array<string, string>
      */
-    protected $casts = [
-        'email_verified_at' => 'datetime',
-    ];
+    protected function casts(): array
+    {
+        return [
+            'email_verified_at' => 'datetime',
+            'password' => 'hashed',
+        ];
+    }
     // [tl! collapse:end]
     public function chirps(): HasMany// [tl! add:start]
     {
@@ -568,7 +561,14 @@ You can learn more about Laravel's mass assignment protection in the [documentat
 
 ## Updating the migration
 
-The only thing missing is extra columns in our database to store the relationship between a `Chirp` and its `User` and the message itself. Remember the database migration we created earlier? It's time to open that file to add some extra columns:
+During the creation of the application, Laravel already applied the default migrations that are included in the `database/migrations` directory. You may inspect the current database structure by using the `php artisan db:show` and `php artisan db:table` commands:
+
+```shell
+php artisan db:show
+php artisan db:table users
+```
+
+So, the only thing missing is extra columns in our database to store the relationship between a `Chirp` and its `User` and the message itself. Remember the database migration we created earlier? It's time to open that file to add some extra columns:
 
 ```php filename=databases/migrations/&amp;lt;timestamp&amp;gt;_create_chirps_table.php
 <?php

resources/docs/inertia/deleting-chirps.md

@@ -18,17 +18,6 @@ use Illuminate\Foundation\Application;
 use Illuminate\Support\Facades\Route;
 use Inertia\Inertia;
 
-/*
-|--------------------------------------------------------------------------
-| Web Routes
-|--------------------------------------------------------------------------
-|
-| Here is where you can register web routes for your application. These
-| routes are loaded by the RouteServiceProvider within a group which
-| contains the "web" middleware group. Now create something great!
-|
-*/
-
 Route::get('/', function () {
     return Inertia::render('Welcome', [
         'canLogin' => Route::has('login'),

resources/docs/inertia/editing-chirps.md

@@ -16,17 +16,6 @@ use Illuminate\Foundation\Application;
 use Illuminate\Support\Facades\Route;
 use Inertia\Inertia;
 
-/*
-|--------------------------------------------------------------------------
-| Web Routes
-|--------------------------------------------------------------------------
-|
-| Here is where you can register web routes for your application. These
-| routes are loaded by the RouteServiceProvider within a group which
-| contains the "web" middleware group. Now create something great!
-|
-*/
-
 Route::get('/', function () {
     return Inertia::render('Welcome', [
         'canLogin' => Route::has('login'),

resources/docs/inertia/installation.md

@@ -15,7 +15,7 @@ composer create-project laravel/laravel chirper
 > **Note**
 > You will need a [supported version of PHP](https://www.php.net/supported-versions.php) before continuing. You may check your installation by running the `php -v` command. Alternatively, you may follow the <a href="#docker">instructions for Docker</a>.
 
-After the project has been created, start Laravel's local development server using the Laravel's Artisan CLI serve command:
+For simplicity, Composer's `create-project` command will automatically create a new SQLite database at `database/database.sqlite` to store your application's data. After the project has been created, start Laravel's local development server using Laravel Artisan's `serve` command:
 
 ```none
 cd chirper
@@ -28,12 +28,6 @@ Once you have started the Artisan development server, your application will be a
 <img src="/img/screenshots/fresh.png" alt="A fresh Laravel installation" class="dark:hidden rounded-lg border shadow-lg" />
 <img src="/img/screenshots/fresh-dark.png" alt="A fresh Laravel installation" class="hidden dark:block rounded-lg border-gray-700 shadow-lg" />
 
-For simplicity, you may use SQLite to store your application's data. To instruct Laravel to use SQLite instead of MySQL, update your new application's `.env` file and remove all of the `DB_*` environment variables except for the `DB_CONNECTION` variable, which should be set to `sqlite`:
-
-```ini
-DB_CONNECTION=sqlite
-```
-
 <a name="docker"></a>
 ### Installation via Docker
 
@@ -47,7 +41,7 @@ curl -s "https://laravel.build/chirper" | bash
 
 Sail installation may take several minutes while Sail's application containers are built on your local machine.
 
-By default, the installer will pre-configure Laravel Sail with a number of useful services for your application, including a MySQL database server. You may [customize the Sail services](https://laravel.com/docs/installation#choosing-your-sail-services) if needed.
+By default, the installer will pre-configure Laravel Sail with a number of useful services for your application, including a MySQL database server if you wish to use MySQL instead of SQLite. You may [customize the Sail services](https://laravel.com/docs/installation#choosing-your-sail-services) if needed.
 
 After the project has been created, you can navigate to the application directory and start Laravel Sail:
 
@@ -100,12 +94,6 @@ Breeze will install and configure your front-end dependencies for you, so we jus
 npm run dev
 ```
 
-Finally, open another terminal in your `chirper` project directory and run the initial database migrations to populate the database with the default tables from Laravel and Breeze:
-
-```shell
-php artisan migrate
-```
-
 If you refresh your new Laravel application in the browser, you should now see a "Register" link at the top-right. Follow that to see the registration form provided by Laravel Breeze.
 
 <img src="/img/screenshots/register.png" alt="Laravel registration page" class="rounded-lg border dark:border-none shadow-lg" />

resources/docs/livewire/creating-chirps.md

@@ -44,18 +44,7 @@ Because we're using Livewire, we only need to define a single `Route::get` route
 
 use App\Http\Controllers\ChirpController;// [tl! add]
 use Illuminate\Support\Facades\Route;
-// [tl! collapse:start]
-/*
-|--------------------------------------------------------------------------
-| Web Routes
-|--------------------------------------------------------------------------
-|
-| Here is where you can register web routes for your application. These
-| routes are loaded by the RouteServiceProvider and all of them will
-| be assigned to the "web" middleware group. Make something great!
-|
-*/
-// [tl! collapse:end]
+
 Route::view('/', 'welcome');
 // [tl! add:start]
 Route::get('chirps', [ChirpController::class, 'index'])
@@ -362,13 +351,17 @@ class User extends Authenticatable
     ];
 
     /**
-     * The attributes that should be cast.
+     * Get the attributes that should be cast.
      *
-     * @var array<string, string>
+     * @return array<string, string>
      */
-    protected $casts = [
-        'email_verified_at' => 'datetime',
-    ];
+    protected function casts(): array
+    {
+        return [
+            'email_verified_at' => 'datetime',
+            'password' => 'hashed',
+        ];
+    }
     // [tl! collapse:end]
     public function chirps(): HasMany// [tl! add:start]
     {
@@ -411,7 +404,14 @@ You can learn more about Laravel's mass assignment protection in the [documentat
 
 ## Updating the migration
 
-The only thing missing is extra columns in our database to store the relationship between a `Chirp` and its `User` and the message itself. Remember the database migration we created earlier? It's time to open that file to add some extra columns:
+During the creation of the application, Laravel already applied the default migrations that are included in the `database/migrations` directory. You may inspect the current database structure by using the `php artisan db:show` and `php artisan db:table` commands:
+
+```shell
+php artisan db:show
+php artisan db:table users
+```
+
+So, the only thing missing is extra columns in our database to store the relationship between a `Chirp` and its `User` and the message itself. Remember the database migration we created earlier? It's time to open that file to add some extra columns:
 
 ```php filename=databases/migrations/&amp;lt;timestamp&amp;gt;_create_chirps_table.php
 <?php

resources/docs/livewire/installation.md

@@ -15,7 +15,7 @@ composer create-project laravel/laravel chirper
 > **Note**
 > You will need a [supported version of PHP](https://www.php.net/supported-versions.php) before continuing. You may check your installation by running the `php -v` command. Alternatively, you may follow the <a href="#docker">instructions for Docker</a>.
 
-After the project has been created, start Laravel's local development server using the Laravel's Artisan CLI serve command:
+For simplicity, Composer's `create-project` command will automatically create a new SQLite database at `database/database.sqlite` to store your application's data. After the project has been created, start Laravel's local development server using the Laravel Artisan's `serve` command:
 
 ```none
 cd chirper
@@ -28,12 +28,6 @@ Once you have started the Artisan development server, your application will be a
 <img src="/img/screenshots/fresh.png" alt="A fresh Laravel installation" class="dark:hidden rounded-lg border shadow-lg" />
 <img src="/img/screenshots/fresh-dark.png" alt="A fresh Laravel installation" class="hidden dark:block rounded-lg border-gray-700 shadow-lg" />
 
-For simplicity, you may use SQLite to store your application's data. To instruct Laravel to use SQLite instead of MySQL, update your new application's `.env` file and remove all of the `DB_*` environment variables except for the `DB_CONNECTION` variable, which should be set to `sqlite`:
-
-```ini
-DB_CONNECTION=sqlite
-```
-
 <a name="docker"></a>
 ### Installation via Docker
 
@@ -47,7 +41,7 @@ curl -s "https://laravel.build/chirper" | bash
 
 Sail installation may take several minutes while Sail's application containers are built on your local machine.
 
-By default, the installer will pre-configure Laravel Sail with a number of useful services for your application, including a MySQL database server. You may [customize the Sail services](https://laravel.com/docs/installation#choosing-your-sail-services) if needed.
+By default, the installer will pre-configure Laravel Sail with a number of useful services for your application, including a MySQL database server just in case you decide to use MySQL instead of SQLite. You may [customize the Sail services](https://laravel.com/docs/installation#choosing-your-sail-services) if needed.
 
 After the project has been created, you can navigate to the application directory and start Laravel Sail: