本文档最新版为 ，旧版本可能放弃维护，推荐阅读最新版！

Laravel 包含各种各样的全局「辅助」PHP 函数，框架本身也大量地使用了这些功能；如果你觉得方便，你可以在你的应用中自由的使用它们。

如果给定的键不在数组中，那么 array_add 函数将会把给定的键/值对添加到数组中：

array_collapse 函数将多个单数组合并成一个数组：

array_divide 函数返回两个数组，一个包含原始数组的健，另一个包含原始数组的值：

array_dot 函数将多维数组平铺到一维数组中，该数组使用「点」符号表示深度：

array_except 函数从数组中删除给定的键/值对：

array_first 函数返回数组中第一个通过指定测试的元素：

将默认值作为第三个参数传递给该方法。如果没有值通过测试，则返回该值：

array_flatten 函数将多维数组平铺为一维数组。

array_forget 函数使用「点」符号从深度嵌套数组中移除给定的键/值对：

array_get 函数使用「点」符号从深度嵌套的数组中检索值：

array_get 函数也接受一个默认值，如果没有找到指定的健，则返回该值：

array_has 函数使用「点」符号检查数组中是否存在给定的项目或项目组：

array_last 函数返回数组中最后一个通过指定测试的元素：

将默认值作为第三个参数传递给该方法。如果没有值通过测试，则返回该值：

array_only 函数仅返回给定数组中指定的键/值对：

array_pluck 函数从数组中检索给定键的所有值：

你也可以指定生成的列表的键：

array_prepend 函数将一个项目推到数组的开头：

你可以指定用于该值的键：

array_pull 函数返回并从数组中删除键/值对：

将默认值作为第三个参数传递给该方法。如果键不存在，则返回该值：

array_random 函数从数组中返回一个随机值：

你也可以指定要返回的随机数的数量作为第二个可选参数。一旦你指定了第二个参数，即使数量为 1，这个函数也会返回一个数组：

array_set 函数使用「点」符号在深度嵌套的数组中设置一个值：

你也可以按给定的闭包返回的结果对数组进行排序：

array_where 函数使用给定的闭包来过滤数组：

array_wrap 函数将给定的值包装成一个数组。如果给定的值已经是一个数组，则不会被改变：

data_fill 函数使用「点」符号在嵌套数组或对象内设置缺少的值：

该函数也接受星号「*」作为通配符，并相应地填写目标：

data_get 函数使用「点」符号从嵌套数组或对象中检索值：

data_get 函数还接受默认值作为第三个参数，如果找不到指定的键，将返回该值：

data_set 函数使用「点」符号在嵌套数组或对象内设置一个值：

这个函数也接受通配符「*」，并相应地在目标上设置值：

默认情况下，所有现有的值都会被覆盖。如果你只想设置一个不存在值，你可以传递 false 作为第三个参数：

head 函数返回给定数组中的第一个元素：

last 函数返回给定数组中的最后一个元素：

app_path 返回 app 目录的完整路径。你还可以使用 app_path 函数来生成相对于 app 目录的文件完整路径：

base_path 函数返回项目根目录的完整路径。你还可以使用 base_path 函数生成指定文件相对于项目根目录的完整路径：

config_path 函数返回应用程序配置目录的完整路径。你也可以使用 config_path 函数来生成应用程序配置目录中给定文件的完整路径：

database_path 函数返回应用程序数据库目录的完整路径。你也可以使用 database_path 函数来生成数据库目录中给定文件的完整路径：

mix 函数获取 的路径：

resource_path 函数返回 resources 目录的完整路径。你也可以使用 resource_path 函数来生成相对于资源目录的指定文件的完整路径：

storage_path 函数返回 storage 目录的完整路径。你也可以使用 storage_path 来生成相对于储存目录的指定文件的完整路径：

__ 函数使用你的 来翻译给定的翻译字符串或翻译键：

如果指定的翻译字符串或键不存在，则 __ 函数会简单地返回给定的值。所以，按照上面的例子，如果翻译键 messages.welcome 不存在，__ 方法会将其直接返回。

