【整理分享】几个实用的 Laravel 辅助函数

时间：2022-12-28 21:01

作为一个以Laravel为主的PHP全栈开发人员，我会经常去寻找一些框架中、可以为我所用的、有效减少开发时间或者减少代码复杂性的方法。下面是我整理的在平常会经常用到的一些不错的辅助方法。让我们一探究竟吧 ✨

文中方法大都基于Laravel7以及更早的版本。（如果遇到问题，请先检查是否是版本兼容问题）

Str::limit()

我们的第一个辅助函数 获取一个字符串并用一个设定的字符长度限制截断它 。它有两个必须参数：你想截断的字符串，以及返回的被截断的字符串的字符长度限制。【相关推荐：laravel视频教程】

use Illuminate\Support\Str;

$truncated = Str::limit('The quick brown fox jumps over the lazy dog', 20);

// The quick brown fox ...

你也可以传入第三个可选参数来控制返回的字符串后显示什么。

use Illuminate\Support\Str;

$truncated = Str::limit('The quick brown fox jumps over the lazy dog', 20, '[...]');

// The quick brown fox [...]

我发现这用于把一大段文本缩短为摘要或文章列表的帖子预览是完美的。

head()

这个功能超赞。一个简单的方法通常由几个嵌套的原始PHP函数组成，head()会返回数组的第一个元素。由于其全局性和无处不在的性质，我已经在许多不同的应用程序中使用了它。

$array = [100, 200, 300];

$first = head($array);

// 100

想要反着来吗？使用last方法可以获取数组的最后一个元素。

$array = [100, 200, 300];

$last = last($array);

// 300

这是关于使用head和last方法的最佳方法，因为它们根本不影响原始数组。

Str::between()

顾名思义， Str::between() 会 返回字符串中的内容。如果没有找到指定字符串，返回 null 。

use Illuminate\Support\Str;

$slice = Str::between('My name is Inigo Montoya.', 'My name is ', '.');

// 'Inigo Montoya'

我喜欢用这种方式从 () 或 [] 之间获取信息、返回 url 中的特定部分、甚至是从 html 标签中解析数据。

blank()

它 和empty()差不多，但是更好用。它根据你传入的参数是否包含实际数据，来返回一个布尔值。

// all of these return true
blank('');
blank('   ');
blank(null);
blank(collect());

// all of these return false
blank(true);
blank(false);
blank(0);

这个辅助函数在结合表单验证、除去 API 中没有规范输入的数据时，特别有用。
它比 empty(trim()) 更好用。

Str::contains()

我们期待已久的辅助函数, 确定一个字符串中是否包含另一个字符串. 这个问题在 StackOverflow 和其他编程论坛上已经被问过很多次了, 因为目前在普通PHP程序中只能使用 strpos.

use Illuminate\Support\Str;

$contains = Str::contains('My name is Inigo Montoya.', 'Inigo');

// true

$contains = Str::contains('My name is Inigo Montoya.', 'Andrew');

// false

随着最近的rfc的批准，PHP将很快拥有自己的str_contains方法，这将使该方法过时。不过在此之前，它是Laravel中最有用的辅助函数之一。

Arr::pluck()

该方法可以说是我在本文中列出的更强大的方法之一，Arr::pluck 遍历多维数组并检索给定键的所有值。

让我们来看一个简单的例子：

use Illuminate\Support\Arr;

$array = [
    ['website' => ['id' => 1, 'url' => 'reddit.com']],
    ['website' => ['id' => 2, 'url' => 'twitter.com']],
    ['website' => ['id' => 3, 'url' => 'dev.to']],
];

$names = Arr::pluck($array, 'website.url');

// ['reddit.com', 'twitter.com', 'dev.to']

传入一个数组和一个点符号字符串来确定我们想要的键值，然后遍历多维数组，并将指定键所对应值的一维数组返回给我们。

我在返回的API数据中多次使用过该方法（当我觉得不需要使用整个的集合时）。它使获得ID，名称或其他属性的数组变得非常容易，而无需创建整个foreach循环。

collect()

一旦发现集合有关的信息，我就不会停止使用它们。这可能是我发现自己最常使用的助手函数，它可以让您 将数组转换为集合。

为什么这很重要？因为集合带有大量的便捷方法，您可以将它们组合在一起用最简单的闭包参数对数组执行各种过滤，排序和修改等操作。没有foreach 循环，没有中间变量，只是干净的代码。

看看这个简单的例子：

$collection = collect(['Keys', 'Krates']);

return $collection->map(function ($value) {
    return Str::upper($value);
});

// ['KEYS', 'KRATES']

return $collection->filter(function ($value) {
    return strlen($value) > 4;
});

// ['Krates']

老实说，这只是集合的冰山一角。我在项目中都使用了它们，尤其是当我要处理不是来自数据库模型的庞大而复杂的数据集时。 CSV 数据，外部API请求和目录结构都可以从放入集合中使用。

这就是我现在所了解的！