安裝

1.安裝 HTML 之前，需要確保PHP版本是否叨叨你使用的框架的環境要求

我們使用Composer在命令列安裝最新版本的laravelcollective/html

composer require laravelcollective/html

如果這一步驟執行失敗了，也沒關係，可能是你的框架不支援最新版本的，可以直接指定版本更新：

composer require laravelcollective/html 5.3.*

還有一種方式去載入：

首先通過 composer 來安裝這個 包, 編輯專案的 composer.json

"require": {
    "laravelcollective/html": "5.3.*"
}

composer update

在providers陣列下面新增

'Illuminate\Html\HtmlServiceProvider',

在aliases陣列下面新增

'Form'    => 'Illuminate\Html\FormFacade',
'HTML'    => 'Illuminate\Html\HtmlFacade'
 

這樣就安裝好啦！

建立表單

開啟表單

{!! Form::open(array('url' => 'foo/bar')) !!}
    //
{!! Form::close() !!}

預設是 POST 方法, 你可以隨意指定其他接收方法

echo Form::open(array('url' => 'foo/bar', 'method' => 'put'))

Note: HTML 表單僅僅支援 POST 和 GET方法, PUT 和DELETE 方法將會使用一個隱藏域_method 新增到form 表單中來欺騙實現

你可以使用指定的控制器@動作 或者命名的路由來建立表單

echo Form::open(array('route' => 'route.name'))

echo Form::open(array('action' => '
 
[email protected]'))

同樣也可以向路由中傳入引數.

echo Form::open(array('route' => array('route.name', $user->id)))

echo Form::open(array('action' => array('[email protected]', $user->id)))

如果你的表單需要支援檔案上傳, 在陣列中新增 一個 files 配置項.

echo Form::open(array('url' => 'foo/bar', 'files' => true))

CSRF 保護

向表單中新增 CSRF Token

Laravel 提供了一個簡單的方法來防止你的應用遭受跨站攻擊. 首先會在你的session 中生成一個隨機的 token, 如果你使用 Form::open 方法並且提交方法是POST, PUT或者是 DELETE, CSRF token 將會自動的新增到你的form 表單的隱藏域中. 換種方法 如果你像自己生成 CSRF token 欄位, 你可以使用token 方法.

echo Form::token();

給路由新增 CSRF 過濾器

Route::post('profile', array('before' => 'csrf', function()
{
    //
}));

表單模型繫結

給表單繫結模型

通常, 你需要想表單中填入來自資料庫模型的資料. 想這樣做你可以使用 Form::model 方法.

echo Form::model($user, array('route' => array('user.update', $user->id)))

現在當你自動生成一個表單元素, 例如文字輸入框. Model 的值將會自動匹配並且填寫到相關的表單欄位中.例如. 一個文字輸入框的 name 是email這個欄位將會用 使用者 Model 的 email 屬性來填充並且設定. 當然, 還有其他用法. 如果一個欄位在session 快閃記憶體資料中 也存在這個名字, 這個將會覆蓋模型中的這個欄位值. 優先順序是這個樣子的:

1. Session Flash Data (Old Input) [session 快閃記憶體 / 老的輸入資料 ]
2. Explicitly Passed Value [輸入值]
3. Model Attribute Data [模型屬性值]

這個可以讓你快速的使用模型資料來建立表單, 也能輕鬆的在伺服器校驗錯誤之後重新發布表單.

Note: 使用 Form::model方法的時候一定要使用 Form::close來關閉表單!

標籤

生成標籤元素

echo Form::label('email', 'E-Mail Address');

指定額外的 html 屬性

echo Form::label('email', 'E-Mail Address', array('class' => 'awesome'));

Note: 在建立了一個標籤之後, 如果有建立的表單元素的 name 值和 label 的 name 值相符的話, 將會自動在 表單元素 中自動匹配增加 id 屬性. id 的值就是 label 的name 值.

文字框, 文字域, 密碼 & 隱藏域

建立文字框

echo Form::text('username');

指定預設值

echo Form::text('email', '[email protected]');

Note: hidden 和 textarea 方法的引數和 text 相同.

生成密碼輸入框

echo Form::password('password', array('class' => 'awesome'));

生成其他輸入框

echo Form::email($name, $value = null, $attributes = array());
echo Form::file($name, $attributes = array());

多選和單選

生成單選和多選

echo Form::checkbox('name', 'value');
echo Form::radio('name', 'value');

生成帶有選中狀態的表單元素

echo Form::checkbox('name', 'value', true);
echo Form::radio('name', 'value', true);

數字

生成數字輸入框

echo Form::number('name', 'value');

日期

生成日期輸入框

echo Form::date('name', \Carbon\Carbon::now());

檔案選擇器

生成檔案選擇器

echo Form::file('image');

Note: 表單中必須設定 files 引數的值為 true

下拉列表

生成下拉列表

echo Form::select('size', array('L' => 'Large', 'S' => 'Small'));

生成有預設值的下拉列表

echo Form::select('size', array('L' => 'Large', 'S' => 'Small'), 'S');

生成空佔位符的 下拉列表

這回建立一個沒有任何值的 <option> 元素作為下拉列表的第一個選擇值.

echo Form::select('size', array('L' => 'Large', 'S' => 'Small'), null, ['placeholder' => 'Pick a size...']);

生成分組的列表

echo Form::select('animal', array(
        'Cats' => array('leopard' => 'Leopard'),
        'Dogs' => array('spaniel' => 'Spaniel'),
    ));

生成範圍選擇值的下拉列表

echo Form::selectRange('number', 10, 20);

生成有月份名稱的選擇值

echo Form::selectMonth('month');

按鈕

生成提交按鈕

echo Form::submit('Click Me!');

Note: 想建立一個按鈕元素? 試用 button 方法. 他和 submit 方法有相同的引數.

自定義表單元素

註冊一個新的表單元素

用來很方便的來自定義一個表單元素的方法叫做 macros . 合理是怎樣使用它. 首先簡單的使用名稱和閉包函式來註冊一個 :

Form::macro('myField', function()
{
    return '<input type="awesome">';
});

現在你可以使用自定義的名字來呼叫這個 macro

呼叫自定義的 Form Macro

echo Form::myField();

生成URL

link_to

根據給定的URL生成 html 連結

echo link_to('foo/bar', $title = null, $attributes = array(), $secure = null);

link_to_asset

生成一個連結到指定資源的 html

echo link_to_asset('foo/bar.zip', $title = null, $attributes = array(), $secure = null);

link_to_route

生成一個根據給定路由的html連結

echo link_to_route('route.name', $title = null, $parameters = array(), $attributes = array());

link_to_action

根據指定的控制器/方法來生成 html 連結

echo link_to_action('[email protected]', $title = null, $parameters = array(), $attributes = array());