lumen 經常使用輔助函數

optional

函數接收任意參數並容許你訪問對象上的屬性或調用其方法。若是給定的對象爲空，屬性或方法調用返回 null

return optional($user->address)->street;

optional 函數還能夠接收一個閉包做爲第二個參數，閉包會在第一個參數值不爲空的狀況下調用：

return optional(User::find($id), function ($user) {
    return new DummyUser;
});

　　

camel_case 函數會將指定的字符串轉換成 駝峯式命名：

$camel = camel_case('foo_bar');// fooBar

　　

簡介

Laravel 包含一些多樣化的 PHP 輔助函數函數。許多在 Laravel 自身框架中使用；若是你以爲實用，也能夠在你應用當中使用。

可用方法

數組

array_add array_collapse array_divide array_dot array_except array_first array_flatten array_forget array_getarray_has array_only array_pluck array_pull array_set array_sort array_sort_recursive array_where head last

路徑

app_path base_path config_path database_path elixir public_path storage_path

字符串

camel_case class_basename e ends_with snake_case str_limit starts_with str_contains str_finish str_isstr_plural str_random str_singular str_slug studly_case trans trans_choice

網址

action asset secure_asset route url

其它

auth back bcrypt collect config csrf_field csrf_token dd env event factory method_field old redirect requestresponse session value view with

方法列表

數組

array_add()

若是指定的鍵不存在於該數組，array_add 函數便會將指定的鍵值對加到數組中：

$array = array_add([‘name‘ => ‘Desk‘], ‘price‘, 100);  // [‘name‘ => ‘Desk‘, ‘price‘ => 100]

array_collapse()

array_collapse 函數將數組的每個數組折成單個數組：

$array = array_collapse([[1, 2, 3], [4, 5, 6], [7, 8, 9]]);  // [1, 2, 3, 4, 5, 6, 7, 8, 9]

array_divide()

array_divide 函數返回兩個數組，一個包含本來數組的鍵，另外一個包含本來數組的值：

list($keys, $values) = array_divide([‘name‘ => ‘Desk‘]);  // $keys: [‘name‘]  // $values: [‘Desk‘]

array_dot()

array_dot 函數把多維數組扁平化成一維數組，並用「點」式語法表示深度：

$array = array_dot([‘foo‘ => [‘bar‘ => ‘baz‘]]);  // [‘foo.bar‘ => ‘baz‘];

array_except()

array_except 函數從數組移除指定的鍵值對：

$array = [‘name‘ => ‘Desk‘, ‘price‘ => 100]; $array = array_except($array, [‘price‘]);  // [‘name‘ => ‘Desk‘]

array_first()

array_first 函數返回數組中第一個經過測試的元素：

$array = [100, 200, 300]; $value = array_first($array, function ($key, $value) { return $value >= 150; });  // 200

可傳遞第三個參數做爲默認值。當沒有任何數值經過測試時將返回該數值：

$value = array_first($array, $callback, $default);

array_flatten()

array_flatten 函數將多維數組扁平化成一維。

$array = [‘name‘ => ‘Joe‘, ‘languages‘ => [‘PHP‘, ‘Ruby‘]]; $array = array_flatten($array);  // [‘Joe‘, ‘PHP‘, ‘Ruby‘];

array_forget()

array_forget 函數以「點」式語法從深度嵌套數組中移除指定的鍵值對：

$array = [‘products‘ => [‘desk‘ => [‘price‘ => 100]]]; array_forget($array, ‘products.desk‘);  // [‘products‘ => []]

array_get()

array_get 函數使用「點」式語法從深度嵌套數組中取回指定的值：

$array = [‘products‘ => [‘desk‘ => [‘price‘ => 100]]]; $value = array_get($array, ‘products.desk‘);  // [‘price‘ => 100]

array_get 函數一樣接受默認值，當指定的鍵找不到時返回：

$value = array_get($array, ‘names.john‘, ‘default‘);

