资讯专栏INFORMATION COLUMN

Laravel Excel 的五个隐藏功能

tinna / 492人阅读

摘要:文档示例注意你必须通过安装指定的包,比如导出的如下所示按需格式化单元格有一个强有力的爸爸。因此它就拥有其各种底层功能,包括各种方式的单元格格式化。

Laravel Excel package 最近发布了 3.0 版本,它所具有的新功能,可以帮助简化高级需求,并且可用性极高。大家一起来探讨一下可能不知道的一些隐藏功能,这些功能使 Laravel Excel 成为 Excel 拓展的最佳首选。

1. 从 HTML 或者是 Blade 导入数据

假设已经有一个 HTML 表格

模版代码 -- resources/views/customers/table.blade.php:


    @foreach ($customers as $customer)
    
    @endforeach
    
First name Last name Email Created at Updated at
{{ $customer->id }} {{ $customer->first_name }} {{ $customer->last_name }} {{ $customer->email }} {{ $customer->created_at }} {{ $customer->updated_at }}

你可以使用它去重复导入这个表格到 Excel

步骤1. 生成一个 Export 类

php artisan make:export CustomersFromView --model=Customer

步骤2. 使用 FromView 进行操作

namespace AppExports;

use AppCustomer;
use IlluminateContractsViewView;
use MaatwebsiteExcelConcernsFromView;

class CustomersExportView implements FromView
{
    public function view(): View
    {
        return view("customers.table", [
            "customers" => Customer::orderBy("id", "desc")->take(100)->get()
        ]);
    }
}

这里是导入的 Excel 文件:

注意:这里只能导出 HTML 表格,不能具有任何标签,比如 html,body,div 等。

*

2. 导出到 PDF,HTML,或是其他格式的文件

虽然包的名称是 Laravel Excel,但是提供了多种导出格式,并且使用起来十分简单,只要在类里再添加一个参数即可:

return Excel::download(new CustomersExport(), "customers.xlsx", "Html");

比如这么做,就导出到了HTML,如下图所示:

没有太多的样式,下面是源代码:

不仅如此,它还可以导出到 PDF,甚至你可以从中选择三种库,使用方法是一样的,你只要在最后一个参数指定格式就好了,下面是一些例子。 文档示例:

注意:你必须通过 composer 安装指定的 PDF 包,比如:

composer require dompdf/dompdf

导出的 PDF 如下所示:

*

3. 按需格式化单元格

Laravel Excel 有一个强有力的「爸爸」 -- PhpSpreadsheet。因此它就拥有其各种底层功能,包括各种方式的单元格格式化。

此处是一个如何在 Laravel Export 类中使用它的例子,例如 app/Exports/CustomersExportStyling.php:

步骤 1. 在头部引入适当的类。

use MaatwebsiteExcelConcernsWithEvents;
use MaatwebsiteExcelEventsAfterSheet;

步骤 2. 在 implements 部分使用 WithEvents 接口。

class CustomersExportStyling implements FromCollection, WithEvents
{
    // ...

步骤 3. 用 AfterSheet 事件来创建 registerEvents() 方法。

/**
 * @return array
 */
public function registerEvents(): array
{
    return [
        AfterSheet::class    => function(AfterSheet $event) {
            // ... 此处你可以任意格式化
        },
    ];
}

这里有个例子:

/**
 * @return array
 */
public function registerEvents(): array
{
    return [
        AfterSheet::class    => function(AfterSheet $event) {
            // 所有表头-设置字体为14
            $cellRange = "A1:W1";
            $event->sheet->getDelegate()->getStyle($cellRange)->getFont()->setSize(14);

            // 将样式数组应用于B2:G8范围单元格
            $styleArray = [
                "borders" => [
                    "outline" => [
                        "borderStyle" => PhpOfficePhpSpreadsheetStyleBorder::BORDER_THICK,
                        "color" => ["argb" => "FFFF0000"],
                    ]
                ]
            ];
            $event->sheet->getDelegate()->getStyle("B2:G8")->applyFromArray($styleArray);

            // 将第一行行高设置为20
            $event->sheet->getDelegate()->getRowDimension(1)->setRowHeight(20);

            // 设置 A1:D4 范围内文本自动换行
            $event->sheet->getDelegate()->getStyle("A1:D4")
                ->getAlignment()->setWrapText(true);
        },
    ];
}

这些「随机」样例展示的结果如下所示:

你可以在 Recipes page of PhpSpreadsheet docs中找到所有的以上以及更多示例。

*

4. 隐藏模型属性

假设我们已经创建了Laravel 5.7默认的users表:

现在我们尝试用简单的FromCollection来导出用户表数据:

class UsersExport implements FromCollection
{
    public function collection()
    {
        return User::all();
    }
}

在导出的Excel 里,你只能看到如下字段,但是没有passwordremember_token

这是因为在User模型里定义了隐藏字段的属性:

class User extends Authenticatable
{
    // ...

