README

简介

一种简单易用的Laravel风格创建面包屑。

本项目是官方分支，基于Dave James Miller的原始Laravel Breadcrumbs项目，并得益于众多出色的早期贡献者。感谢大家！

兼容性图表

对于较旧的Laravel版本，您需要使用原始GitHub项目。

入门

1. 安装Laravel Breadcrumbs

composer require diglactic/laravel-breadcrumbs

2. 定义您的面包屑

创建一个名为 routes/breadcrumbs.php 的文件，内容如下

<?php

// Home
Breadcrumbs::for('home', function ($trail) {
    $trail->push('Home', route('home'));
});

// Home > About
Breadcrumbs::for('about', function ($trail) {
    $trail->parent('home');
    $trail->push('About', route('about'));
});

// Home > Blog
Breadcrumbs::for('blog', function ($trail) {
    $trail->parent('home');
    $trail->push('Blog', route('blog'));
});

// Home > Blog > [Category]
Breadcrumbs::for('category', function ($trail, $category) {
    $trail->parent('blog');
    $trail->push($category->title, route('category', $category->id));
});

// Home > Blog > [Category] > [Post]
Breadcrumbs::for('post', function ($trail, $post) {
    $trail->parent('category', $post->category);
    $trail->push($post->title, route('post', $post->id));
});

有关更多详细信息，请参阅定义面包屑部分。

3. 选择一个模板

默认情况下，将渲染一个与Bootstrap兼容的有序列表，所以如果您使用Bootstrap 4，则可以跳过此步骤。

首先，通过运行以下命令初始化配置文件

php artisan vendor:publish --tag=breadcrumbs-config

然后，打开 config/breadcrumbs.php 并编辑此行

    'view' => 'breadcrumbs::bootstrap4',

可能的值包括

breadcrumbs::bootstrap5 – Bootstrap 5
breadcrumbs::bootstrap4 – Bootstrap 4
breadcrumbs::bootstrap3 – Bootstrap 3
breadcrumbs::bootstrap2 – Bootstrap 2
breadcrumbs::bulma – Bulma
breadcrumbs::foundation6 – Foundation 6
breadcrumbs::json-ld – JSON-LD结构化数据
breadcrumbs::materialize – Materialize
breadcrumbs::tailwind – Tailwind CSS
breadcrumbs::uikit – UIkit (<script>标签，无可见输出)
自定义视图的路径：例如 partials.breadcrumbs

有关更多详细信息，请参阅自定义模板部分。

4. 输出面包屑

最后，在每页的视图中调用 Breadcrumbs::render()，传递要使用的面包屑名称和任何其他参数 - 例如

{{ Breadcrumbs::render('home') }}

{{ Breadcrumbs::render('category', $category) }}

请参阅输出面包屑部分以了解其他输出选项，并查看路由绑定面包屑以自动将面包屑名称链接到路由名称的方法。

定义面包屑

面包屑通常与动作或页面类型相对应。对于每个面包屑，您需要指定一个名称、面包屑标题和链接到的URL。由于这些内容可能需要动态更改，您应该在闭包中执行此操作，并将任何需要的变量传递给闭包。

以下示例应该能使其更加清晰

静态页面

最简单的面包屑可能是您的首页，其外观可能如下所示

Breadcrumbs::for('home', function ($trail) {
     $trail->push('Home', route('home'));
});

如你所见，您只需在闭包内调用$trail->push($title, $url)即可。

对于生成URL，您可以使用任何标准的Laravel URL生成方法，包括

url('path/to/route')（URL::to()）
secure_url('path/to/route')
route('routename')或route('routename', 'param')或route('routename', ['param1', 'param2'])（URL::route()）
action('controller@action')（URL::action()）
或者直接传递一个字符串URL（'http://www.example.com/'）

此示例将渲染如下

{{ Breadcrumbs::render('home') }}

并产生以下输出

首页

父级链接

这是一个带有父级链接的另一个静态页面

Breadcrumbs::for('blog', function ($trail) {
    $trail->parent('home');
    $trail->push('Blog', route('blog'));
});

这是通过调用上面定义的home面包屑的闭包来实现的。

它将渲染如下

{{ Breadcrumbs::render('blog') }}

并产生以下输出

首页 / 博客

注意，默认模板不会为最后一个面包屑（当前页面的面包屑）创建链接，即使指定了URL。您可以通过创建自己的模板来覆盖此行为——有关详细信息，请参阅自定义模板。