array_has()

array_has 函數使用「點」式語法檢查指定的項目是否存在於數組中：

$array = [‘products‘ => [‘desk‘ => [‘price‘ => 100]]]; $hasDesk = array_has($array, [‘products.desk‘]);  // true

array_only()

array_only 函數從數組返回指定的鍵值對：

$array = [‘name‘ => ‘Desk‘, ‘price‘ => 100, ‘orders‘ => 10]; $array = array_only($array, [‘name‘, ‘price‘]);  // [‘name‘ => ‘Desk‘, ‘price‘ => 100]

array_pluck()

array_pluck 函數從數組拉出一列指定的鍵值對：

$array = [ [‘developer‘ => [‘id‘ => 1, ‘name‘ => ‘Taylor‘]], [‘developer‘ => [‘id‘ => 2, ‘name‘ => ‘Abigail‘]], ]; $array = array_pluck($array, ‘developer.name‘);  // [‘Taylor‘, ‘Abigail‘];

你也能指定要以什麼做爲結果列的鍵值：

$array = array_pluck($array, ‘developer.name‘, ‘developer.id‘);  // [1 => ‘Taylor‘, 2 => ‘Abigail‘];

array_pull()

array_pull 函數從數組移除並返回指定的鍵值對：

$array = [‘name‘ => ‘Desk‘, ‘price‘ => 100]; $name = array_pull($array, ‘name‘);  // $name: Desk  // $array: [‘price‘ => 100]

array_set()

array_set 函數使用「點」式語法在深度嵌套數組中寫入值：

$array = [‘products‘ => [‘desk‘ => [‘price‘ => 100]]]; array_set($array, ‘products.desk.price‘, 200);  // [‘products‘ => [‘desk‘ => [‘price‘ => 200]]]

array_sort()

array_sort 函數借助指定閉包結果排序數組：

$array = [ [‘name‘ => ‘Desk‘], [‘name‘ => ‘Chair‘], ]; $array = array_values(array_sort($array, function ($value) { return $value[‘name‘]; })); /* [ [‘name‘ => ‘Chair‘], [‘name‘ => ‘Desk‘], ] */

array_sort_recursive()

array_sort_recursive 函數使用 sort 函數遞歸排序數組：

$array = [ [ ‘Roman‘, ‘Taylor‘, ‘Li‘, ], [ ‘PHP‘, ‘Ruby‘, ‘JavaScript‘, ], ]; $array = array_sort_recursive($array); /* [ [ ‘Li‘, ‘Roman‘, ‘Taylor‘, ], [ ‘JavaScript‘, ‘PHP‘, ‘Ruby‘, ] ]; */

array_where()

array_where 函數使用指定的閉包過濾數組：

$array = [100, ‘200‘, 300, ‘400‘, 500]; $array = array_where($array, function ($key, $value) { return is_string($value); });  // [1 => 200, 3 => 400]

head()

head 函數返回指定數組的第一個元素：

$array = [100, 200, 300]; $first = head($array);  // 100

last()

last 函數返回指定數組的最後一個元素：

$array = [100, 200, 300]; $last = last($array);  // 300

路徑

app_path()

app_path 函數獲取 app 文件夾的完整路徑：

$path = app_path();

你一樣能夠使用 app_path 函數生成針對指定文件相對於 app 目錄的完整路徑：

$path = app_path(‘Http/Controllers/Controller.php‘);

base_path()

base_path 函數獲取項目根目錄的完整路徑：

$path = base_path();

你一樣能夠使用 base_path 函數生成針對指定文件相對於項目根目錄的完整路徑：

$path = base_path(‘vendor/bin‘);

config_path()

config_path 函數獲取應用配置目錄的完整路徑：

$path = config_path();

database_path()

database_path 函數獲取應用數據庫目錄的完整路徑：

$path = database_path();

elixir()

elixir 函數獲取加上版本號的 Elixir 文件路徑：

elixir($file);

