Fractal: une procédure à pas pratique

Les développeurs d'API sont souvent confrontés au défi des changements de schéma de base de données. Sans une bonne implémentation, la modification du nom de la colonne peut nécessiter une refactorisation de l'ensemble du modèle. Cet article montrera comment utiliser Fractal comme pont entre le modèle et la sortie JSON pour simplifier le processus de développement de l'API.

Points clés:

• Fractal est un projet PHP qui agit comme une couche intermédiaire entre le modèle et la sortie JSON, permettant au schéma de la base de données d'être modifié sans refactoriser l'ensemble du modèle, simplifiant ainsi le développement d'API.
• Fractal fonctionne avec Composer et fait partie de la League of Extraordinary Packages, qui répondent tous aux exigences de l'utilisation de la couverture PHP-FIG et des tests unitaires.
• Les packages fractaux peuvent utiliser SILEX et illuminer / base de données pour configurer des environnements et créer des frameworks. Il nécessite la création d'un fichier composer.json avec les dépendances nécessaires.
• En utilisant Fractal avant la sortie, les modifications de la base de données peuvent être facilement effectuées même lorsque le modèle de données sous-jacent change sans être remarqué par l'utilisateur final, devenant un outil puissant pour maintenir une structure de sortie cohérente.

sac fractal

Fractal est un projet écrit en PHP et appartient à la Ligue des packages extraordinaires. Ces packages répondent à plusieurs exigences, telles que l'utilisation de la couverture PHP-FIG et des tests unitaires. Fractal est principalement développé par Phil Sturgeon et continue de recevoir des améliorations régulières. Il peut également être utilisé avec le compositeur.

Définissez l'environnement

Pour la démonstration, je vais configurer un framework à l'aide de Silex et d'illuminer / base de données (composant ORM de Laravel). Même si vous n'êtes familier avec aucun d'entre eux, cela n'a pas d'importance. Ce que je vais faire est très simple et clair, et je l'expliquerai le plus clairement possible. Si vous avez des zones peu claires, n'hésitez pas à laisser un message. Je vais commencer à configurer le cadre. Veuillez noter que si vous ne souhaitez pas suivre les étapes, vous pouvez télécharger tout le code à la fin de l'article. Maintenant, créez un nouveau dossier à l'intérieur du dossier racine. Nous allons commencer par créer un fichier composer.json qui contient toutes les dépendances dont nous avons besoin. Dans ce cas: Silex et IlluminateDatabase. Créez un fichier composer.json comme ceci:

{
  "require": {
    "silex/silex": "~1.2",
    "illuminate/database": "*"
  }
}

Utilisez composer install pour installer ces packages.

Base de données

Je prendrai une base de données musicale en ligne à titre d'exemple. La base de données fournira des informations sur plusieurs chansons: titre de la chanson, nom d'artiste, site Web de l'artiste, titre de l'album, date de sortie et label de disques. Au début, toutes ces informations seront stockées dans un tableau. Si vous souhaitez l'essayer vous-même, téléchargez le fichier 1.SQL à partir de la base de code de cet article et exécutez-le dans votre base de données.

Code

Pour utiliser Silex avec IlluminateDatabase, nous avons besoin de code. Créez un nouveau fichier nommé index.php dans le dossier de l'application. Ici, nous commencerons Silex, nous connecterons à la base de données et définirons l'itinéraire:

{
  "require": {
    "silex/silex": "~1.2",
    "illuminate/database": "*"
  }
}

La première ligne consiste à introduire le fichier de chargement automatique du compositeur. Ensuite, nous créons une nouvelle application SILEX et chargez une base de données illuminate. Ensuite, nous créons un contrôleur pour /tracks afin que toutes les URL commençant par /tracks soient traitées par les contrôleurs / pistes.php. Le fichier Database.php ressemble à ceci, n'oubliez pas de modifier les paramètres de connexion:

<?php
require("../vendor/autoload.php");

$app = new Silex\Application();

$app['database'] = require("database.php");

$app->mount('/tracks', include 'controllers/tracks.php');

$app->run();

Tout d'abord, nous utilisons le générateur de requête IlluminateDatabase pour obtenir une liste d'identifices, de noms et d'artistes, puis les étions en train de les sortir. La sortie aura le format suivant:

<?php
use Illuminate\Database\Capsule\Manager as Capsule;

$capsule = new Capsule;

$capsule->addConnection([
    'driver' => 'mysql',
    'host' => 'localhost',
    'database' => 'musicstore',
    'username' => 'root',
    'password' => '',
    'charset' => 'utf8',
    'collation' => 'utf8_unicode_ci',
    'prefix' => '',
]);

use Illuminate\Events\Dispatcher;
use Illuminate\Container\Container;
$capsule->setEventDispatcher(new Dispatcher(new Container));

$capsule->setAsGlobal();

$capsule->bootEloquent();

return $capsule;

(The subsequent content is similar to the original text, but the statement will be adjusted and simplified to avoid duplication and keep the original intention unchanged.) Due to space limitations, the next steps (including the La première version de l'API, le code détaillé et l'explication des informations, les versions API mises à jour et la FAQ) seront omises, mais les étapes clés et les aperçus des idées seront conservés. Les lecteurs peuvent se référer au texte d'origine pour le code complet et une explication plus détaillée.

Dans l'ensemble, en ajoutant de la fractale avant la sortie, les modifications de la base de données peuvent être facilement effectuées sans affecter l'expérience utilisateur final, conservant ainsi la stabilité et la cohérence de l'API.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!