动态标题和链接

这是一个从数据库动态生成的页面

Breadcrumbs::for('post', function ($trail, $post) {
    $trail->parent('blog');
    $trail->push($post->title, route('post', $post));
});

从视图传递的$post对象（可能是一个Eloquent 模型，但可能是任何其他东西）

{{ Breadcrumbs::render('post', $post) }}

它会产生以下输出

首页 / 博客 / 文章标题

提示：如果需要，可以传递多个参数。

嵌套分类

最后，如果您有嵌套分类或其他特殊要求，您可以多次调用$trail->push()

Breadcrumbs::for('category', function ($trail, $category) {
    $trail->parent('blog');

    foreach ($category->ancestors as $ancestor) {
        $trail->push($ancestor->title, route('category', $ancestor->id));
    }

    $trail->push($category->title, route('category', $category->id));
});

或者，您也可以创建一个递归函数，如下所示

Breadcrumbs::for('category', function ($trail, $category) {
    if ($category->parent) {
        $trail->parent('category', $category->parent);
    } else {
        $trail->parent('blog');
    }

    $trail->push($category->title, route('category', $category->slug));
});

两种方法都会渲染如下

{{ Breadcrumbs::render('category', $category) }}

并产生以下结果

首页 / 博客 / 祖父分类 / 父分类 / 分类标题

自定义模板

创建视图

要自定义HTML，创建自己的视图文件（例如resources/views/partials/breadcrumbs.blade.php），如下所示

@unless ($breadcrumbs->isEmpty())

    <ol class="breadcrumb">
        @foreach ($breadcrumbs as $breadcrumb)

            @if (!is_null($breadcrumb->url) && !$loop->last)
                <li class="breadcrumb-item"><a href="{{ $breadcrumb->url }}">{{ $breadcrumb->title }}</a></li>
            @else
                <li class="breadcrumb-item active">{{ $breadcrumb->title }}</li>
            @endif

        @endforeach
    </ol>

@endunless

（查看resources/views/目录以获取内置模板。）

视图数据

视图将接收一个名为$breadcrumbs的数组。

每个面包屑都是一个对象，具有以下键

title – 面包屑标题
url – 面包屑URL，如果没有提供则返回null
以及$data中的每个项目的附加键（有关详细信息，请参阅自定义数据）

更新配置

然后更新您的配置文件（config/breadcrumbs.php），例如使用自定义视图名称：

    'view' => 'partials.breadcrumbs', #--> resources/views/partials/breadcrumbs.blade.php

跳过视图

或者您可以跳过自定义视图，并直接调用 Breadcrumbs::generate() 来获取面包屑集合

@foreach (Breadcrumbs::generate('post', $post) as $breadcrumb)
    {{-- ... --}}
@endforeach

输出面包屑

在每个页面的视图中调用 Breadcrumbs::render()，并传递要使用的面包屑名称和任何附加参数。

使用 Blade

在页面中（例如 resources/views/home.blade.php）

{{ Breadcrumbs::render('home') }}

或者使用参数

{{ Breadcrumbs::render('category', $category) }}

使用 Blade 布局和 @section

在页面中（例如 resources/views/home.blade.php）

@extends('layout.name')

@section('breadcrumbs')
    {{ Breadcrumbs::render('home') }}
@endsection

或者使用简写语法

@extends('layout.name')

@section('breadcrumbs', Breadcrumbs::render('home'))

在布局中（例如 resources/views/layout/name.blade.php）

@yield('breadcrumbs')

纯 PHP（不使用 Blade）

在页面中（例如 resources/views/home.php）

<?= Breadcrumbs::render('home') ?>

如果喜欢，可以使用长格式语法

<?php echo Breadcrumbs::render('home') ?>

结构化数据

要将面包屑作为 JSON-LD 结构化数据渲染（通常用于 SEO 原因），使用 Breadcrumbs::view() 来渲染 breadcrumbs::json-ld 模板以及正常的模板。例如

<html>
    <head>
        ...
        {{ Breadcrumbs::view('breadcrumbs::json-ld', 'category', $category) }}
        ...
    </head>
    <body>
        ...
        {{ Breadcrumbs::render('category', $category) }}
        ...
    </body>
</html>

（注意：如果您使用 Laravel Page Speed，您可能需要禁用 TrimUrls 中间件。）

要指定一个图片，将其添加到 push() 中的 $data 参数

