Form::open().Html::link().On Laravel 13.

Install

composer require prabowosd/laravel-collective-html

The service provider and the Form and Html facade aliases register through package discovery. Nothing to add to config/app.php.

The package declares replace for laravelcollective/html 6.x. If another dependency still asks for the original, Composer resolves it to this package instead of installing both, so the Collective\Html classes are only defined once.

Coming from laravelcollective/html

Namespace, class names, facades and helpers are the ones you already import.

1. Remove the original packageIt is abandoned and does not install on Laravel 11 or newer, so it blocks your next upgrade.

   composer remove laravelcollective/html

2. Require this oneSame Collective\Html classes, same rendered HTML.

   composer require prabowosd/laravel-collective-html

3. Clear compiled viewsBlade directives such as @form_text live in cached views.

   php artisan view:clear

Opening a form

Form::open() takes the target as url, route or action. Methods other than GET and POST are spoofed with a hidden _method field, and every non-GET form gets the CSRF token.

{!! Form::open([
    'url' => 'profile',
    'method' => 'PUT',
    'files' => true,
]) !!}

<form method="POST"
      action="https://example.com/profile"
      accept-charset="UTF-8"
      enctype="multipart/form-data">
<input name="_method" type="hidden" value="PUT">
<input name="_token" type="hidden" value="…">

{!! Form::open(['route' => ['users.update', $user]]) !!}
{!! Form::open(['action' => [UserController::class, 'store']]) !!}

// Model binding: a field with no explicit value is filled from the model
{!! Form::model($user, ['route' => ['users.update', $user], 'method' => 'PATCH']) !!}

{!! Form::close() !!}

Fields

Every field resolves its value in the same order: old input from the session, then the value you pass, then the bound model. A field gets an id when a Form::label() with the same name was rendered before it.

{!! Form::text('username', 'sdp', [
    'placeholder' => 'Username',
]) !!}

<input placeholder="Username"
       name="username" type="text"
       value="sdp">

Boolean attributes go in as values without keys: ['required', 'autofocus'] renders required autofocus.

Selects

{!! Form::select('size', [
    'L' => 'Large',
    'S' => 'Small',
], 'S') !!}

<select name="size">
  <option value="L">Large</option>
  <option value="S" selected="selected">Small</option>
</select>

Nested arrays become <optgroup>s. Pass an array as the selected value for a multiple select, and a placeholder attribute for an empty first option.

{!! Form::selectRange('qty', 1, 10) !!}
{!! Form::selectYear('year', 2020, 2030) !!}
{!! Form::selectMonth('month') !!}   // month names in the app locale

From an enum

Backed enums use their value, pure enums the case name. A label() method on the enum supplies the option text, otherwise the case name is written as a headline.

{!! Form::enumSelect(
    'status',
    OrderStatus::class,
    'shipped',
) !!}

<select name="status">
  <option value="pending">Pending</option>
  <option value="shipped" selected="selected">Shipped</option>
</select>

From Eloquent

The source can be a model class, a query or relation, a collection, or a plain array of rows.

{!! Form::modelSelect('category_id', Category::class, 'name', 'id', $selected) !!}
{!! Form::modelSelect('owner_id', $team->members(), 'full_name') !!}

Validation helpers

These read the $errors bag Laravel shares with every view. Array names map to dot keys, so person[name] checks person.name. Classic calls are untouched: the invalid class is added only where you ask for it.

{!! Form::text('email', null,
    Form::withValidationClass('email', [
        'class' => 'form-control',
    ])
) !!}
{!! Form::error('email') !!}

<input class="form-control is-invalid"
       name="email" type="text">
<div class="invalid-feedback">
  The email field is required.
</div>

@if (Form::hasError('email')) ... @endif
{{ Form::getError('email') }}   // first message, or null

Form::error() returns an empty string when the field is valid, so it is safe after every control.

Blade components

Label, control and error feedback in one tag. Attributes that are not props, such as placeholder, class or data-*, land on the control.

<x-form-input name="email" label="Email" type="email" placeholder="you@example.com" />
<x-form-input name="bio" label="Bio" type="textarea" rows="4" />

<x-form-select name="role" label="Role" :options="['admin' => 'Admin', 'member' => 'Member']" selected="member" />
<x-form-select name="status" label="Status" :enum="App\Enums\OrderStatus::class" />
<x-form-select name="category_id" label="Category" :model="App\Models\Category::class" label-column="name" />

<x-form-checkbox name="agree" label="I accept the terms" :checked="true" />

Html builder

Assets, links and small markup helpers. URLs go through Laravel's URL generator.

{!! Html::link('docs', 'Read the docs', [
    'class' => 'btn',
]) !!}

<a href="https://example.com/docs"
   class="btn">Read the docs</a>

The global helpers link_to(), link_to_asset(), link_to_route() and link_to_action() are still there, each behind a function_exists check.

Classes are configuration

The validation helpers and components use Bootstrap class names by default. Publish the config to map them to Tailwind or anything else.

php artisan vendor:publish --tag=html-config

'classes' => [
    'control' => 'form-control',
    'select' => 'form-select',
    'label' => 'form-label',
    'invalid' => 'is-invalid',
    'feedback' => 'invalid-feedback',
    'check_wrapper' => 'form-check',
    'check_input' => 'form-check-input',
    'check_label' => 'form-check-label',
],

Support matrix

Every supported pair runs the full test suite in CI. From PHP 8.2 up, the suite also fails on any deprecation the package raises.

n/a marks a pair that Laravel itself does not support. Two features need more than the floor: the <x-form-*> components need Laravel 7, because class based Blade components arrived there, and Form::enumSelect() needs PHP 8.1, which introduced enums.