带函数 Laravel - PHP

Laravel 是一个流行的 PHP 框架，它提供了许多方便的功能和工具，可以让开发人员快速构建现代 Web 应用程序。其中一个最有用的功能就是带函数 (Helper Functions)，它们可以帮助开发人员更快捷地编写代码。

什么是带函数？

带函数其实就是一些方便的函数，它们是定义在全局命名空间中的，可以在任何地方都可以使用。Laravel 带函数的设计初衷是为了简化开发人员的工作，减少重复的代码和提高代码的可读性和可维护性。

Laravel 带函数的种类

Laravel 提供了许多不同类型的带函数，包括数组、字符串、日期、路径、请求和响应等等。下面我们来一一介绍它们。

数组带函数

• array_add(array $array, string $key, mixed $value): array：向数组中添加一个键值对，如果键已经存在，将新值合并到原值中。
• array_divide(array $array): array：将一个数组拆分成两个数组，一个包含所有键，另一个包含所有值。
• array_except(array $array, array|string $keys): array：从数组中移除指定键的键值对。
• array_first(array $array, callable $callback = null, mixed $default = null): mixed：返回数组中第一个满足回调函数的元素值。
• array_flatten(array $array, int $depth = INF): array：将一个多维数组转换为一个一维数组。
• array_get(array $array, string $key, mixed $default = null): mixed：获取数组指定键的值，如果键不存在返回默认值。
• array_has(array $array, string $key): bool：判断数组是否具有指定的键。
• array_only(array $array, array|string $keys): array：从数组中只保留指定键的键值对。
• array_pluck(array $array, string $value, string|null $key = null): array： 获取数组中指定键的值并返回一个新的数组。
• array_pull(array &$array, string $key, mixed $default = null): mixed：从数组中弹出指定键的值并返回该值。
• array_set(array &$array, string $key, mixed $value): void：设置数组的指定键为指定值。
• array_sort(array $array, callable|string|null $callback = null): array：对数组进行排序。

字符串带函数

• camel_case(string $value): string：将字符串转换为骆驼命名法。
• ends_with(string $haystack, string|array $needles): bool：判断字符串结尾是否为指定子字符串。
• kebab_case(string $value): string：将字符串转换为短横线命名法。
• snake_case(string $value, string $delimiter = '_'): string：将字符串转换为下划线命名法。
• starts_with(string $haystack, string|array $needles): bool：判断字符串开头是否为指定子字符串。
• str_contains(string $haystack, string $needle): bool：判断字符串是否包含指定子字符串。
• str_finish(string $value, string $cap): string：给字符串添加指定结尾字符。
• str_limit(string $value, int $limit = 100, string $end = '...'): string：将字符串截断为指定长度并添加指定结尾字符。
• str_plural(string $value, int $count = 2): string：将字符串转换为复数形式。
• str_random(int $length = 16): string：生成指定长度的随机字符串。
• str_replace_array(string $search, array $replace, string $subject): string：将多个字符串替换为一个字符串。
• studly_case(string $value): string：将字符串转换为帕斯卡命名法。

日期带函数

• carbon(string $time = null, string|null $tz = null): Carbon\Carbon：创建一个 Carbon 实例，用于处理日期和时间。
• now(string $tz = null): Carbon\Carbon：获取当前日期和时间。
• today(string $tz = null): Carbon\Carbon：获取今天的日期。
• tomorrow(string $tz = null): Carbon\Carbon：获取明天的日期。
• yesterday(string $tz = null): Carbon\Carbon：获取昨天的日期。

路径带函数

• app_path(string $path = ''): string：获取应用程序的基础路径。
• base_path(string $path = ''): string：获取应用程序的根路径。
• config_path(string $path = ''): string：获取应用程序的配置文件路径。
• database_path(string $path = ''): string：获取应用程序的数据库目录路径。
• public_path(string $path = ''): string：获取应用程序的公共目录路径。
• resource_path(string $path = ''): string：获取应用程序的资源目录路径。
• storage_path(string $path = ''): string：获取应用程序的存储目录路径。

请求和响应带函数

• abort(int $code, string $message = '', array $headers = []): void：抛出 HTTP 异常，并将其发送给浏览器。
• redirect(string $url, int $status = 302, array $headers = [], bool|null $secure = null): \Illuminate\Routing\Redirector：重定向到指定的 URL。
• response(string $content = '', int $status = 200, array $headers = []): \Illuminate\Http\Response：返回一个响应对象。

使用带函数

使用带函数非常简单，只需在任何地方直接调用即可。以 array_has 函数为例，我们可以像这样使用它：

if (array_has($array, 'name')) {
    // 处理逻辑
}

总结

带函数是 Laravel 框架提供的一些实用函数，可以极大地简化开发人员的编程工作。它们提供了许多不同类型的功能，包括数组、字符串、日期、路径、请求和响应等等。在使用 Laravel 进行开发时，我们应该充分利用这些便利函数，提高开发效率。