Laravel Getting Started

# Linux (macOS: .../install/mac/8.5; Windows: a PowerShell one-liner on the installation page)
/bin/bash -c "$(curl -fsSL https://php.new/install/linux/8.5)"

# or, with PHP and Composer already installed
composer global require laravel/installer
laravel --version          # Laravel Installer 5.32.0

$ laravel new --help
  --database=DATABASE          The database driver your application will use. Possible values are: mysql, mariadb, pgsql, sqlite, sqlsrv
  --react | --svelte | --vue | --livewire     Install a starter kit
  --livewire-class-components  Generate stand-alone Livewire class components
  --workos                     Use WorkOS for authentication
  --teams                      Install team support
  --no-authentication          Do not generate authentication scaffolding
  --pest | --phpunit           Install the Pest or PHPUnit testing framework
  --npm | --pnpm | --bun | --yarn | --no-node   Install and build front-end dependencies (or not)
  --boost | --no-boost         Install Laravel Boost to improve AI assisted coding
  --git, --github[=…]          Initialize a Git repository (and create it on GitHub)
  ...

$ laravel new bookshelf --pest --database=sqlite --no-node --no-boost --no-interaction
{"success":true,"name":"bookshelf","directory":"/home/ada/code/bookshelf"}

cd bookshelf
npm install && npm run build      # once, to build the front-end assets
composer run dev                  # runs: php artisan dev

<?php
// app/Providers/AppServiceProvider.php, in boot()
use Illuminate\Foundation\DevCommands;

DevCommands::artisan('horizon', 'horizon');                 // php artisan horizon instead of queue:listen
DevCommands::node('storybook', 'storybook');                // npm run storybook
DevCommands::register('my-command --flag', 'my-process')->green();

$ php artisan make:model Book --migration --factory --controller --resource
 INFO Model [app/Models/Book.php] created successfully.
 INFO Factory [database/factories/BookFactory.php] created successfully.
 INFO Migration [database/migrations/2026_10_05_193247_create_books_table.php] created successfully.
 INFO Controller [app/Http/Controllers/BookController.php] created successfully.

<?php
// database/migrations/2026_10_05_193247_create_books_table.php (the up() method)
Schema::create('books', function (Blueprint $table) {
    $table->id();
    $table->string('title');
    $table->unsignedSmallInteger('published_year')->nullable();
    $table->timestamps();
});

$ php artisan migrate
 INFO Running migrations.
 2026_10_05_193247_create_books_table .. 3.11ms DONE

<?php
// app/Models/Book.php
namespace App\Models;

use Illuminate\Database\Eloquent\Attributes\Fillable;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;

#[Fillable(['title', 'published_year'])]
class Book extends Model
{
    /** @use HasFactory<\Database\Factories\BookFactory> */
    use HasFactory;
}

<?php
// routes/web.php
use App\Http\Controllers\BookController;
use Illuminate\Support\Facades\Route;

Route::resource('books', BookController::class)->only(['index', 'show']);

<?php
// app/Http/Controllers/BookController.php
namespace App\Http\Controllers;

use App\Models\Book;
use Illuminate\View\View;

class BookController extends Controller
{
    public function index(): View
    {
        return view('books.index', ['books' => Book::orderBy('title')->get()]);
    }

    public function show(Book $book): View         // route model binding: 404 when the id does not exist
    {
        return view('books.show', ['book' => $book]);
    }
}

{{-- resources/views/books/index.blade.php --}}
<h1>Books</h1>
<ul>
    @forelse ($books as $book)
        <li><a href="{{ route('books.show', $book) }}">{{ $book->title }}</a></li>
    @empty
        <li>No books yet.</li>
    @endforelse
</ul>

{{-- resources/views/books/show.blade.php --}}
<h1>{{ $book->title }}</h1>
<p>Published {{ $book->published_year }}</p>

$ php artisan tinker --execute="App\Models\Book::create(['title' => 'Kindred', 'published_year' => 1979]);"
$ php artisan route:list --path=books
 GET|HEAD books .. books.index › BookController@index
 GET|HEAD books/{book} .. books.show › BookController@show
 Showing [2] routes
$ curl localhost:8000/books
<h1>Books</h1>
<ul>
            <li><a href="http://localhost:8000/books/1">Kindred</a></li>
    </ul>
$ curl localhost:8000/books/1
<h1>Kindred</h1>
<p>Published 1979</p>
$ curl -o /dev/null -w '%{http_code}\n' localhost:8000/books/99
404