輔助方法

陣列
路徑
路由
字串
網址
其他

陣列

array_add

如果給定的鍵不在陣列中，array_add 函式會把給定的鍵值對加到陣列中。

$array = ['foo' => 'bar'];

$array = array_add($array, 'key', 'value');

array_divide

array_divide 函式回傳兩個陣列，一個包含原本陣列的鍵，另一個包含原本陣列的值。

$array = ['foo' => 'bar'];

list($keys, $values) = array_divide($array);

array_dot

array_dot 函式把多維陣列扁平化成一維陣列，並用「點」符號表示深度。

$array = ['foo' => ['bar' => 'baz']];

$array = array_dot($array);

// ['foo.bar' => 'baz'];

array_except

array_except 函式從陣列移除給定的鍵值對。

$array = array_except($array, ['keys', 'to', 'remove']);

array_fetch

array_fetch 函式回傳包含被選擇的巢狀元素的扁平化陣列。

$array = [
    ['developer' => ['name' => 'Taylor']],
    ['developer' => ['name' => 'Dayle']]
];

$array = array_fetch($array, 'developer.name');

// ['Taylor', 'Dayle'];

array_first

array_first 函式回傳陣列中第一個通過給定的測試為真的元素。

$array = [100, 200, 300];

$value = array_first($array, function($key, $value)
{
    return $value >= 150;
});

也可以傳遞預設值當作第三個參數：

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

array_last

array_last 函式回傳陣列中最後一個通過給定的測試為真的元素。

$array = [350, 400, 500, 300, 200, 100];

$value = array_last($array, function($key, $value)
{
    return $value > 350;
});

// 500

也可以傳遞預設值當作第三個參數：

$value = array_last($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 = ['names' => ['joe' => ['programmer']]];

array_forget($array, 'names.joe');

array_get

array_get 函式將會使用「點」符號從深度巢狀陣列取回給定的值。

$array = ['names' => ['joe' => ['programmer']]];

$value = array_get($array, 'names.joe');

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

注意: 想要把 array_get 用在物件上？請使用 object_get。

array_only

array_only 函式將會只從陣列回傳給定的鍵值對。

$array = ['name' => 'Joe', 'age' => 27, 'votes' => 1];

$array = array_only($array, ['name', 'votes']);

array_pluck

array_pluck 函式將會從陣列拉出給定鍵值對的清單。

$array = [['name' => 'Taylor'], ['name' => 'Dayle']];

$array = array_pluck($array, 'name');

// ['Taylor', 'Dayle'];

array_pull

array_pull 函式將會從陣列回傳給定的鍵值對，並移除它。

$array = ['name' => 'Taylor', 'age' => 27];

$name = array_pull($array, 'name');

array_set

array_set 函式將會使用「點」符號在深度巢狀陣列中指定值。

$array = ['names' => ['programmer' => 'Joe']];

array_set($array, 'names.editor', 'Taylor');

array_sort

array_sort 函式借由給定閉包的結果來排序陣列。

$array = [
    ['name' => 'Jill'],
    ['name' => 'Barry']
];

$array = array_values(array_sort($array, function($value)
{
    return $value['name'];
}));

array_where

使用給定的閉包過濾陣列。

$array = [100, '200', 300, '400', 500];

$array = array_where($array, function($key, $value)
{
    return is_string($value);
});

// Array ( [1] => 200 [3] => 400 )

head

回傳陣列中第一個元素。

$first = head($this->returnsArray('foo'));

last

回傳陣列中最後一個元素。對方法鏈很有用。

$last = last($this->returnsArray('foo'));

路徑

app_path

取得 app 資料夾的完整路徑。

$path = app_path();

base_path

取得應用程式安裝根目錄的完整路徑。

config_path

取得 config 資料夾的完整路徑。

public_path

取得 public 資料夾的完整路徑。

storage_path

取得 storage 資料夾的完整路徑。

Routing

get

跟路由器註冊一個新的 GET 路由。

get('/', function() { return 'Hello World'; });

post

跟路由器註冊一個新的 POST 路由。

post('foo/bar', 'FooController@action');

put

跟路由器註冊一個新的 PUT 路由。

put('foo/bar', 'FooController@action');

patch

跟路由器註冊一個新的 PATCH 路由。

patch('foo/bar', 'FooController@action');

delete

跟路由器註冊一個新的 DELETE 路由。

delete('foo/bar', 'FooController@action');

resource

跟路由器註冊一個新的 RESTful 資源路由。

resource('foo', 'FooController');

字串

camel_case

把給定的字串轉換成 駝峰式命名。

$camel = camel_case('foo_bar');

// fooBar

class_basename

取得給定類別的類別名稱，不含任何命名空間的名稱。

$class = class_basename('Foo\Bar\Baz');

// Baz

e

對給定字串執行 htmlentities，並支援 UTF-8。

$entities = e('<html>foo</html>');

ends_with

判斷句子結尾是否有給定的字串。

$value = ends_with('This is my name', 'name');

snake_case

把給定的字串轉換成 蛇形命名。

$snake = snake_case('fooBar');

// foo_bar

str_limit

限制字串的字元數量。

str_limit($value, $limit = 100, $end = '...')

例子：

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

// The PHP...

starts_with

判斷句子是否開頭有給定的字串。

$value = starts_with('This is my name', 'This');

str_contains

判斷句子是否有給定的字串。

$value = str_contains('This is my name', 'my');

str_finish

加一個給定字串到句子結尾。多餘一個的給定字串則移除。

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

// this/string/

str_is

判斷字串是否符合給定的模式。星號可以用來當作萬用字元。

$value = str_is('foo*', 'foobar');

str_plural

把字串轉換成它的多數形態 (只有英文)。

$plural = str_plural('car');

str_random

產生給定長度的隨機字串。

$string = str_random(40);

str_singular

把字串轉換成它的單數形態 (只有英文)。

$singular = str_singular('cars');

str_slug

從給定字串產生一個對網址友善的「slug」。

str_slug($title, $separator);

例子：

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

// laravel-5-framework

studly_case

把給定字串轉換成 首字大寫命名。

$value = studly_case('foo_bar');

// FooBar

trans

翻譯給定的語句。等同 Lang::get。

$value = trans('validation.required'):

trans_choice

隨著詞形變化翻譯給定的語句。等同 Lang::choice。

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

網址

action

產生給定控制器行為的網址。

$url = action('HomeController@getIndex', $params);

route

產生給定路由名稱的網址。

$url = route('routeName', $params);

asset

產生資源的網址。

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

secure_asset

產生給定資源的 HTTPS 連結。

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

secure_url

產生給定路徑的 HTTPS 完整網址。

echo secure_url('foo/bar', $parameters = []);

url

產生給定路徑的完整網址。

echo url('foo/bar', $parameters = [], $secure = null);

其他

csrf_token

取得現在 CSRF token 的值。

$token = csrf_token();

dd

印出給定變數並結束腳本執行。

dd($value);

elixir

取得加上版本號的 Elixir 檔案路徑。

elixir($file);

env

取得環境變數的值或回傳預設值。

env('APP_ENV', 'production')

event

觸發一個事件。

event('my.event');

value

如果給定的值是個 閉包，回傳 閉包 的回傳值。不是的話，則回傳值。

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

view

用給定的視圖路徑取得一個視圖實例。

return view('auth.login');

with

回傳給定物件。

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