Ce tutoriel fournit un guide pratique pour utiliser CouchDB, une base de données NoSQL, via son API HTTP avec PHP. Nous allons ignorer les aspects théoriques et plonger directement dans l'exécution des opérations de base de données. Nous supposons que vous avez déjà configuré CouchDB et Futon (sa console d'administration Web).
Remarque: nous utilisons localhost
pour la simplicité. Si vous utilisez une machine virtuelle, ajustez en conséquence (par exemple, à l'aide d'un VHOST personnalisé et de ports transmis).
Concepts clés:
Création d'une base de données:
Utilisez Futon ( https://www.php.cn/link/3bbbc60ff463969b78a091ff51ac6566 ) pour créer une base de données. Donnez-lui un nom (par exemple, test_couch
).
Après la création, vous verrez une interface pour ajouter des documents. N'oubliez pas que dans CouchDB, les documents sont l'unité fondamentale; Il n'y a pas de tables. Vous pouvez stocker différentes structures de données dans la même base de données. Pour l'organisation, incluez un champ type
pour catégoriser les documents (par exemple, "type": "users"
).
Exemples de structures de documents:
{"id": 123, "fname": "doppo", "lname": "kunikida", "pw": "secret", "hobbies": ["reading", "sleeping"], "type": "users"}
{"title": "The big brown fox", "author": "fox", "text": "...", "publish_date": "2016-07-07", "type": "blog_posts"}
Interaction API HTTP:
Vous pouvez utiliser curl
ou des outils comme Postman pour interagir directement avec l'API CouchDB HTTP.
curl -X PUT http://localhost:5984/<database_name></database_name>
(renvoie {"ok":true}
) http://localhost:5984/test_couch
, avec Content-Type: application/json
et votre document JSON dans le corps.
Insert en vrac:
Utilisez une demande de poste à http://localhost:5984/test_couch/_bulk_docs
avec un tableau de documents dans le corps JSON.
Récupération des documents:
http://localhost:5984/test_couch/_all_docs?include_docs=true
http://localhost:5984/test_couch/<document_id>?include_docs=true</document_id>
&rev=<revision_id></revision_id>
à l'URL ci-dessus. CouchDB suit les révisions; Chaque mise à jour crée une nouvelle révision. Futon permet de parcourir ces révisions.
Vues (MapReduce):
Les vues fournissent des capacités de requête. Créez des vues dans Futon à l'aide de la carte et réduisez les fonctions (JavaScript). Ces fonctions sont enregistrées dans des documents de conception.
function(doc) { emit(doc.trainer, doc.name); }
Accès aux vues via des URL comme: http://localhost:5984/test_couch/_design/<design_doc>/_view/<view_name>?key="Ash"
Mise à jour des documents:
Envoyez une demande de vente à l'URL du document, y compris le champ _rev
avec le dernier ID de révision. Vous devez fournir l'intégralité du document mis à jour.
Suppression des documents:
Envoyez une demande de suppression à l'URL du document, y compris le champ _rev
avec le dernier ID de révision.
http://localhost:5984/test_couch/<document_id>?rev=<revision_id>
Intégration PHP (Guzzle):
Guzzle simplifie les demandes HTTP dans PHP. Les exemples suivants démontrent les opérations de base: (n'oubliez pas d'installer Guzzle: composer require guzzlehttp/guzzle
)
<?php require 'vendor/autoload.php'; use GuzzleHttp\Client; $client = new Client(['base_uri' => 'http://localhost:5984']); // ... (GET, POST, PUT, DELETE examples using Guzzle similar to the curl and Postman examples above) ... ?>
Intégration PHP (Doctrine CouchDB Client):
Le client CouchDB de Doctrine fournit une abstraction de niveau supérieur. (Installer avec: composer require doctrine/couchdb
)
<?php require 'vendor/autoload.php'; $client = \Doctrine\CouchDB\CouchDBClient::create(['dbname' => 'test_couch']); // ... (Examples for creating, retrieving, updating, and deleting documents using the Doctrine client) ... ?>
Conclusion:
Ce tutoriel offre une introduction pratique à CouchDB en utilisant son API HTTP et PHP. Explorez la documentation officielle et le guide définitif pour les fonctionnalités plus avancées. Les futurs articles approfondiront la création d'applications avec CouchDB.
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!