国产+欧美+激情,国产99久久久国产精品～～牛

PHP Fractal是一種解決方案，允許開發(fā)人員在將模型作為響應(yīng)返回之前為其模型創(chuàng)建新的轉(zhuǎn)換層，從而使JSON數(shù)據(jù)更易于管理和保持一致性。
Fractal靈活且易于集成到任何應(yīng)用程序或框架中。它的工作原理是使用Transformer將復(fù)雜的數(shù)據(jù)結(jié)構(gòu)轉(zhuǎn)換為更簡單的格式，并使用Serializer來格式化最終輸出。
Fractal還允許在用戶請求時包含子資源（關(guān)系）到響應(yīng)中，從而為數(shù)據(jù)呈現(xiàn)增加了另一層靈活性和控制。
使用Fractal可以通過一次性急切加載關(guān)系來優(yōu)化查詢性能，從而解決了Eloquent延遲加載經(jīng)常遇到的n 1問題。

安裝

我們將使用Laravel 5.3應(yīng)用程序來構(gòu)建示例并將Fractal包與其集成，因此請繼續(xù)使用安裝程序或通過Composer創(chuàng)建一個新的Laravel應(yīng)用程序。

<code>laravel new demo</code>

或

<code>composer create-project laravel/laravel demo</code>

然后，在文件夾內(nèi)，我們需要Fractal包。

<code>composer require league/fractal</code>

創(chuàng)建數(shù)據(jù)庫

我們的數(shù)據(jù)庫包含users和roles表。每個用戶都有一個角色，每個角色都有一個權(quán)限列表。

// app/User.php

class User extends Authenticatable
{
    protected $fillable = [
        'name',
        'email',
        'password',
        'role_id',
    ];

    protected $hidden = [
        'password', 'remember_token',
    ];

    /**
     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo
     */
    public function role()
    {
        return $this->belongsTo(Role::class);
    }
}

// app/Role.php

class Role extends Model
{
    protected $fillable = [
        'name',
        'slug',
        'permissions'
    ];

    /**
     * @return \Illuminate\Database\Eloquent\Relations\HasMany
     */
    public function users()
    {
        return $this->hasMany(User::class);
    }
}

創(chuàng)建Transformer

我們將為每個模型創(chuàng)建一個Transformer。我們的UserTransformer類如下所示：

// app/Transformers/UserTransformer.php

namespace App\Transformers;

use App\User;
use League\Fractal\TransformerAbstract;

class UserTransformer extends TransformerAbstract
{
    public function transform(User $user)
    {
        return [
            'name' => $user->name,
            'email' => $user->email
        ];
    }
}

是的，創(chuàng)建Transformer就這么簡單！它只是以開發(fā)人員可以管理的方式轉(zhuǎn)換數(shù)據(jù)，而不是留給ORM或存儲庫。

我們擴展TransformerAbstract類并定義transform方法，該方法將使用User實例調(diào)用。RoleTransformer類也是如此。

namespace App\Transformers;

use App\Role;
use League\Fractal\TransformerAbstract;

class RoleTransformer extends TransformerAbstract
{
    public function transform(Role $role)
    {
        return [
            'name' => $role->name,
            'slug' => $role->slug,
            'permissions' => $role->permissions
        ];
    }
}

創(chuàng)建控制器

我們的控制器應(yīng)該在將數(shù)據(jù)發(fā)送回用戶之前轉(zhuǎn)換數(shù)據(jù)。我們現(xiàn)在將處理UsersController類，暫時只定義index和show操作。

// app/Http/Controllers/UsersController.php

class UsersController extends Controller
{
    /**
     * @var Manager
     */
    private $fractal;

    /**
     * @var UserTransformer
     */
    private $userTransformer;

    function __construct(Manager $fractal, UserTransformer $userTransformer)
    {
        $this->fractal = $fractal;
        $this->userTransformer = $userTransformer;
    }

    public function index(Request $request)
    {
        $users = User::all(); // 從數(shù)據(jù)庫獲取用戶
        $users = new Collection($users, $this->userTransformer); // 創(chuàng)建資源集合轉(zhuǎn)換器
        $users = $this->fractal->createData($users); // 轉(zhuǎn)換數(shù)據(jù)

        return $users->toArray(); // 獲取轉(zhuǎn)換后的數(shù)據(jù)數(shù)組
    }
}

index操作將從數(shù)據(jù)庫查詢所有用戶，使用用戶列表和轉(zhuǎn)換器創(chuàng)建一個資源集合，然后執(zhí)行實際的轉(zhuǎn)換過程。

