Antoine Bonin

Antoine Bonin

Utiliser la classe Fluent pour optimiser ses actions

2 min de lecture

Dans l’écosystème Laravel, la classe Fluent offre une approche élégante pour la manipulation de données, en particulier dans les classes d’action et les processus de validation. Contrairement aux tableaux associatifs traditionnels, Fluent permet une manipulation fluide des données, améliorant ainsi la lisibilité et la maintenabilité du code.

Prenons l’exemple d’une classe d’action chargée de créer un produit. En utilisant Fluent, on peut accéder aux données de manière plus expressive :

namespace App\Actions;
 
use App\Models\Product;
use Illuminate\Support\Fluent;
 
class CreateProduct
{
    public function execute(Fluent $data): Product
    {
        return Product::create([
            'name' => $data->name,
            'description' => $data->description,
            'categories' => $data->array('categories'),
            'status' => $data->enum('status', ProductStatus::class),
            'published_at' => $data->date('published_at'),
        ]);
    }
}

Cette méthode permet d’utiliser des accesseurs intégrés, tels que array(), enum() et date(), pour transformer les données de manière concise. Cela réduit le code répétitif et rend les intentions du développeur plus claires.

Un autre avantage notable de Fluent réside dans la validation conditionnelle. Par exemple, lors de la validation de données de paiement, certaines règles peuvent s’appliquer uniquement en fonction de la méthode de paiement choisie :

use Illuminate\Support\Facades\Validator;
use Illuminate\Support\Fluent;
 
class PaymentValidator
{
    public function validate(array $data)
    {
        $validator = Validator::make($data, [
            'method' => 'required|string',
            'amount' => 'required|numeric|min:1',
        ]);
 
        $validator->sometimes(
            ['account_name', 'routing_number'],
            'required',
            function (Fluent $input) {
                return $input->method === 'bank_transfer';
            }
        );
 
        $validator->sometimes(
            'card_verification',
            'required|size:3',
            function (Fluent $input) {
                return $input->get('method') === 'credit_card' && $input->get('amount') > 500;
            }
        );
 
        return $validator;
    }
}

Dans cet exemple, Fluent permet d’accéder aux données de manière intuitive, facilitant l’application de règles de validation conditionnelles sans alourdir le code.

Cependant, l’utilisation de Fluent présente certaines limitations. Notamment, elle n’offre pas de sécurité de type stricte, ce qui peut entraîner des erreurs difficiles à détecter lors de l’exécution. De plus, l’absence d’autocomplétion dans certains environnements de développement peut rendre le code moins ergonomique.

En conclusion, la classe Fluent de Laravel apporte une flexibilité appréciable pour la manipulation et la validation des données, en particulier dans des contextes complexes. Elle permet d’écrire un code plus lisible et maintenable. Toutefois, il est essentiel de peser ses avantages contre ses limitations, notamment en termes de sécurité de type et d’ergonomie, pour déterminer si son utilisation est appropriée dans un projet donné.

Sources