camel_case 函数将给定的值符传转换为「驼峰命名」：

ends_with 函数判断给定的字符串是否以给定的值结尾：

kebab_case 函数将给定的字符串转换为「短横线命名」：

preg_replace_array 函数使用数组顺序替换字符串中的给定模式：

snake_case 函数将给定的字符串转换为「蛇形命名」：

starts_with 函数判断给定的字符串的开头是否是指定值：

str_after 函数返回字符串中指定值之后的所有内容：

str_before 函数返回字符串中给定值之前的所有内容：

str_contains 函数判断给定的字符串是否包含给定的值：

你也可以传递一个值的数组来判断给定的字符串是否包含任何值：

str_finish 函数将给定字符串以给定值结尾返回（如果它尚未以给定值结尾）：

str_is 函数判断给定的字符串是否匹配给定的模式。星号可以用来表示通配符：

str_limit 函数按给定的长度截断给定的字符串：

你也可以传递第三个参数来改变将被追加到最后的字符串：

str_plural 函数将字符串转换为复数形式。这个函数目前仅支持英文：

你可以提供一个整数作为函数的第二个参数来检索字符串的单数或复数形式：

str_replace_array 函数使用数组顺序替换字符串中的给定值：

str_replace_first 函数替换字符串中给定值的第一个匹配项：

str_replace_last 函数替换字符串中最后一次出现的给定值：

str_singular 函数将字符串转换为单数形式。这个函数目前仅支持英文：

str_slug 函数根据给定的字符串生成一个 URL 友好的「slug」：

str_start 函数将给定值的单个实例添加到字符串（如果它尚未以值开始）：

studly_case 函数将给定的字符串转换为「变种驼峰命名」：

title_case 函数将给定的字符串转换为「首字母大写」：

trans 函数使用你的 来翻译给定的翻译字符串或翻译键：

如果指定的翻译键不存在，则 trans 方法会简单地返回给定的键。所以，就上面的例子而言，如果翻译键不存在， trans 方法会返回 messages.welcome。

trans_choice 函数根据词形变化来翻译给定的翻译键：

如果指定的翻译键不存在，trans_choice 方法会简单地返回给定的键。所以，按照上面的例子，如果翻译键不存在，trans_choice 方法会返回 messages.notifications。

action 函数为指定的控制器动作生成一个 URL。你不需要传递完整的控制器命名空间。只需要传递相对于 App\Http\Controllers 的命名空间的控制器类名称：

如果该方法接受路由参数，则可以将它们作为方法的第二个参数传递：

route 函数为给定的命名路由生成一个 URL：

如果路由接受参数，则可以将它们作为方法的第二个参数传递：

默认情况下，route 函数生成的是绝对 URL。如果你想生成一个相对 URL，你可以传递 false 作为第三个参数：

url 函数生成给定路径的标准 URL：

abort 函数抛出 程序呈现的 ：

你也可以提供额外的响应文本和自定义响应标头：

如果给定的布尔表达式计算结果为 true， abort_if 函数将抛出一个 HTTP 异常：

和 abort 方法一样，你也可以提供异常的响应文本作为第三个参数，并提供一个自定义响应头数组作为第四个参数。

如果给定的布尔表达式计算结果为 false，abort_unless 函数将抛出一个 HTTP 异常：

和 abort 方法一样，你也可以提供异常的响应文本作为第三个参数，并提供一个自定义响应头数组作为第四个参数。

app 函数返回 实例

你可以传递一个类或接口名称来从容器中解析它：

auth 函数返回一个 实例。为了方便起见，你可以使用它来替代 Auth facade：

如果需要，你可以指定你想要访问的认证实例：

back() 函数生成一个 到用户之前的位置：

broadcast 函数将 给定的 到它的监听器：

blank 函数判断给定的值是否为「空」：

要使用与 blank 相反的功能，请看 方法。