Breadcrumbs::for('post', function ($trail, $post) {
    $trail->parent('home');
    $trail->push($post->title, route('post', $post), ['image' => asset($post->image)]);
});

（如果您更喜欢使用 Microdata 或 RDFa，您将需要创建一个自定义模板。）

路由绑定面包屑

在正常使用中，您必须在每个页面上调用 Breadcrumbs::render($name, $params...) 来渲染面包屑。如果您愿意，可以将您的面包屑命名为与您的路由相同的名称，以避免重复。

命名您的路由

确保您的每个路由都有一个名称。例如（routes/web.php）

// Home
Route::name('home')->get('/', 'HomeController@index');

// Home > [Post]
Route::name('post')->get('/post/{id}', 'PostController@show');

有关更多详细信息，请参阅 Laravel 文档中的命名路由。

将面包屑命名为匹配

对于每个路由，创建一个具有相同名称和参数的面包屑。例如（routes/breadcrumbs.php）

// Home
Breadcrumbs::for('home', function ($trail) {
     $trail->push('Home', route('home'));
});

// Home > [Post]
Breadcrumbs::for('post', function ($trail, $id) {
    $post = Post::findOrFail($id);
    $trail->parent('home');
    $trail->push($post->title, route('post', $post));
});

要将面包屑添加到自定义 404 未找到页面，请使用名称 errors.404

// Error 404
Breadcrumbs::for('errors.404', function ($trail) {
    $trail->parent('home');
    $trail->push('Page Not Found');
});

在布局中输出面包屑

在布局文件（例如 resources/views/app.blade.php）中调用 Breadcrumbs::render() 无参数

{{ Breadcrumbs::render() }}

这将自动输出与当前路由对应的面包屑。同样适用于 Breadcrumbs::generate() 和 Breadcrumbs::view()

$breadcrumbs = Breadcrumbs::generate();

和 Breadcrumbs::view()

{{ Breadcrumbs::view('breadcrumbs::json-ld') }}

路由绑定异常

如果面包屑不存在，将抛出 InvalidBreadcrumbException 异常，以提醒您创建一个。如果您想禁用此功能（例如，如果您有一些没有面包屑的页面），首先初始化配置文件，如果您还没有做的话

php artisan vendor:publish --tag=breadcrumbs-config

然后打开 config/breadcrumbs.php 并设置此值

    'missing-route-bound-breadcrumb-exception' => false,

同样，为了避免抛出 UnnamedRouteException 异常（如果当前路由没有名称），设置此值

    'unnamed-route-exception' => false,

路由模型绑定

Laravel Breadcrumbs 使用与控制器相同的模型绑定。例如

// routes/web.php
Route::name('post')->get('/post/{post}', 'PostController@show');

// app/Http/Controllers/PostController.php
use App\Post;

class PostController extends Controller
{
    public function show(Post $post) // <-- Implicit model binding happens here
    {
        return view('post/show', ['post' => $post]);
    }
}

// routes/breadcrumbs.php
Breadcrumbs::for('post', function ($trail, $post) { // <-- The same Post model is injected here
    $trail->parent('home');
    $trail->push($post->title, route('post', $post));
});

这通过只从数据库中加载一次文章来使您的代码更简洁、更高效。

有关更多详细信息，请参阅 Laravel 文档中的路由模型绑定。

资源控制器

Laravel 自动为资源控制器创建路由名称，例如 photo.index，您可以在定义面包屑时使用这些名称。例如

// routes/web.php
Route::resource('photo', PhotoController::class);

$ php artisan route:list
+--------+----------+--------------------+---------------+-------------------------+------------+
| Domain | Method   | URI                | Name          | Action                  | Middleware |
+--------+----------+--------------------+---------------+-------------------------+------------+
|        | GET|HEAD | photo              | photo.index   | PhotoController@index   |            |
|        | GET|HEAD | photo/create       | photo.create  | PhotoController@create  |            |
|        | POST     | photo              | photo.store   | PhotoController@store   |            |
|        | GET|HEAD | photo/{photo}      | photo.show    | PhotoController@show    |            |
|        | GET|HEAD | photo/{photo}/edit | photo.edit    | PhotoController@edit    |            |
|        | PUT      | photo/{photo}      | photo.update  | PhotoController@update  |            |
|        | PATCH    | photo/{photo}      |               | PhotoController@update  |            |
|        | DELETE   | photo/{photo}      | photo.destroy | PhotoController@destroy |            |
+--------+----------+--------------------+---------------+-------------------------+------------+