public_path()

public_path 函數獲取 public 目錄的完整路徑：

$path = public_path();

storage_path()

storage_path 函數獲取 storage 目錄的完整路徑：

$path = storage_path();

你一樣能夠使用 storage_path 函數生成針對指定文件相對於 storage 目錄的完整路徑：

$path = storage_path(‘app/file.txt‘);

字符串

camel_case()

camel_case 函數會將指定的字符串轉換成 駝峯式命名：

$camel = camel_case(‘foo_bar‘);  // fooBar

class_basename()

class_basename 返回不包含命名空間的類名稱：

$class = class_basename(‘Foo\Bar\Baz‘);  // Baz

e()

e 函數對指定字符串運行 htmlentities：

echo e(‘<html>foo</html>‘);  // &lt;html&gt;foo&lt;/html&gt;

ends_with()

ends_with 函數判斷指定字符串結尾是否爲指定內容：

$value = ends_with(‘This is my name‘, ‘name‘);  // true

snake_case()

snake_case 函數會將指定的字符串轉換成 蛇形命名：

$snake = snake_case(‘fooBar‘);  // foo_bar

str_limit()

str_limit 函數限制字符串的字符數量。該函數接受一個字符串做爲第一個參數，以及最大字符數量做爲第二參數：

$value = str_limit(‘The PHP framework for web artisans.‘, 7);  // The PHP...

starts_with()

starts_with 函數判斷字符串開頭是否爲指定內容：

$value = starts_with(‘This is my name‘, ‘This‘);  // true

str_contains()

str_contains 函數判斷指定字符串是否包含指定內容：

$value = str_contains(‘This is my name‘, ‘my‘);  // true

str_finish()

str_finish 函數添加指定內容到字符串結尾：

$string = str_finish(‘this/string‘, ‘/‘);  // this/string/

str_is()

str_is 函數判斷指定的字符串與指定的格式是否符合。星號可做爲通配符使用：

$value = str_is(‘foo*‘, ‘foobar‘);  // true $value = str_is(‘baz*‘, ‘foobar‘);  // false

str_plural()

str_plural 函數轉換字符串成複數形。該函數目前僅支持英文：

$plural = str_plural(‘car‘);  // cars $plural = str_plural(‘child‘);  // children

你能夠提供一個整數做爲第二參數，來獲取字符串的單數或複數形式：

$plural = str_plural(‘child‘, 2);  // children $plural = str_plural(‘child‘, 1);  // child

str_random()

str_random 函數生成指定長度的隨機字符串：

$string = str_random(40);

str_singular()

str_singular 函數轉換字符串成單數形式。該函數目前僅支持英文：

$singular = str_singular(‘cars‘);  // car

str_slug()

str_slug 函數從指定字符串生成網址友善的「slug」：

$title = str_slug("Laravel 5 Framework", "-");  // laravel-5-framework

studly_case()

studly_case 函數將指定字符串轉換成 首字大寫命名：

$value = studly_case(‘foo_bar‘);  // FooBar

trans()

trans 函數根據你的 本地化文件 翻譯指定的語句：

echo trans(‘validation.required‘):

trans_choice()

trans_choice 函數根據後綴變化翻譯指定的語句：

$value = trans_choice(‘foo.bar‘, $count);

網址

action()

action 函數生成指定控制器行爲網址。你不須要輸入該控制器的完整命名空間。做爲替代，請輸入基於 App\Http\Controllers 命名空間的控制器類名稱：

$url = action(‘HomeController@getIndex‘);

若是該方法支持路由參數，你能夠做爲第二參數傳遞：

$url = action(‘UserController@profile‘, [‘id‘ => 1]);

asset()

根據目前請求的協定（HTTP 或 HTTPS）生成資源文件網址：

$url = asset(‘img/photo.jpg‘);

secure_asset()

根據 HTTPS 生成資源文件網址：

echo secure_asset(‘foo/bar.zip‘, $title, $attributes = []);