cache 函数可以用来从缓存中获取值。如果缓存中不存在给定的健，则返回一个可选的默认值：

你可以通过将一组键/值对传递给函数来将其添加到缓存中。与此同时，你还应该传递有效的分钟数或持续时间作为缓存过期时间：

collect 函数根据给定的数组创建一个 实例：

config 函数获取 变量的值。可以使用「点」语法访问配置值，其中包括文件的名称和希望访问的选项。如果配置选项不存在，则可以指定一个默认值并返回：

可以在运行时通过传递一组键/值对来设置配置变量：

cookie 函数创建一个新的 实例：

dd 函数输出给定的值并结束脚本运行：

如果你不想终止脚本运行，请改用 dump 函数。

dump 函数打印给定的变量：

如果要在打印变量后停止执行脚本，请改用 函数。

env 函数获取 的值或者返回默认值：

event 函数将给定的 分派给它的监听器：

factory 函数根据给定的类、名称和数量创建一个模型工厂构建器。可以在 or 中使用：

filled 函数判断给定的值是否不为「空」：

要使用与 filled 相反的功能，请看 方法。

info 函数将信息写入日志：

有前后关系的数组也可以传递给函数：

logger 函数可以将一个 debug 级别的消息写入到 中：

有前后关系的数组也可以传递给函数：

如果没有传值给函数则返回 的实例：

old 函数 会话中闪存的 值：

optional 函数可以接受任何参数，并且允许你访问该对象的属性或者调用方法。如果给定的对象是 null ， 那么属性和方法会简单地返回 null 而不是产生一个错误：

policy 方法为给定的类获取一个 实例：

redirect 函数返回一个 ，如果没有没有传入参数，则返回重定向实例：

request 函数返回当前 实例或者获取输入项：

rescue 函数执行给定的闭包并捕获执行期间发生的任何异常。所有被捕获的异常将被发送到你的 的 report 方法。要注意的是，该请求将继续处理：

你也可以将第二个参数传递给 rescue 方法。如果在执行闭包时发生异常，这个参数将是应该返回的默认值：

resolve 函数使用 将给定的类或接口名称解析为其实例：

response 函数创建 实例或者获取响应工厂实例：

retry 函数尝试执行给定的回调，直到到达给定的最大尝试次数。如果回调没有抛出异常，则返回值将被返回。如果回调抛出异常，它将自动重试。如果超过最大尝试次数，则会抛出异常：

session 函数可以用来获取或者设置 值：

你可以通过将一组键/值对传递给该函数来设置值：

如果没有传递值给函数，则返回 Session 实例：

tap 函数接受两个参数：一个任意的 $value 和一个闭包。$value 将被传递给闭包，然后由 tap 函数返回。不需要在闭包中使用 return 返回值。

如果没有闭包被传递给 tap 函数，你可以调用给定 $value 的任何方法。而你调用的方法的返回值始终为 $value ，无论方法在其定义中实际返回的是什么。例如，Eloquent 的 update 方法通常会返回一个整数。但是，我们可以强制通过 tap 函数链式调用 update 方法来返回模型本身：

如果给定的布尔表达式计算结果为 true，throw_if 函数抛出给定的异常：

如果给定的布尔表达式计算结果为false，则 throw_unless函数会抛出给定的异常：

如果给定的值不为空，那么 transform 函数对给定的值执行闭包并返回其结果：

默认值或闭包也可以作为方法的第三个参数传递。如果给定值为空白，则返回该值：

validator 函数用给定的参数创建一个新的 实例。为方便起见，你可以使用它来代替 Validator facade ：

value 函数返回给定的值。但是，如果将一个闭包传递给该函数，则将执行该闭包并返回其结果：

view 函数获取一个 实例：

with 函数会返回给定的值。如果传入一个闭包作为该函数的第二个参数，会返回闭包执行的结果：

{note} 欢迎任何形式的转载，但请务必注明出处，尊重他人劳动共创开源社区。

转载请注明：本文档由 Laravel China 社区 组织翻译，详见 。