{
  "data": [
    {
      "name": "Nyasia Keeling",
      "email": "crooks.maurice@example.net"
    },
    {
      "name": "Laron Olson",
      "email": "helen55@example.com"
    },
    {
      "name": "Prof. Fanny Dach III",
      "email": "edgardo13@example.net"
    },
    {
      "name": "Athena Olson Sr.",
      "email": "halvorson.jules@example.com"
    }
    // ...
  ]
}

當(dāng)然，一次返回所有用戶是沒有意義的，我們應(yīng)該為此實現(xiàn)分頁器。

分頁

Laravel傾向于簡化事情。我們可以像這樣實現(xiàn)分頁：

<code>laravel new demo</code>

但是為了使這與Fractal一起工作，我們可能需要添加一些代碼來轉(zhuǎn)換數(shù)據(jù)，然后再調(diào)用分頁器。

<code>composer create-project laravel/laravel demo</code>

第一步是從模型分頁數(shù)據(jù)。接下來，我們像以前一樣創(chuàng)建一個資源集合，然后在集合上設(shè)置分頁器。

Fractal為Laravel提供了一個分頁器適配器來轉(zhuǎn)換LengthAwarePaginator類，它還為Symfony和Zend提供了一個適配器。

<code>composer require league/fractal</code>

請注意，它為分頁詳細信息添加了額外的字段。您可以在文檔中閱讀更多關(guān)于分頁的信息。

包含子資源

現(xiàn)在我們已經(jīng)熟悉了Fractal，是時候?qū)W習(xí)如何在用戶請求時包含子資源（關(guān)系）到響應(yīng)中了。

我們可以請求包含額外資源到響應(yīng)中，例如http://demo.vaprobash.dev/users?include=role。我們的轉(zhuǎn)換器可以自動檢測正在請求的內(nèi)容并解析include參數(shù)。

// app/User.php

class User extends Authenticatable
{
    protected $fillable = [
        'name',
        'email',
        'password',
        'role_id',
    ];

    protected $hidden = [
        'password', 'remember_token',
    ];

    /**
     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo
     */
    public function role()
    {
        return $this->belongsTo(Role::class);
    }
}

$availableIncludes屬性告訴轉(zhuǎn)換器我們可能需要包含一些額外的數(shù)據(jù)到響應(yīng)中。如果include查詢參數(shù)請求用戶角色，它將調(diào)用includeRole方法。

// app/Role.php

class Role extends Model
{
    protected $fillable = [
        'name',
        'slug',
        'permissions'
    ];

    /**
     * @return \Illuminate\Database\Eloquent\Relations\HasMany
     */
    public function users()
    {
        return $this->hasMany(User::class);
    }
}

$this->fractal->parseIncludes行負責(zé)解析include查詢參數(shù)。如果我們請求用戶列表，我們應(yīng)該看到類似這樣的內(nèi)容：

// app/Transformers/UserTransformer.php

namespace App\Transformers;

use App\User;
use League\Fractal\TransformerAbstract;

class UserTransformer extends TransformerAbstract
{
    public function transform(User $user)
    {
        return [
            'name' => $user->name,
            'email' => $user->email
        ];
    }
}

如果每個用戶都有一個角色列表，我們可以將轉(zhuǎn)換器更改為如下所示：

namespace App\Transformers;

use App\Role;
use League\Fractal\TransformerAbstract;

class RoleTransformer extends TransformerAbstract
{
    public function transform(Role $role)
    {
        return [
            'name' => $role->name,
            'slug' => $role->slug,
            'permissions' => $role->permissions
        ];
    }
}

包含子資源時，我們可以使用點表示法來嵌套關(guān)系。假設(shè)每個角色都有一個存儲在單獨表中的權(quán)限列表，并且我們想列出具有其角色和權(quán)限的用戶。我們可以這樣做include=role.permissions。

有時，我們需要默認包含一些必要的關(guān)聯(lián)，例如地址關(guān)聯(lián)。我們可以通過在轉(zhuǎn)換器中使用$defaultIncludes屬性來實現(xiàn)。

// app/Http/Controllers/UsersController.php

class UsersController extends Controller
{
    /**
     * @var Manager
     */
    private $fractal;

    /**
     * @var UserTransformer
     */
    private $userTransformer;

    function __construct(Manager $fractal, UserTransformer $userTransformer)
    {
        $this->fractal = $fractal;
        $this->userTransformer = $userTransformer;
    }

    public function index(Request $request)
    {
        $users = User::all(); // 從數(shù)據(jù)庫獲取用戶
        $users = new Collection($users, $this->userTransformer); // 創(chuàng)建資源集合轉(zhuǎn)換器
        $users = $this->fractal->createData($users); // 轉(zhuǎn)換數(shù)據(jù)

        return $users->toArray(); // 獲取轉(zhuǎn)換后的數(shù)據(jù)數(shù)組
    }
}