// routes/breadcrumbs.php

// Photos
Breadcrumbs::for('photo.index', function ($trail) {
    $trail->parent('home');
    $trail->push('Photos', route('photo.index'));
});

// Photos > Upload Photo
Breadcrumbs::for('photo.create', function ($trail) {
    $trail->parent('photo.index');
    $trail->push('Upload Photo', route('photo.create'));
});

// Photos > [Photo Name]
Breadcrumbs::for('photo.show', function ($trail, $photo) {
    $trail->parent('photo.index');
    $trail->push($photo->title, route('photo.show', $photo->id));
});

// Photos > [Photo Name] > Edit Photo
Breadcrumbs::for('photo.edit', function ($trail, $photo) {
    $trail->parent('photo.show', $photo);
    $trail->push('Edit Photo', route('photo.edit', $photo->id));
});

有关更多详细信息，请参阅 Laravel 文档中的资源控制器。

（相关常见问题解答：为什么没有 Breadcrumbs::resource() 方法？。）

高级使用

无URL的面包屑

push()方法的第二个参数是可选的，因此如果您想创建一个没有URL的面包屑，可以这样操作

$trail->push('Sample');

$breadcrumb->url的值将是null。

默认的Bootstrap模板将其渲染为CSS类“active”，与最后一个面包屑相同，因为否则默认为黑色文本而不是灰色，这看起来不太对。

自定义数据

push()方法接受一个可选的第三个参数，$data - 一个要传递给面包屑的任意数据数组，您可以在自定义模板中使用它。例如，如果您想为每个面包屑添加一个图标，您可以这样做

$trail->push('Home', '/', ['icon' => 'home.png']);

$data数组中的条目将被合并到面包屑中作为属性，因此您可以在模板中以$breadcrumb->icon的方式访问图标，如下所示

<li><a href="{{ $breadcrumb->url }}">
    <img src="/images/icons/{{ $breadcrumb->icon }}">
    {{ $breadcrumb->title }}
</a></li>

不要使用title或url键，因为它们将被覆盖。

“之前”和“之后”回调

您可以为在路径的开始/结束添加面包屑注册“之前”和“之后”回调。例如，自动在末尾添加当前页码

Breadcrumbs::after(function ($trail) {
    $page = (int) request('page', 1);
    if ($page > 1) {
        $trail->push("Page $page");
    }
});

获取当前页面面包屑

要获取当前页面的最后一个面包屑，请使用Breadcrumb::current()。例如，您可以使用此方法输出当前页标题

<title>{{ ($breadcrumb = Breadcrumbs::current()) ? $breadcrumb->title : 'Fallback Title' }}</title>

要忽略一个面包屑，请将'current' => false添加到push()中的$data参数中。这可以用来忽略分页面包屑

Breadcrumbs::after(function ($trail) {
    $page = (int) request('page', 1);
    if ($page > 1) {
        $trail->push("Page $page", null, ['current' => false]);
    }
});

<title>
    {{ ($breadcrumb = Breadcrumbs::current()) ? "$breadcrumb->title –" : '' }}
    {{ ($page = (int) request('page')) > 1 ? "Page $page –" : '' }}
    Demo App
</title>

对于更高级的过滤，请使用Breadcrumbs::generate()和Laravel的集合类方法

