数组&对象
1.array_divide()
array_divide 函数返回两个数组,一个包含原始数组的健,另一个包含原始数组的值
[$keys, $values] = array_divide(['name' => 'Desk']);
dd($keys, $values);
结果:
2.array_dot()
array_dot 函数将多维数组平铺到一维数组中,该数组使用「点」符号表示深度
$array = ['products' => ['desk' => ['price' => 100,'sum'=>10],'test'=>['price' => 1000,'sum'=>100]]];
$flattened = array_dot($array);
dd($flattened);
结果:
3.array_except()
array_except 函数从数组中删除给定的键/值对
$array = ['name' => 'Desk', 'price' => 100];
$filtered = array_except($array, ['name']);
dd($filtered);
结果:
4.array_first()
array_first 函数返回数组中第一个通过指定测试的元素
$array = [100, 200, 300];
$first = array_first($array, function ($value, $key) {
return $value >= 150;
});
dd($first);
结果:
将默认值作为第三个参数传递给该方法。如果没有值通过测试,则返回该值:$first = array_first($array, $callback, $default);
5.array_flatten()
array_flatten 函数将多维数组平铺为一维数组
$array = ['name' => 'Joe', 'languages' => ['PHP', 'Ruby'=>'123']];
$flattened = array_flatten($array);
dd($flattened)
结果:
6.array_forget()
array_forget 函数使用「点」符号从深度嵌套数组中移除给定的键/值对
$array = ['products' => ['desk' => ['price' => 100]]];
array_forget($array, 'products.desk');
dd($array);
结果:
7.array_get()
array_get 函数使用「点」符号从深度嵌套的数组中检索值
$array = ['products' => ['desk' => ['price' => 100]]];
$price = array_get($array, 'products.desk.price');
dd($price);
结果:
array_get 函数也接受一个默认值,如果没有找到指定的健,则返回该值:
$discount = array_get($array, 'products.desk.discount', 0);
8.array_only()
array_only 函数仅返回给定数组中指定的键/值对
$array = ['name' => 'Desk', 'price' => 100, 'orders' => 10];
$slice = array_only($array, ['name', 'price']);
dd($slice);
结果:
9.array_pluck()
array_pluck 函数从数组中检索给定键的所有值
$array = [
['developer' => ['id' => 1, 'name' => 'Taylor']],
['developer' => ['id' => 2, 'name' => 'Abigail']],
];
$names = array_pluck($array, 'developer.name');
dd($names);
结果:
你也可以指定生成的列表的键
$array = [
['developer' => ['id' => 2, 'name' => 'Taylor']],
['developer' => ['id' => 1, 'name' => 'Abigail']],
];
$names = array_pluck($array, 'developer.name','developer.id');
dd($names);
结果:
10.array_pull()
array_pull 函数返回并从数组中删除键/值对
$array = ['name' => 'Desk', 'price' => 100];
$name = array_pull($array, 'name');
dd($name,$array);
结果:
将默认值作为第三个参数传递给该方法。如果键不存在,则返回该值
$value = array_pull($array, $key, $default);
11.array_random()
array_random 函数从数组中返回一个随机值
$array = [1, 2, 3, 4, 5];
$random = array_random($array);
dd($random);
结果:
你也可以指定要返回的随机数的数量作为第二个可选参数。一旦你指定了第二个参数,即使数量为 1,这个函数也会返回一个数组
$array = [1, 2, 3, 4, 5];
$random = array_random($array,3);
dd($random);
结果:
12.array_where()
array_where 函数使用给定的闭包来过滤数组
$array = [100, '200', 300, '400', 500];
$filtered = array_where($array, function ($value, $key) {
return is_string($value);
});
dd($filtered);
结果:
13.data_get()
data_get 函数使用「点」符号从嵌套数组或对象中检索值
$data = ['products' => ['desk' => ['price' => 100]]];
$price = data_get($data, 'products.desk.price');
dd($price);
结果:
data_get 函数还接受默认值作为第三个参数,如果找不到指定的键,将返回该值
$discount = data_get($data, 'products.desk.discount', 0);
14.head() 函数返回给定数组中的第一个元素
15.last() 函数返回给定数组中的最后一个元素
16.app_path()
app_path 返回 app 目录的完整路径。你还可以使用 app_path 函数来生成相对于 app 目录的文件完整路径
$path = app_path();
dd($path);
$path = app_path('Http\Controllers\Controller.php');
dd($path);
17.base_path()
base_path 函数返回项目根目录的完整路径。你还可以使用 base_path 函数生成指定文件相对于项目根目录的完整路径
$path = base_path();
dd($path);
$path = base_path('vendor\bin');
dd($path);
18.config_path() config_path 函数返回应用程序 config 目录的完整路径。你也可以使用 config_path 函数来生成应用程序配置目录中给定文件的完整路径
19.database_path() database_path 函数返回应用程序 database 目录的完整路径。你也可以使用 database_path 函数来生成数据库目录中给定文件的完整路径
20.public_path() public_path函数返回应用程序 public目录的完整路径。你也可以使用 public_path函数来生成public目录中给定文件的完整路径
21.resource_path() 函数返回应用程序 resource目录的完整路径。你也可以使用 resource_path函数来生成resource目录中给定文件的完整路径
21.storage_path() 函数返回应用程序 storage目录的完整路径。你也可以使用 storage_path函数来生成storage目录中给定文件的完整路径
字符串
1.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);
dd($replaced);
结果:
2.str_random()
str_random 函数生成一个指定长度的随机字符串。这个函数数用 PHP 的 random_bytes 函数
$random = str_random(30);
dd($random);
3.str_replace_array()
str_replace_array 函数使用数组顺序替换字符串中的给定值
$string = '该活动将于 ? 至 ? 之间举行';
$replaced = str_replace_array('?', ['8:30', '9:00'], $string);
dd($replaced);
URLs
action()
action 函数为指定的控制器动作生成一个 URL。你不需要传递完整的控制器命名空间。只需要传递相对于 App\Http\Controllers 的命名空间的控制器类名称:
$url = action('HomeController@index');
如果该方法接受路由参数,则可以将它们作为方法的第二个参数传递:
$url = action('UserController@profile', ['id' => 1]);
asset()
asset 函数使用当前请求的协议( HTTP 或 HTTPS )为资源文件生成 URL:
$url = asset('img/photo.jpg');
secure_asset()
secure_asset 函数使用 HTTPS 协议为资源文件生成 URL:
$url = secure_asset('img/photo.jpg');
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:
$url = secure_url('user/profile'); $url = secure_url('user/profile', [1]);
url()
url 函数生成给定路径的标准 URL:
$url = url('user/profile'); $url = url('user/profile', [1]);
如果没有提供路径,则返回 Illuminate\Routing\UrlGenerator 实例:
$current = url()->current(); $full = url()->full(); $previous = url()->previous();
其他
abort()
abort 函数抛出 异常处理 程序呈现的 HTTP 异常:
abort(403);
你也可以提供额外的响应文本和自定义响应标头:
abort(403, 'Unauthorized.', $headers);
abort_if()
如果给定的布尔表达式计算结果为 true, abort_if 函数将抛出一个 HTTP 异常:
abort_if(! Auth::user()->isAdmin(), 403);
和 abort 方法一样,你也可以提供异常的响应文本作为第三个参数,并提供一个自定义响应头数组作为第四个参数。
abort_unless()
如果给定的布尔表达式计算结果为 false,abort_unless 函数将抛出一个 HTTP 异常:
abort_unless(Auth::user()->isAdmin(), 403);
和 abort 方法一样,你也可以提供异常的响应文本作为第三个参数,并提供一个自定义响应头数组作为第四个参数。
app()
app 函数返回 服务容器 实例:
$container = app();
你可以传递一个类或接口名称来从容器中解析它:
$api = app('HelpSpot\API');
auth()
auth 函数返回一个 认证 实例。为了方便起见,你可以使用它来替代 Auth Facade:
$user = auth()->user();
如果需要,你可以指定你想要访问的认证实例:
$user = auth('admin')->user();
back()
back 函数生成一个重定向 HTTP 响应到用户之前的位置:
return back($status = 302, $headers = [], $fallback = false); return back();
bcrypt()
bcrypt 哈希 使用 Bcrypt 对给定的值进行散列。你可以使用它替代 Hash facade:
$password = bcrypt('my-secret-password');
broadcast()
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 函数可以用来从缓存中获取值。如果缓存中不存在给定的健,则返回一个可选的默认值:
$value = cache('key'); $value = cache('key', 'default');
你可以通过将一组键/值对传递给函数来将其添加到缓存中。与此同时,你还应该传递有效的分钟数或持续时间作为缓存过期时间:
cache(['key' => 'value'], 5); cache(['key' => 'value'], now()->addSeconds(10));
class_uses_recursive()
class_uses_recursive 函数返回一个类使用的所有 traits,包括任何子类使用的 traits:
$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(['app.debug' => true]);
cookie()
cookie 函数创建一个新的 cookie 实例:
$cookie = cookie('name', 'value', $minutes);
csrf_field()
csrf_field 函数生成包含 CSRF 令牌值的 HTMLhidden 表单字段。例如,使用 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');
{note} 如果在你在部署过程中执行 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('一些有用的信息!');
有前后关系的数组也可以传递给函数:
info('用户登录尝试失败。', ['id' => $user->id]);
logger()
logger 函数可以将一个 debug 级别的消息写入到日志中:
logger('Debug 消息');
有前后关系的数组也可以传递给函数:
logger('User has logged in.', ['id' => $user->id]);
如果没有传值给函数则返回日志的实例:
logger()->error('You are not allowed here.');
method_field()
method_field 函数生成一个 HTML hidden 表单字段,其中包含表单的 HTTP 动作的欺骗值。例如,使用 Blade 语法:
<form method="POST">
{{ method_field('DELETE') }}
</form>
now()
now 函数为当前时间创建一个新的 Illuminate\Support\Carbon 实例:
$now = now();
old()
old 函数 获取 会话中闪存的 旧输入 值:
$value = old('value'); $value = old('value', 'default');
optional()
optional 函数可以接受任何参数,并且允许你访问该对象的属性或者调用方法。如果给定的对象是 null, 那么属性和方法会简单地返回 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 () {
// 在 100ms 左右尝试 5 次...
}, 100);
session()
session 函数可以用来获取或者设置 Session 值:
$value = session('key');
你可以通过将一组键/值对传递给该函数来设置值:
session(['chairs' => 7, 'instruments' => 3]);
如果没有传递值给函数,则返回 Session 实例:
$value = session()->get('key'); session()->put('key', $value);
tap()
tap 函数接受两个参数:一个任意的 $value 和一个闭包。$value 将被传递给闭包,然后由 tap 函数返回。不需要在闭包中使用 return 返回值。
$user = tap(User::first(), function ($user) {
$user->name = 'taylor'; $user->save();
});
如果没有闭包被传递给 tap 函数,你可以调用给定 $value 的任何方法。而你调用的方法的返回值始终为 $value ,无论方法在其定义中实际返回的是什么。例如,Eloquent 的 update 方法通常会返回一个整数。但是,我们可以强制通过 tap 函数链式调用 update 方法来返回模型本身:
$user = tap($user)->update([
'name' => $name,
'email' => $email,
]);
today()
today 函数为当前日期创建一个新的 Illuminate\Support\Carbon 实例:
$today = today();
throw_if()
如果给定的布尔表达式计算结果为 true,throw_if 函数抛出给定的异常:
throw_if(! Auth::user()->isAdmin(), AuthorizationException::class); throw_if(
! Auth::user()->isAdmin(),
AuthorizationException::class,
'You are not allowed to access this page'
);
throw_unless()
如果给定的布尔表达式计算结果为 false,则 throw_unless 函数会抛出给定的异常:
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:
$traits = trait_uses_recursive(\Illuminate\Notifications\Notifiable::class);
transform()
如果给定的值不为 blank 并且返回 Closure,那么 transform 函数对给定的值执行 Closure 并返回其结果:
$callback = function ($value) {
return $value * 2;
}; $result = transform(5, $callback); //
默认值或 Closure 也可以作为方法的第三个参数传递。如果给定值为空白,则返回该值:
$result = transform(null, $callback, 'The value is blank'); // The value is blank
validator()
validator 函数用给定的参数创建一个新的验证器实例。为方便起见,你可以使用它来代替 Validator facade :
$validator = validator($data, $rules, $messages);
value()
value 函数返回给定的值。但是,如果将一个 Closure 传递给该函数,则将执行该 Closure 并返回其结果:
$result = value(true); // true $result = value(function () {
return false;
}); // false
view()
view 函数获取一个视图实例:
return view('auth.login');
with()
with 函数会返回给定的值。如果传入一个 Closure 作为该函数的第二个参数,会返回 Closure 执行的结果:
$callback = function ($value) {
return (is_numeric($value)) ? $value * 2 : 0;
}; $result = with(5, $callback);
// $result = with(null, $callback);
// $result = with(5, null);
//