一款为开发者打造的Fractal包装库

一款为开发者打造的Fractal包装库

fractalistic A framework agnostic, developer friendly wrapper around Fractal 项目地址: https://gitcode.com/gh_mirrors/fr/fractalistic

Fractalistic是一个强大的工具，旨在简化Laravel框架中数据转换的过程。它基于Fractal，一个用于API数据转换的优秀包，但在保持强大功能的同时，通过更简洁的语法减轻了开发负担。

项目介绍

Fractalistic提供了一种更加简洁的方式来处理Fractal中的数据转换。传统的Fractal使用可能涉及多个类和方法，而这个包则将流程简化为一行代码，使得数据操作更为直观。例如，下面是如何在Fractal中进行数据转换：

$manager = new Manager();
$resource = new Collection($books, new BookTransformer());
$manager->parseIncludes('characters');
$manager->createData($resource)->toArray();

而在使用Fractalistic时，你可以这样实现相同的功能：

Fractal::create()
   ->collection($books)
   ->transformWith(new BookTransformer())
   ->includeCharacters()
   ->toArray();

此外，还有一个极简的快捷方式：

Fractal::create($books, new BookTransformer())->toArray();

技术分析

Fractalistic的核心是其简化版API，它使用create()，collection()，transformWith()，include*()和toArray()等方法，提供了更加流畅的编程体验。它也支持自定义序列化器，通过serializeWith()方法可以轻松切换不同的数据格式输出。对于复杂的嵌套关系，还可以使用limitRecursion()来控制递归深度。

应用场景

这个包非常适合于构建RESTful API，特别是在处理复杂的数据结构，如列表或单个资源的展示时。它可以方便地处理包括、排除字段，以及分页和游标导航，适合各种规模的Web应用和移动应用后端。

项目特点

1. 易用性：通过简单的调用链式API，使得数据转换变得简单。
2. 兼容性：与Fractal完全兼容，可随时利用其所有特性。
3. 灵活性：支持自定义序列化器，适应不同API规范。
4. 高效性：通过限制递归深度，有效防止性能问题。

如果你是Laravel开发者，那么laravel-fractal会是一个更好的选择，因为它专门为Laravel环境定制了一些额外功能。

获取与安装

要使用Fractalistic，只需通过Composer添加依赖：

composer require spatie/fractalistic

然后，按照文档的示例代码，立即开始你的数据转换之旅！

Spatie是一家比利时的web设计公司，他们对开放源码充满热情，并创建了一系列高质量的PHP包。若想了解更多他们的项目，请访问他们的官方网站。

在这个项目中，Spatie呼吁我们一同支持乌克兰。如果你有能力并且愿意，可以通过提供的链接贡献力量。让我们一起以行动传递温暖，为和平助力。

fractalistic A framework agnostic, developer friendly wrapper around Fractal 项目地址: https://gitcode.com/gh_mirrors/fr/fractalistic