我最喜歡Fractal包的一件事是能夠?qū)?shù)傳遞給include參數(shù)。文檔中的一個很好的例子是按順序排列。我們可以將其應(yīng)用到我們的示例中，如下所示：

{
  "data": [
    {
      "name": "Nyasia Keeling",
      "email": "crooks.maurice@example.net"
    },
    {
      "name": "Laron Olson",
      "email": "helen55@example.com"
    },
    {
      "name": "Prof. Fanny Dach III",
      "email": "edgardo13@example.net"
    },
    {
      "name": "Athena Olson Sr.",
      "email": "halvorson.jules@example.com"
    }
    // ...
  ]
}

這里重要的部分是list($orderCol, $orderBy) = $paramBag->get('order') ?: ['created_at', 'desc'];，這將嘗試從用戶include獲取order參數(shù)，并將其應(yīng)用于查詢構(gòu)建器。

我們現(xiàn)在可以通過傳遞參數(shù)來按順序排列包含的用戶列表(/roles?include=users:order(name|asc))。您可以在文檔中閱讀更多關(guān)于包含資源的信息。

但是，如果用戶沒有任何關(guān)聯(lián)的角色會怎樣？它將停止并出現(xiàn)錯誤，因為它期望的是有效數(shù)據(jù)而不是null。讓我們從響應(yīng)中刪除該關(guān)系，而不是顯示其null值。

<code>laravel new demo</code>

急切加載

因為Eloquent在訪問模型時會延遲加載模型，所以我們可能會遇到n 1問題。這可以通過一次性急切加載關(guān)系來解決，以優(yōu)化查詢。

<code>composer create-project laravel/laravel demo</code>

這樣，在訪問模型關(guān)系時，我們將不會有任何額外的查詢。

結(jié)論

我在閱讀Phil Sturgeon撰寫的《構(gòu)建你不會討厭的API》時偶然發(fā)現(xiàn)了Fractal，這是一本很棒且內(nèi)容豐富的讀物，我強烈推薦。

您在構(gòu)建API時是否使用過轉(zhuǎn)換器？您是否有任何首選的執(zhí)行相同工作的包，或者您只是使用json_encode？請在下面的評論部分告訴我們！

PHP Fractal常見問題解答

什么是PHP Fractal，為什么它很重要？

PHP Fractal是一個強大的工具，有助于為API呈現(xiàn)和轉(zhuǎn)換數(shù)據(jù)。它很重要，因為它提供了一種標準化的方法來輸出復(fù)雜、嵌套的數(shù)據(jù)結(jié)構(gòu)，確保API的數(shù)據(jù)輸出一致、結(jié)構(gòu)良好且易于理解。這使得開發(fā)人員更容易使用您的API，并減少了出錯的可能性。

PHP Fractal是如何工作的？

PHP Fractal的工作原理是獲取復(fù)雜的數(shù)據(jù)結(jié)構(gòu)并將其轉(zhuǎn)換為更易于使用的格式。它通過兩個主要組件來實現(xiàn)：Transformer和Serializer。Transformer負責(zé)將復(fù)雜的數(shù)據(jù)轉(zhuǎn)換為更簡單的格式，而Serializer則格式化最終輸出。

PHP Fractal中的Transformer是什么？

PHP Fractal中的Transformer是定義應(yīng)用程序數(shù)據(jù)應(yīng)如何在API響應(yīng)中輸出的類。它們獲取復(fù)雜的數(shù)據(jù)結(jié)構(gòu)并將它們轉(zhuǎn)換為更簡單、更易于使用的格式。這允許您精確控制API響應(yīng)中包含哪些數(shù)據(jù)以及數(shù)據(jù)的結(jié)構(gòu)。

PHP Fractal中的Serializer是什么？

PHP Fractal中的Serializer負責(zé)格式化API的最終輸出。它們獲取已由Transformer轉(zhuǎn)換的數(shù)據(jù)，并將其格式化為特定的結(jié)構(gòu)。這允許您確保API的輸出一致且易于理解。

我如何在項目中實現(xiàn)PHP Fractal？

在項目中實現(xiàn)PHP Fractal包括通過Composer安裝Fractal庫，為數(shù)據(jù)創(chuàng)建Transformer，然后使用Fractal類使用Transformer轉(zhuǎn)換數(shù)據(jù)。然后，您可以使用Fractal的Serializer之一輸出轉(zhuǎn)換后的數(shù)據(jù)。