route()

route 函數生成指定路由名稱網址：

$url = route(‘routeName‘);

若是該路由接受參數，你能夠做爲第二參數傳遞：

$url = route(‘routeName‘, [‘id‘ => 1]);

url()

url 函數生成指定路徑的完整網址：

echo url(‘user/profile‘); echo url(‘user/profile‘, [1]);

其它

auth()

auth 函數返回一個認證器實例。你能夠使用它取代 Auth facade：

$user = auth()->user();

back()

back() 函數生成一個重定向響應讓用戶回到以前的位置：

return back();

bcrypt()

bcrypt 函數使用 Bcrypt 哈希指定的數值。你能夠使用它替代 Hash facade：

$password = bcrypt(‘my-secret-password‘);

collect()

collect 函數從指定的項目生成 集合 實例：

$collection = collect([‘taylor‘, ‘abigail‘]);

config()

config 獲取設置選項的設置值。設置值可經過「點」式語法讀取，其中包含要訪問的文件名以及選項名稱。可傳遞一默認值在找不到指定的設置選項時返回該數值：

$value = config(‘app.timezone‘); $value = config(‘app.timezone‘, $default);

config 輔助函數也能夠在運行期間，根據指定的鍵值對指定設置值：

config([‘app.debug‘ => true]);

csrf_field()

csrf_field 函數生成包含 CSRF 令牌內容的 HTML 表單隱藏字段。例如，使用 Blade 語法：

{!! csrf_field() !!}

csrf_token()

csrf_token 函數獲取當前 CSRF 令牌的內容：

$token = csrf_token();

dd()

dd 函數輸出指定變量並結束腳本運行：

dd($value);

env()

env 函數獲取環境變量值或返回默認值：

$env = env(‘APP_ENV‘);  // 當變量不存在時返回一個默認值... $env = env(‘APP_ENV‘, ‘production‘);

event()

event 函數配送指定 事件 到所屬的偵聽器：

event(new UserRegistered($user));

factory()

factory 函數根據指定類、名稱以及總數生成模型工廠構造器（model factory builder）。可用於 測試 或 數據填充：

$user = factory(App\User::class)->make();

method_field()

method_field 函數生成模擬 HTTP 表單動做內容的 HTML 表單隱藏字段。例如，使用 Blade 語法：

<form method="POST"> {!! method_field(‘delete‘) !!} </form>

old()

old 函數 獲取 閃存到 session 的舊有輸入數值：

$value = old(‘value‘);

redirect()

redirect 函數返回重定向器實例以進行 重定向：

return redirect(‘/home‘);

request()

request 函數獲取目前的 請求 實例或輸入的項目：

$request = request(); $value = request(‘key‘, $default = null)

response()

response 函數建立一個 響應 實例或獲取一個響應工廠（response factory）實例：

return response(‘Hello World‘, 200, $headers); return response()->json([‘foo‘ => ‘bar‘], 200, $headers);

session()

session 函數可用於獲取或設置單個 session 內容：

$value = session(‘key‘);

你能夠經過傳遞鍵值對給該函數進行內容設置：

session([‘chairs‘ => 7, ‘instruments‘ => 3]);

該函數在沒有傳遞參數時，將返回 session 實例：

$value = session()->get(‘key‘); session()->put(‘key‘, $value);

value()

value 函數返回指定數值。而當你傳遞一個 閉包 給該函數，該 閉包 將被運行並返回結果：

$value = value(function() { return ‘bar‘; });

view()

view 函數獲取 視圖 實例：

return view(‘auth.login‘);

with()

with 函數返回指定的數值。該函數主要用於鏈式調用回所保存的 seesion 內容，除此以外不大可能用到：

$value = with(new Foo)->work();

原文地址：http://www.cnblogs.com/wangzhilei/p/7273008.html

 

https://laravelacademy.org/post/9568.html

https://www.cnblogs.com/wangzhilei/p/7273008.html