简介
Laravel 自带了一系列 PHP 辅助函数,很多被框架自身使用,如果你觉得方便的话也可以在代码中使用它们。
方法列表
数组函数
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 = ['products' => ['desk' => ['price' => 100]]];
$flattened = array_dot($array);
// ['products.desk.price' => 100]
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 ($value, $key) {
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');
// ['price' => 100]
array_get
函数还接收一个默认值,如果指定键不存在的话则返回该默认值:
$value = array_get($array, 'products.desk.discount', 0);
// 0
array_has()
array_has
函数使用“.”检查给定数据项是否在数组中存在:
$array = ['product' => ['name' => 'desk', 'price' => 100]];
$hasItem = array_has($array, 'product.name');
// true
$hasItems = array_has($array, ['product.price', 'product.discount']);
// false
array_last()
array_last
函数返回通过过滤数组的最后一个元素:
$array = [100, 200, 300, 110];
$value = array_last($array, function ($value, $key) {
return $value >= 150;
});
// 300
我们可以传递一个默认值作为第三个参数到该函数,如果没有值通过真理测试的话该默认值被返回:
$last = array_last($array, $callback, $default);
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']],
];
$names = array_pluck($array, 'developer.name');
// ['Taylor', 'Abigail']
你还可以指定返回结果的键:
$array = array_pluck($array, 'developer.name', 'developer.id');
// [1 => 'Taylor', 2 => 'Abigail'];
array_prepend()
array_prepend
函数将数据项推入数组开头:
$array = ['one', 'two', 'three', 'four'];
$array = array_prepend($array, 'zero');
// $array: ['zero', 'one', 'two', 'three', 'four']
如果需要的话还可以指定用于该值的键:
$array = ['price' => 100];
$array = array_prepend($array, 'Desk', 'name');
// ['name' => 'Desk', 'price' => 100]
array_pull()
array_pull
函数从数组中返回并移除键值对:
$array = ['name' => 'Desk', 'price' => 100];
$name = array_pull($array, 'name');
// $name: Desk
// $array: ['price' => 100]
我们还可以传递默认值作为第三个参数到该函数,如果指定键不存在的话返回该值:
$value = array_pull($array, $key, $default);
array_random()
array_random
函数从数组中返回随机值:
$array = [1, 2, 3, 4, 5];
$random = array_random($array);
// 4 - (retrieved randomly)
还可以指定返回的数据项数目作为可选的第二个参数,需要注意的是提供这个参数会返回一个数组,即使只返回一个数据项:
$items = array_random($array, 2);
// [2, 5] - (retrieved randomly)
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 = ['Desk', 'Table', 'Chair'];
$sorted = array_sort($array);
// ['Chair', 'Desk', 'Table']
还可以通过给定闭包的结果对数组进行排序:
$array = [
['name' => 'Desk'],
['name' => 'Table'],
['name' => 'Chair'],
];
$sorted = array_values(array_sort($array, function ($value) {
return $value['name'];
}));
/*
[
['name' => 'Chair'],
['name' => 'Desk'],
['name' => 'Table'],
]
*/
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]
array_wrap()
array_wrap
函数将给定值包裹到数组中,如果给定值已经是数组则保持不变:
$string = 'Laravel';
$array = array_wrap($string);
// ['Laravel']
如果给定值是空的,则返回一个空数组:
$nothing = null;
$array = array_wrap($nothing);
// []
data_fill()
data_fill
函数使用「.」号以嵌套数组或对象的方式设置缺失值:
$data = ['products' => ['desk' => ['price' => 100]]];
data_fill($data, 'products.desk.price', 200);
// ['products' => ['desk' => ['price' => 100]]]
data_fill($data, 'products.desk.discount', 10);
// ['products' => ['desk' => ['price' => 100, 'discount' => 10]]]
该函数还接收「*」号作为通配符并填充相应目标:
$data = [
'products' => [
['name' => 'Desk 1', 'price' => 100],
['name' => 'Desk 2'],
],
];
data_fill($data, 'products.*.price', 200);
/*
[
'products' => [
['name' => 'Desk 1', 'price' => 100],
['name' => 'Desk 2', 'price' => 200],
],
]
*/
data_get()
data_get
函数使用「.」号从嵌套数组或对象中获取值:
$data = ['products' => ['desk' => ['price' => 100]]];
$price = data_get($data, 'products.desk.price');
// 100
data_get
函数还接收默认值,以便指定键不存在的情况下返回:
$discount = data_get($data, 'products.desk.discount', 0);
// 0
data_set()
data_set
函数使用 「.」号设置嵌套数组或对象的值:
$data = ['products' => ['desk' => ['price' => 100]]];
data_set($data, 'products.desk.price', 200);
// ['products' => ['desk' => ['price' => 200]]]
该函数还接收通配符然后设置相应的目标值:
$data = [
'products' => [
['name' => 'Desk 1', 'price' => 100],
['name' => 'Desk 2', 'price' => 150],
],
];
data_set($data, 'products.*.price', 200);
/*
[
'products' => [
['name' => 'Desk 1', 'price' => 200],
['name' => 'Desk 2', 'price' => 200],
],
]
*/
默认情况下,任意已存在的值都会被覆盖,如果你想要只设置不存在的值,可以传递 false
作为第三个参数:
$data = ['products' => ['desk' => ['price' => 100]]];
data_set($data, 'products.desk.price', 200, false);
// ['products' => ['desk' => ['price' => 100]]]
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
目录的绝对路径,你还可以使用 app_path
函数为相对于 app
目录的给定文件生成绝对路径:
$path = app_path();
$path = app_path('Http/Controllers/Controller.php');
base_path()
base_path
函数返回项目根目录的绝对路径,你还可以使用 base_path
函数为相对于应用根目录的给定文件生成绝对路径:
$path = base_path();
$path = base_path('vendor/bin');
config_path()
config_path
函数返回应用配置目录 config
的绝对路径,还可以使用 config_path
函数在应用配置目录内为给定文件生成完整路径:
$path = config_path();
$path = config_path('app.php');
database_path()
database_path
函数返回应用数据库目录 database
的完整路径,还可以使用 database_path
函数在数据库目录内为给定文件生成完整路径:
$path = database_path();
$path = database_path('factories/UserFactory.php');
mix()
mix
函数返回带有版本号的Mix文件路径:
mix($file);
public_path()
public_path
函数返回 public
目录的绝对路径,还可以使用 public_path
函数在 public 目录下为给定文件生成完整路径:
$path = public_path();
$path = public_path('css/app.css');
resource_path()
resource_path
函数返回 resources
目录的绝对路径,还可以使用 resources
函数在 resources
目录下为给定文件生成完整路径:
$path = resource_path();
$path = resource_path('assets/sass/app.scss');
storage_path()
storage_path
函数返回 storage
目录的绝对路径, 还可以使用 storage_path
函数在 storage
目录下为给定文件生成完整路径:
$path = storage_path();
$path = storage_path('app/file.txt');
字符串函数
__()
__
函数会使用本地化文件翻译给定翻译字符串或翻译键:
echo __('Welcome to our application');
echo __('messages.welcome');
如果给定翻译字符串或键不存在,__
函数将会返回给定值。所以,使用上面的例子,如果翻译键不存在的话 __
函数将会返回 messages.welcome
。
camel_case()
camel_case
函数将给定字符串转化为符合驼峰式命名规则的字符串:
$camel = camel_case('foo_bar');
// fooBar
class_basename()
class_basename
返回给定类移除命名空间后的类名:
$class = class_basename('Foo\Bar\Baz');
// Baz
e()
e
函数在给定字符串上运行 htmlentities
(double_encode
选项设置为 false
):
echo e('<html>foo</html>');
// <html>foo</html>
ends_with()
ends_with
函数判断给定字符串是否以给定值结尾:
$value = ends_with('This is my name', 'name');
// true
kebab_case()
kebab_case
函数将给定字符串转化为短划线分隔的字符串:
$converted = kebab_case('fooBar');
// foo-bar
preg_replace_array()
preg_replace_array
函数使用数组替换字符串序列中的给定模式:
$string = 'The event will take place between :start and :end';
$replaced = preg_replace_array('/:[a-z_]+/', ['8:30', '9:00'], $string);
// The event will take place between 8:30 and 9:00
snake_case()
snake_case
函数将给定字符串转化为下划线分隔的字符串:
$snake = snake_case('fooBar');
// foo_bar
starts_with()
starts_with
函数判断给定字符串是否以给定值开头:
$result = starts_with('This is my name', 'This');
// true
str_after()
str_after
函数返回字符串中给定值之后的所有字符:
$slice = str_after('This is my name', 'This is');
// ' my name'
str_before()
str_before
函数返回字符串给定值之前的所有字符:
$slice = str_before('This is my name', 'my name');
// 'This is '
str_contains()
str_contains
函数判断给定字符串是否包含给定值(大小写敏感):
$contains = str_contains('This is my name', 'my');
// true
还可以传递数组值判断给定字符串是否包含数组中的任意值:
$contains = str_contains('This is my name', ['my', 'foo']);
// true
str_finish()
str_finish
函数添加给定值单个实例到字符串结尾 —— 如果原字符串不以给定值结尾的话:
$adjusted = str_finish('this/string', '/');
// this/string/
$adjusted = str_finish('this/string/', '/');
// this/string/
str_is()
str_is
函数判断给定字符串是否与给定模式匹配,星号可用于表示通配符:
$value = str_is('foo*', 'foobar');
// true
$value = str_is('baz*', 'foobar');
// false
str_limit()
str_limit
函数以指定长度截断字符串:
$truncated = str_limit('The quick brown fox jumps over the lazy dog', 20);
// The quick brown fox...
还可以传递第三个参数来改变字符串末尾字符:
$truncated = str_limit('The quick brown fox jumps over the lazy dog', 20, ' (...)');
// The quick brown fox (...)
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
函数通过指定长度生成随机字符串,该函数使用了PHP的 random_bytes
函数:
$string = str_random(40);
str_replace_array()
str_replace_array
函数使用数组在字符串序列中替换给定值:
$string = 'The event will take place between ? and ?';
$replaced = str_replace_array('?', ['8:30', '9:00'], $string);
// The event will take place between 8:30 and 9:00
str_replace_first()
str_replace_first
函数会替换字符串中第一次出现的值:
$replaced = str_replace_first('the', 'a', 'the quick brown fox jumps over the lazy dog');
// a quick brown fox jumps over the lazy dog
str_replace_last()
str_replace_last
函数会替换字符串中最后一次出现的值:
$replaced = str_replace_last('the', 'a', 'the quick brown fox jumps over the lazy dog');
// the quick brown fox jumps over a lazy dog
str_singular()
str_singular
函数将字符串转化为单数形式,该函数目前只支持英文:
$singular = str_singular('cars');
// car
$singular = str_singular('children');
// child
str_slug()
str_slug
函数将给定字符串生成 URL 友好的格式:
$title = str_slug("Laravel 5 Framework", "-");
// laravel-5-framework
str_start()
如果字符串没有以给定值开头的话 str_start
函数会将给定值添加到字符串最前面:
$adjusted = str_start('this/string', '/');
// /this/string
$adjusted = str_start('/this/string/', '/');
// /this/string
studly_case()
studly_case
函数将给定字符串转化为单词开头字母大写的格式:
$value = studly_case('foo_bar');
// FooBar
title_case()
title_case
函数将字符串转化为 Title
形式:
$title = title_case('a nice title uses the correct case');
// A Nice Title Uses The Correct Case
trans()
trans
函数使用本地文件翻译给定翻译键:
echo trans('messages.welcome');
如果指定翻译键不存在,trans
函数会返回给定键,所以,以上面的示例为例,如果翻译键不存在,trans
函数会返回 messages.welcome
。
trans_choice()
trans_choice
函数翻译带拐点的给定翻译键:
echo trans_choice('messages.notifications', $unreadCount);
如果指定的翻译键不存在,trans_choice
函数会将其返回。所以,以上面的示例为例,如果指定翻译键不存在 trans_choice
函数会返回 messages.notifications
。
URL函数
action()
action
函数为给定控制器动作生成 URL,你不需要传递完整的命名空间到该控制器,传递相对于命名空间 App\Http\Controllers
的类名即可:
$url = action('HomeController@index');
如果该方法接收路由参数,你可以将其作为第二个参数传递进来:
$url = action('UserController@profile', ['id' => 1]);
asset()
asset
函数使用当前请求的 scheme(HTTP 或 HTTPS)为前端资源生成一个 URL:
$url = asset('img/photo.jpg');
secure_asset()
secure_asset
函数使用 HTTPS 为前端资源生成一个 URL:
echo secure_asset('foo/bar.zip', $title, $attributes = []);
route()
route
函数为给定命名路由生成一个URL:
$url = route('routeName');
如果该路由接收参数,你可以将其作为第二个参数传递进来:
$url = route('routeName', ['id' => 1]);
默认情况下,route
函数生成的是绝对 URL,如果你想要生成一个相对 URL,可以传递 false
作为第三个参数:
$url = route('routeName', ['id' => 1], false);
secure_url
secure_url
函数为给定路径生成完整的 HTTPS URL:
echo secure_url('user/profile');
echo secure_url('user/profile', [1]);
url()
url
函数为给定路径生成完整URL:
echo url('user/profile');
echo url('user/profile', [1]);
如果没有提供路径,将会返回 Illuminate\Routing\UrlGenerator
实例:
echo url()->current();
echo url()->full();
echo url()->previous();
其它函数
abort()
abort
函数会抛出一个被异常处理器渲染的 HTTP 异常:
abort(403);
还可以提供异常响应文本以及自定义响应头:
abort(403, 'Unauthorized.', $headers);
abort_if()
abort_if
函数在给定布尔表达式为 true
时抛出 HTTP 异常:
abort_if(! Auth::user()->isAdmin(), 403);
和 abort
一样,你还可以传递异常响应文本作为第三个参数以及自定义响应头数组作为第四个参数。
abort_unless()
abort_unless
函数在给定布尔表达式为 false
时抛出 HTTP 异常:
abort_unless(Auth::user()->isAdmin(), 403);
和 abort
一样,你还可以传递异常响应文本作为第三个参数以及自定义响应头数组作为第四个参数。
app()
app
函数返回服务容器实例:
$container = app();
还可以传递类或接口名从容器中解析它:
$api = app('HelpSpot\API');
auth()
auth
函数返回一个认证器实例,为方便起见你可以用其取代 Auth
门面:
$user = auth()->user();
如果需要的话还可以指定你想要使用的 guard 实例:
$user = auth('admin')->user();
back()
back
函数生成重定向响应到用户前一个访问页面:
return back($status = 302, $headers = [], $fallback = false);
return back();
bcrypt()
bcrypt
函数使用 Bcrypt 对给定值进行哈希,你可以用其替代 Hash
门面:
$password = bcrypt('my-secret-password');
broadcast()
broadcast(new UserRegistered($user));
blank()
blank
函数返回给定值是否为空:
blank('');
blank(' ');
blank(null);
blank(collect());
// true
blank(0);
blank(true);
blank(false);
// false
与 blank
相对的是 filled
函数。
cache()
cache
函数可以用于从缓存中获取值,如果给定 key 在缓存中不存在,可选的默认值会被返回:
$value = cache('key');
$value = cache('key', 'default');
你可以通过传递数组键值对到函数来添加数据项到缓存。还需要传递缓存有效期(分钟数):
cache(['key' => 'value'], 5);
cache(['key' => 'value'], now()->addSeconds(10));
class_uses_recursive()
class_uses_recursive
函数某个类所使用的所有 trait,包括子类使用的:
$traits = class_uses_recursive(App\User::class);
collect()
collect
函数会根据提供的数据项创建一个集合:
$collection = collect(['taylor', 'abigail']);
config()
config
函数获取配置变量的值,配置值可以通过使用”.”号访问,包含文件名以及你想要访问的选项。如果配置选项不存在的话默认值将会被指定并返回:
$value = config('app.timezone');
$value = config('app.timezone', $default);
辅助函数 config
还可以用于在运行时通过传递键值对数组设置配置变量值:
config(['app.debug' => true]);
cookie()
cookie 函数可用于创建一个新的 Cookie 实例:
$cookie = cookie('name', 'value', $minutes);
csrf_field()
csrf_field
函数生成一个包含 CSRF 令牌值的 HTML 隐藏字段,例如,使用Blade语法示例如下:
{{ csrf_field() }}
csrf_token()
csrf_token
函数获取当前 CSRF 令牌的值:
$token = csrf_token();
dd()
dd
函数输出给定变量值并终止脚本执行:
dd($value);
dd($value1, $value2, $value3, ...);
如果你不想停止脚本的运行,可以使用 dump
函数。
decrypt()
decrypt
函数使用 Laravel 加密器对给定值进行解密:
$decrypted = decrypt($encrypted_value);
dispatch()
dispatch
函数推送一个新的任务到 Laravel 任务队列:
dispatch(new App\Jobs\SendEmails);
dispatch_now()
dispatch_now
函数会立即运行给定任务并返回 handle
方法处理结果:
$result = dispatch_now(new App\Jobs\SendEmails);
dump()
dump
函数会打印给定变量:
dump($value);
dump($value1, $value2, $value3, ...);
如果你想要在打印变量后终止脚本执行,可以使用 dd
函数替代之。
encrypt()
encrypt
函数使用 Laravel 加密器加密给定字符串:
$encrypted = encrypt($unencrypted_value);
env()
env
函数获取环境变量值或返回默认值:
$env = env('APP_ENV');
// 如果变量不存在返回默认值...
$env = env('APP_ENV', 'production');
注:如果你在开发过程中执行了
config:cache
命令,需要确保只在配置文件中调用了env
,一旦配置被缓存起来,.env
文件将不会被加载,因此所有对env
函数的调用都会返回null
。
event()
event
函数分发给定事件到对应监听器:
event(new UserRegistered($user));
factory()
factory
函数为给定类、名称和数量创建模型工厂构建器,可用于测试或数据填充:
$user = factory(App\User::class)->make();
filled()
filled
函数会返回给定值是否不为空:
filled(0);
filled(true);
filled(false);
// true
filled('');
filled(' ');
filled(null);
filled(collect());
// false
与 filled
相对的是 blank
函数。
info()
info
函数会记录信息到日志系统:
info('Some helpful information!');
还可以传递上下文数据数组到该函数:
info('User login attempt failed.', ['id' => $user->id]);
logger()
logger
函数可以用于记录 debug
级别的日志消息:
logger('Debug message');
同样,也可以传递上下文数据数组到该函数:
logger('User has logged in.', ['id' => $user->id]);
如果没有值传入该函数的话会返回logger实例:
logger()->error('You are not allowed here.');
method_field()
method_field
函数生成包含 HTTP 请求方法的 HTML hidden
表单字段,例如:
<form method="POST">
{{ method_field('DELETE') }}
</form>
now()
now
函数为当前时间创建一个新的 Illuminate\Support\Carbon
实例:
$now = now();
old()
old
函数获取存放在一次性 Session 中的值:
$value = old('value');
$value = old('value', 'default');
optional()
optional 函数接收任意参数并允许你访问对象上的属性或调用其方法。如果给定的对象为空,属性或方法调用返回 null
而不是出错:
return optional($user->address)->street;
{!! old('name', optional($user)->name) !!}
policy()
policy
函数为给定模型类获取对应策略实例:
$policy = policy(App\User::class);
redirect()
redirect
函数返回 HTTP 重定向响应,如果不带参数的话返回重定向器示例:
return redirect($to = null, $status = 302, $headers = [], $secure = null);
return redirect('/home');
return redirect()->route('route.name');
report()
report
函数会使用异常处理器的 report
方法报告异常:
report($e);
request()
request
函数返回当前请求实例或者获取一个输入项:
$request = request();
$value = request('key', $default);
rescue()
rescue
函数可以执行给定闭包并捕获执行过程中的所有异常。这些捕获的异常会发送给异常处理器的 report
方法,不过,请求会继续执行:
return rescue(function () {
return $this->method();
});
还可以传递第二个参数到 rescue
函数,作为在执行闭包出现异常的情况下返回的默认值:
return rescue(function () {
return $this->method();
}, false);
return rescue(function () {
return $this->method();
}, function () {
return $this->failure();
});
resolve()
resolve
函数使用服务容器将给定类或接口名解析为对应绑定实例:
$api = resolve('HelpSpot\API');
response()
response
函数创建一个响应实例或者获取响应工厂实例:
return response('Hello World', 200, $headers);
return response()->json(['foo' => 'bar'], 200, $headers);
retry()
retry
函数尝试执行给定回调直到达到最大执行次数,如果回调没有抛出异常,会返回对应的返回值。如果回调抛出了异常,会自动重试。如果超出最大执行次数,异常会被抛出:
return retry(5, function () {
// Attempt 5 times while resting 100ms in between attempts...
}, 100);
session()
session
函数可以用于获取/设置 Session 值:
$value = session('key');
可以通过传递键值对数组到该函数的方式设置 Session 值:
session(['chairs' => 7, 'instruments' => 3]);
如果没有传入参数到 session
函数则返回 Session 存储器对象实例:
$value = session()->get('key');
session()->put('key', $value);
tap()
tap
函数接收两个参数:任意的 $value
和一个闭包。$value
会被传递到闭包然后通过 tap
函数返回。闭包返回值与函数返回值不相关:
$user = tap(User::first(), function ($user) {
$user->name = 'taylor';
$user->save();
});
如果没有传入闭包到 tap
函数,那么你可以调用给定 $value
上面的任意方法,调用方法的返回值永远都是 $value
,不管在方法中定义的返回值是什么。例如,Eloquent update
方法通常返回一个整型,不过,我们可以通过 tap 函数强制该方法返回模型本身:
$user = tap($user)->update([
'name' => $name,
'email' => $email,
]);
today()
today
函数会为当前日期创建一个新的 Illuminate\Support\Carbon
实例:
$today = today();
throw_if()
throw_if
函数会在给定布尔表达式为 true
的情况下抛出给定异常:
throw_if(! Auth::user()->isAdmin(), AuthorizationException::class);
throw_if(
! Auth::user()->isAdmin(),
AuthorizationException::class,
'You are not allowed to access this page'
);
throw_unless()
throw_unless
函数会在给定布尔表达式为 false
的情况下抛出给定异常:
throw_unless(Auth::user()->isAdmin(), AuthorizationException::class);
throw_unless(
Auth::user()->isAdmin(),
AuthorizationException::class,
'You are not allowed to access this page'
);
trait_uses_recursive()
trait_uses_recursive
函数会返回某个 trait 使用的所有 trait:
$traits = trait_uses_recursive(\Illuminate\Notifications\Notifiable::class);
transform()
transform
函数会在给定值不为空的情况下执行闭包并返回闭包结果:
$callback = function ($value) {
return $value * 2;
};
$result = transform(5, $callback);
// 10
默认值或者闭包可以以第三个参数的方式传递给该函数,默认值在给定值为空的情况下返回:
$result = transform(null, $callback, 'The value is blank');
// The value is blank
validator()
validator
函数通过给定参数创建一个新的验证器实例,为方便起见可以使用它代替 Validator
门面:
$validator = validator($data, $rules, $messages);
value()
value
函数返回给定的值,不过,如果你传递一个闭包到该函数,该闭包将会被执行并返回执行结果:
$result = value(true);
// true
$result = value(function () {
return false;
});
// false
view()
view
函数获取一个视图实例:
return view('auth.login');
with()
with
函数返回给定的值,如果第二个参数是闭包,则返回闭包执行结果:
$callback = function ($value) {
return (is_numeric($value)) ? $value * 2 : 0;
};
$result = with(5, $callback);
// 10
$result = with(null, $callback);
// 0
$result = with(5, null);
// 5