    /**
     * 这个数组用来定义需要隐藏的字段。
     *
     * @var array
     */
    protected $hidden = [
        "password", "remember_token",
    ];
}

所以,默认情况下这些字段是隐藏的,如果你想在导出数据的时候某些字段不被导出的话,可以直接在模型中定义隐藏属性$hidden

*

5. 公式

出于某种原因,Laravel Excel 包的官方文档中并没有提及公式,但是这是Excel 重要的功能!

幸运的是,我们可以直接将公式写在导出数据的类中,我们需要设置cell 的值,就像这样:=A2+1 or SUM(A1:A10)

其中一种方式就是实现WithMapping 接口:

use AppCustomer;
use MaatwebsiteExcelConcernsFromCollection;
use MaatwebsiteExcelConcernsWithMapping;

class CustomersExportFormulas implements FromCollection, WithMapping
{
    public function collection()
    {
        return Customer::all();
    }

    /**
     * @var Customer $customer
     * @return array
     */
    public function map($customer): array
    {
        return [
            $customer->id,
            "=A2+1",
            $customer->first_name,
            $customer->last_name,
            $customer->email,
        ];
    }
}

以上就是Laravel Excel的五个鲜为人知的功能。

文章转自: https://learnku.com/laravel/t... 

更多文章:https://learnku.com/laravel/c...

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/30932.html

相关文章

  • Laravel 5 中使用 Laravel Excel 实现 Excel/CSV 文件导入导出功

    摘要:本文非原创,基于学院在中使用实现文件导入导出功能这篇文章在实际中测试调整。简介在中集成套件中的,从而方便我们以优雅的富有表现力的代码实现文件的导入和导出。 本文非原创,基于laravel 学院《在 Laravel 5 中使用 Laravel Excel 实现 Excel/CSV 文件导入导出功能》 这篇文章在实际中测试调整。 showImg(https://segmentfault.c...

    XFLY 评论0 收藏0
  • 如何在 Laravel 项目中处理 Excel 文件

    摘要:本文经授权转自社区说明是一款强大的文件处理扩展包能够快速完成文件的的导出解析等功能本项目由团队成员整理发布首发地为社区文章的项目截图运行代码请见请参照此文档运行文章概览安装基础用法更多功能接下来是详细解说安装使用安装该扩展包安装完成后, 本文经授权转自 PHPHub 社区 说明 maatwebsite/excel 是一款强大的 Excel 文件处理扩展包, 能够快速完成 Excel 文...

    chadLi 评论0 收藏0
  • 学习Vue.js五个小例子

    摘要:前言最近在学习,学着写了几个小例子,自己记录一下,例子都比较简单,希望给初学的小伙伴一些参考。后记文章可能比较简单,只是分享了几个小例子,没有对的用法进行详细说明,大家可以看官方文档。参考资料中文文档五个小案例带你学习火热的 前言 最近在学习vue.js,学着写了几个小例子,自己记录一下,例子都比较简单,希望给初学vue.js的小伙伴一些参考。 双向数据绑定 点击查看 数据绑定是vue...

    array_huang 评论0 收藏0
  • LaravelExcel导入、导出

    摘要:介绍是经常会使用的,里有非常好的组件,能够实现文件的导入和导出。 1.介绍 Excel是经常会使用的,Laravel里有非常好的Excel组件,能够实现Excel/CSV文件的导入和导出 。 组件项目地址: composer: https://packagist.org/packages/maatwebsite/excel。 GitHub: https://github.com/M...

    nodejh 评论0 收藏0

发表评论

0条评论

最新活动
阅读需要支付1元查看
<