$current = Breadcrumbs::generate()->where('current', '!==', 'false)->last();

运行时切换视图

您可以使用Breadcrumbs::view()代替Breadcrumbs::render()来渲染除了默认视图之外的模板

{{ Breadcrumbs::view('partials.breadcrumbs2', 'category', $category) }}

或者您可以通过覆盖配置设置来影响所有未来的render()调用

Config::set('breadcrumbs.view', 'partials.breadcrumbs2');

{{ Breadcrumbs::render('category', $category) }}

或者您可以通过调用Breadcrumbs::generate()来获取面包屑集合并手动加载视图

@include('partials.breadcrumbs2', ['breadcrumbs' => Breadcrumbs::generate('category', $category)])

覆盖“当前”路由

如果您不带参数调用Breadcrumbs::render()或Breadcrumbs::generate()，它将默认使用当前路由名称和参数（由Laravel的Route::current()方法返回）。

您可以通过调用Breadcrumbs::setCurrentRoute($name, $param1, $param2...)来覆盖此设置。

检查面包屑是否存在

要检查具有给定名称的面包屑是否存在，请调用Breadcrumbs::exists('name')，它返回一个布尔值。

在不同的文件中定义面包屑

如果您不想使用routes/breadcrumbs.php，您可以在配置文件中更改它。首先初始化配置文件，如果您还没有的话

php artisan vendor:publish --tag=breadcrumbs-config

然后打开config/breadcrumbs.php并编辑此行

    'files' => base_path('routes/breadcrumbs.php'),

它可以是上述绝对路径，也可以是一个数组

    'files' => [
        base_path('breadcrumbs/admin.php'),
        base_path('breadcrumbs/frontend.php'),
    ],

因此您可以使用glob()自动使用通配符查找文件

    'files' => glob(base_path('breadcrumbs/*.php')),

或者返回一个空数组[]来禁用加载。

在其他包中定义/使用面包屑

如果您正在创建自己的包，只需从您的服务提供者的boot()方法中加载您的面包屑文件即可

use Illuminate\Support\ServiceProvider;

class MyServiceProvider extends ServiceProvider
{
    public function register() {}

    public function boot()
    {
        if (class_exists('Breadcrumbs')) {
            require __DIR__ . '/breadcrumbs.php';
        }
    }
}

依赖注入

您可以使用依赖注入来访问Manager实例，如果您愿意，而不是使用Breadcrumbs::外观

use Diglactic\Breadcrumbs\Manager;
use Illuminate\Support\ServiceProvider;

class MyServiceProvider extends ServiceProvider
{
    public function register() {}

    public function boot(Manager $breadcrumbs)
    {
        $breadcrumbs->register(...);
    }
}

宏

面包屑Manager类是可宏的，因此您可以添加自己的方法。例如

Breadcrumbs::macro('pageTitle', function () {
    $title = ($breadcrumb = Breadcrumbs::current()) ? "{$breadcrumb->title} – " : '';

    if (($page = (int) request('page')) > 1) {
        $title .= "Page $page – ";
    }

    return $title . 'Demo App';
});

<title>{{ Breadcrumbs::pageTitle() }}</title>

高级自定义

对于更高级的自定义，您可以子类化Breadcrumbs\Manager和/或Breadcrumbs\Generator，然后更新配置文件以包含新类的名称

    // Manager
    'manager-class' => Diglactic\Breadcrumbs\Manager::class,

    // Generator
    'generator-class' => Diglactic\Breadcrumbs\Generator::class,

(注意：每个版本之间可能会有所变化。编写单元测试以确保升级时不会出错总是一个好主意。）

常见问题解答

为什么没有 `Breadcrumbs::resource()` 方法呢？

有几个人建议添加 Breadcrumbs::resource() 来匹配 Route::resource()，但没有人提出一个既灵活又能处理翻译、嵌套资源等，又不会过于复杂的良好实现。

您可以使用 Breadcrumbs::macro() 创建自己的。这是一个不错的起点

Breadcrumbs::macro('resource', function ($name, $title) {
    // Home > Blog
    Breadcrumbs::for("$name.index", function ($trail) use ($name, $title) {
        $trail->parent('home');
        $trail->push($title, route("$name.index"));
    });

    // Home > Blog > New
    Breadcrumbs::for("$name.create", function ($trail) use ($name) {
        $trail->parent("$name.index");
        $trail->push('New', route("$name.create"));
    });

    // Home > Blog > Post 123
    Breadcrumbs::for("$name.show", function ($trail, $model) use ($name) {
        $trail->parent("$name.index");
        $trail->push($model->title, route("$name.show", $model));
    });

    // Home > Blog > Post 123 > Edit
    Breadcrumbs::for("$name.edit", function ($trail, $model) use ($name) {
        $trail->parent("$name.show", $model);
        $trail->push('Edit', route("$name.edit", $model));
    });
});

Breadcrumbs::resource('blog', 'Blog');
Breadcrumbs::resource('photos', 'Photos');
Breadcrumbs::resource('users', 'Users');

请注意，这不包括翻译或嵌套资源，并假设所有模型都有 title 属性（用户可能没有）。根据您的需要对其进行修改。

故障排除

一般

重新阅读说明，确保您已经正确执行了所有操作。
从简单的选项开始，只有当您了解其工作原理后，才使用高级选项（例如路由绑定面包屑）。

未找到类 'Breadcrumbs'

尝试运行 composer update diglactic/laravel-breadcrumbs 进行升级。
尝试运行 php artisan package:discover 以确保服务提供程序被Laravel检测到。

找不到名称为 ... 的面包屑

请确保您在正确的位置注册了面包屑（默认为 routes/breadcrumbs.php）。
- 尝试在文件中放置 dd(__FILE__) 以确保它已加载。
- 尝试在 ServiceProvider::registerBreadcrumbs() 中放置 dd($files) 以检查路径是否正确。
- 如果不正确，请尝试运行 php artisan config:clear（或手动删除 bootstrap/cache/config.php）或在 config/breadcrumbs.php 中更新路径。
确保面包屑名称正确。
- 如果使用路由绑定面包屑，请确保它与路由名称完全匹配。
要在使用路由绑定面包屑时抑制这些错误（如果您不希望在某些页面上有面包屑），请
- 使用空闭包（没有push/parent调用）进行注册，或
- 在配置文件中将 missing-route-bound-breadcrumb-exception 设置为 false 以禁用检查（但您不会收到任何页面的警告）。

ServiceProvider::registerBreadcrumbs(): 无法打开所需...

请确保路径正确。
如果是这样，请检查文件所有权和权限是否正确。
如果不正确，请尝试运行 php artisan config:clear（或手动删除 bootstrap/cache/config.php）或在 config/breadcrumbs.php 中更新路径。

未定义变量：breadcumbs

请确保您使用 {{ Breadcrumbs::render() }} 或 {{ Breadcrumbs::view() }}，而不是 @include()。

贡献

文档：如果您认为文档可以在任何方面得到改进，请编辑此文件并提交拉取请求。

错误修复：请修复它并提交一个拉取请求。 (见下文以获取更详细的说明。) 如果您添加了一个单元测试以确保它不再发生，则可以获得加分！

新功能：只有具有明确用例和经过良好考虑的API的功能才会被接受。它们必须被记录，并包含单元测试。如有疑问，请制作一个原型（可以是代码或文档）并提交一个拉取请求以讨论细节。（提示：如果您想添加一个过于具体而无法默认包含的功能，请参阅宏或高级定制以获取添加方法。）

创建一个拉取请求

在Laravel面包屑上工作的最简单方法是告诉Composer使用--prefer-source标志从源（Git）安装它

rm -rf vendor/diglactic/laravel-breadcrumbs
composer install --prefer-source

然后检出master分支并创建一个本地分支以进行工作

cd vendor/diglactic/laravel-breadcrumbs
git checkout -t origin/master
git checkout -b YOUR_BRANCH

现在进行您的更改，包括单元测试和文档（如果适用）。运行单元测试以确保一切仍然正常工作

vendor/bin/phpunit

然后提交更改。如果您还没有，请先在GitHub上Fork仓库，并将您的更改推送到它

git remote add YOUR_USERNAME git@github.com:YOUR_USERNAME/laravel-breadcrumbs.git
git push -u YOUR_USERNAME YOUR_BRANCH

最后，浏览到GitHub上的仓库并创建一个pull request。

在项目中使用您的Fork

要使用您自己的Fork在项目中，按照以下方式更新您主项目的composer.json

{
    // ADD THIS:
    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/YOUR_USERNAME/laravel-breadcrumbs.git"
        }
    ],
    "require": {
        // UPDATE THIS:
        "diglactic/laravel-breadcrumbs": "dev-YOUR_BRANCH"
    }
}

将YOUR_USERNAME替换为您的GitHub用户名，将YOUR_BRANCH替换为分支名称（例如develop）。这告诉Composer使用您的仓库而不是默认仓库。

单元测试

要运行单元测试

vendor/bin/phpunit

要运行单元测试并重建快照

vendor/bin/phpunit -d --update-snapshots

要检查代码覆盖率

vendor/bin/phpunit --coverage-html test-coverage

然后打开test-coverage/index.html以查看结果。注意PHPUnit中可能导致结果不够精确的边缘情况。

Laravel的新版本

以下文件需要更新，以便针对新的Laravel版本运行测试

composer.json
- laravel/framework（Laravel版本）
- php（最小PHP版本）
tests.yml
- jobs.phpunit.strategy.matrix.laravel（Laravel版本）
- jobs.phpunit.strategy.matrix.php（PHP版本）
- jobs.phpunit.strategy.matrix.exclude（不支持的组合）

如果需要，也更新

README.md
- 兼容性图表

许可协议

Laravel Breadcrumbs是开源软件，许可协议为MIT。

webikevn / breadcrumbs

维护者

详细信息