辅助方法

数组

array_add

如果给定的键不在数组中，array_add 函数会把给定的键值对加到数组中。

  1. $array = ['foo' => 'bar'];
  3. $array = array_add($array, 'key', 'value');

array_divide

array_divide 函数返回两个数组，一个包含原本数组的键，另一个包含原本数组的值。

  1. $array = ['foo' => 'bar'];
  3. list($keys, $values) = array_divide($array);

array_dot

array_dot 函数把多维数组扁平化成一维数组，并用「点」符号表示深度。

  1. $array = ['foo' => ['bar' => 'baz']];
  3. $array = array_dot($array);
  5. // ['foo.bar' => 'baz'];

array_except

array_except 函数从数组移除给定的键值对。

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

array_fetch

array_fetch 函数返回包含被选择的嵌套元素的扁平化数组。

  1. $array = [
  2.     ['developer' => ['name' => 'Taylor']],
  3.     ['developer' => ['name' => 'Dayle']]
  4. ];
  6. $array = array_fetch($array, 'developer.name');
  8. // ['Taylor', 'Dayle'];

array_first

array_first 函数返回数组中第一个通过给定的测试为真的元素。

  1. $array = [100, 200, 300];
  3. $value = array_first($array, function($key, $value)
  4. {
  5.     return $value >= 150;
  6. });

也可以传递默认值当作第三个参数：

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

array_last

array_last 函数返回数组中最后一个通过给定的测试为真的元素。

  1. $array = [350, 400, 500, 300, 200, 100];
  3. $value = array_last($array, function($key, $value)
  4. {
  5.     return $value > 350;
  6. });
  8. // 500

也可以传递默认值当作第三个参数：

  1. $value = array_last($array, $callback, $default);

array_flatten

array_flatten 函数将会把多维数组扁平化成一维。

  1. $array = ['name' => 'Joe', 'languages' => ['PHP', 'Ruby']];
  3. $array = array_flatten($array);
  5. // ['Joe', 'PHP', 'Ruby'];

array_forget

array_forget 函数将会用「点」符号从深度嵌套数组移除给定的键值对。

  1. $array = ['names' => ['joe' => ['programmer']]];
  3. array_forget($array, 'names.joe');

array_get

array_get 函数将会使用「点」符号从深度嵌套数组取回给定的值。

  1. $array = ['names' => ['joe' => ['programmer']]];
  3. $value = array_get($array, 'names.joe');
  5. $value = array_get($array, 'names.john', 'default');

注意: 想要把 array_get 用在对象上？ 请使用 object_get。

array_only

array_only 函数将会只从数组返回给定的键值对。

  1. $array = ['name' => 'Joe', 'age' => 27, 'votes' => 1];
  3. $array = array_only($array, ['name', 'votes']);

array_pluck

array_pluck 函数将会从数组拉出给定键值对的清单。

  1. $array = [['name' => 'Taylor'], ['name' => 'Dayle']];
  3. $array = array_pluck($array, 'name');
  5. // ['Taylor', 'Dayle'];

array_pull

array_pull 函数将会从数组返回给定的键值对，并移除它。

  1. $array = ['name' => 'Taylor', 'age' => 27];
  3. $name = array_pull($array, 'name');

array_set

array_set 函数将会使用「点」符号在深度嵌套数组中指定值。

  1. $array = ['names' => ['programmer' => 'Joe']];
  3. array_set($array, 'names.editor', 'Taylor');

array_sort

array_sort 函数通过给定闭包的结果来排序数组。

  1. $array = [
  2.     ['name' => 'Jill'],
  3.     ['name' => 'Barry']
  4. ];
  6. $array = array_values(array_sort($array, function($value)
  7. {
  8.     return $value['name'];
  9. }));

array_where

使用给定的闭包过滤数组。

  1. $array = [100, '200', 300, '400', 500];
  3. $array = array_where($array, function($key, $value)
  4. {
  5.     return is_string($value);
  6. });
  8. // Array ( [1] => 200 [3] => 400 )

head

返回数组中第一个元素

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

last

返回数组中最后一个元素。对方法链很有用。

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

路径

base_path

取得应用程序安装根目录的完整路径。

storage_path

取得 app/storage 文件夹的完整路径。

字串

camel_case

把给定的字串转换成 驼峰式命名。

  1. $camel = camel_case('foo_bar');
  3. // fooBar

class_basename

取得给定类的类名称，不含任何命名空间的名称。

  1. $class = class_basename('Foo\Bar\Baz');
  3. // Baz

e

对给定字串执行 htmlentities，并支持 UTF-8。

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

ends_with

判断句子结尾是否有给定的字串。

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

snake_case

把给定的字串转换成 蛇形命名。

  1. $snake = snake_case('fooBar');
  3. // foo_bar

str_limit

限制字串的字符数量。

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

例子：

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

starts_with

判断句子是否开头有给定的字串。

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

str_contains

判断句子是否有给定的字串。

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

str_finish

加一个给定字串到句子结尾。多余一个的给定字串则移除。

  1. $string = str_finish('this/string', '/');
  3. // this/string/

str_is

判断字串是否符合给定的模式。星号可以用来当作通配符。

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

str_plural

把字串转换成它的多数形态 (只有英文)。

  1. $plural = str_plural('car');

str_random

产生给定长度的随机字串。

  1. $string = str_random(40);

str_singular

把字串转换成它的单数形态 (只有英文)。

  1. $singular = str_singular('cars');

str_slug

从给定字串产生一个对网址友善的「slug」。

  1. str_slug($title, $separator);

例子：

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

studly_case

把给定字串转换成 首字大写命名。

  1. $value = studly_case('foo_bar');
  3. // FooBar

trans

翻译给定的语句。等同 Lang::get。

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

trans_choice

随着词形变化翻译给定的语句。等同 Lang::choice。

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

网址

route

产生给定路由名称的网址。

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

url

产生给定路径的完整网址。

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

其他

csrf_token

返回
取得现在 CSRF token 的值。

  1. $token = csrf_token();

dd

打印给定变量并结束脚本执行。

  1. dd($value);

env

获取一个环境变量的值，如果没有则返回一个默认值。

  1. env('APP_ENV', 'production')

event

触发一个事件。

  1. event('my.event');

value

如果给定的值是个 闭包，返回 闭包 的返回值。不是的话，则返回值。

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

view

用给定的视图路径取得一个视图实例。

  1. return view('auth.login');