Fractal: Laluan Praktikal

pemaju API sering menghadapi cabaran perubahan skema pangkalan data. Tanpa pelaksanaan yang baik, mengubah nama lajur mungkin memerlukan refactoring keseluruhan model. Artikel ini akan menunjukkan cara menggunakan fraktal sebagai jambatan antara model dan output JSON untuk memudahkan proses pembangunan API.

Mata utama:

Fractal adalah projek PHP yang bertindak sebagai lapisan pertengahan antara model dan output JSON, yang membolehkan skema pangkalan data diubah suai tanpa refactoring keseluruhan model, dengan itu memudahkan pembangunan API.
Fractal berfungsi dengan komposer dan merupakan sebahagian daripada Liga Pakej Luar Biasa, yang semuanya memenuhi keperluan menggunakan PHP-FIG dan liputan ujian unit.
Pakej fraktal boleh menggunakan silex dan menerangi/pangkalan data untuk menubuhkan persekitaran dan membuat rangka kerja. Ia memerlukan membuat fail komposer.json dengan kebergantungan yang diperlukan.
Dengan menggunakan fraktal sebelum output, perubahan pangkalan data boleh dibuat dengan mudah walaupun corak data yang mendasari berubah tanpa diperhatikan oleh pengguna akhir, menjadi alat yang berkuasa untuk mengekalkan struktur output yang konsisten.

Bag fractal

Fractal adalah projek yang ditulis dalam PHP dan tergolong dalam Liga Pakej Luar Biasa. Pakej ini memenuhi pelbagai keperluan, seperti menggunakan PHP-FIG dan liputan ujian unit. Fractal kebanyakannya dibangunkan oleh Phil Sturgeon dan terus menerima penambahbaikan secara teratur. Ia juga boleh digunakan dengan komposer.

Tetapkan persekitaran

Untuk demonstrasi, saya akan menyediakan rangka kerja menggunakan Silex dan Illuminate/Database (komponen Orm Laravel). Walaupun anda tidak biasa dengan mana -mana daripada mereka, tidak mengapa. Apa yang akan saya lakukan adalah sangat mudah dan jelas, dan saya akan menerangkannya dengan jelas. Sekiranya anda mempunyai kawasan yang tidak jelas, sila bebas meninggalkan mesej. Saya akan mula menubuhkan rangka kerja. Sila ambil perhatian bahawa jika anda tidak mahu mengikuti langkah -langkah, anda boleh memuat turun semua kod pada akhir artikel. Sekarang, buat folder baru di dalam folder root. Kami akan bermula dengan membuat fail komposer.json yang mengandungi semua kebergantungan yang kami perlukan. Dalam kes ini: Silex dan Illuminatedatabase. Buat fail composer.json seperti ini:

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

Gunakan

untuk memasang pakej ini. composer install

Pangkalan data

Saya akan mengambil pangkalan data muzik dalam talian sebagai contoh. Pangkalan data akan memberikan maklumat mengenai pelbagai lagu: tajuk lagu, nama artis, laman web artis, tajuk album, tarikh pelepasan dan label rekod. Pada mulanya, semua maklumat ini akan disimpan dalam jadual. Jika anda ingin mencubanya sendiri, muat turun fail 1.SQL dari pangkalan kod artikel ini dan jalankannya dalam pangkalan data anda.

kod

Untuk menggunakan Silex dengan Illuminatedatabase, kita memerlukan beberapa kod. Buat fail baru bernama index.php dalam folder aplikasi. Di sini kita akan memulakan Silex, menyambung ke pangkalan data dan menentukan laluan:

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

Baris pertama adalah untuk memperkenalkan fail pemuatan automatik komposer. Kemudian kami membuat aplikasi Silex baru dan beban menerangi/pangkalan data. Kemudian, kami membuat pengawal untuk /tracks supaya semua URL bermula dengan /tracks akan diproses oleh pengawal/tracks.php. Fail database.php kelihatan seperti ini, ingat untuk menukar tetapan sambungan:

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

$app = new Silex\Application();

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

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

$app->run();

Pertama, kami menggunakan pembina pertanyaan Illuminatedatabase untuk mendapatkan senarai ID, nama, dan artis, dan kemudian mengeluarkannya. Output akan mempunyai format berikut:

<?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;

(kandungan berikutnya adalah serupa dengan teks asal, tetapi pernyataan itu akan diselaraskan dan dipermudahkan untuk mengelakkan pertindihan dan mengekalkan niat asal tidak berubah.) Versi API pertama, menjejaki kod terperinci dan penjelasan maklumat, versi API yang dikemas kini, dan FAQ) akan ditinggalkan, tetapi langkah -langkah utama dan gambaran keseluruhan idea akan dikekalkan. Pembaca boleh merujuk kepada teks asal untuk kod lengkap dan penjelasan yang lebih terperinci.

semua dalam semua, dengan menambah fraktal sebelum output, perubahan pangkalan data boleh dibuat dengan mudah tanpa menjejaskan pengalaman pengguna akhir, dengan itu mengekalkan kestabilan dan konsistensi API.

Atas ialah kandungan terperinci Fractal: Laluan Praktikal. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!