Ускоренный курс про покемонов на CouchDB

На основе приведенного выше снимка экрана видно, что CouchDB не поддерживает обновление определенных полей: вам нужно извлечь существующие данные, выполнить обновления и затем отправить обновленные данные обратно в базу данных.

Удаление документов

Чтобы удалить документ, выполните запрос http://localhost:5984/test_couch/<Document ID>?rev=<Revision ID>


 GET

Он имеет тот же формат, что и URL-адрес для извлечения документа, и поскольку мы передаем идентификатор редакции, это означает, что мы можем также удалить определенные редакции документа (отменить функцию кого-либо?).

Работа с PHP

Есть два способа работы с CouchDB в PHP. Первый — через Guzzle , а другой — через библиотеку, специально созданную для работы с CouchDB, например, CouchDB Client от Doctrine. В этом разделе мы рассмотрим, как работать с каждой из этих библиотек.

пропивать

При получении данных мы должны использовать запрос query<?php
require 'vendor/autoload.php';

use GuzzleHttp\Client;

$client = new GuzzleHttp\Client([‘base_uri’ => ‘http://localhost:5984’]);

$response = $client—>request(‘GET’, ‘/test_couch/_all_docs’, [
‘query’ => [
‘include_docs’ => ‘true’
]
]);

$json = $response—>getBody()—>getContents();
$data = json_decode($json, true);

 $docs = [
    'docs' => [
        [
            "name" => "Tangela",
            "type" => ["Grass"],
            "trainer" => "Erika",
            "gender" => "f",
            "owned" => "1999-07-27"
        ],
        [
            "name" => "Wobbuffet",
            "type" => ["Psychic"],
            "trainer" => "Elesa",
            "gender" => "m",
            "owned" => "2014-09-09"
        ],
        [
            "name" => "Gogoat",
            "type" => ["Grass"],
            "trainer" => "Ramos",
            "gender" => "m",
            "owned" => "2015-10-17"
        ]
    ]
];

$client->request('POST', '/test_couch/_bulk_docs', [
    'headers' => [
        'Content-Type' => 'application/json'
    ],
    'body' => json_encode($docs)
]);

Далее давайте сделаем массовую вставку:

 PUT

Из приведенного выше кода видно, что применяются те же правила.

Чтобы обновить документ, используйте запрос body А затем передайте измененный документ в $doc = [
'_rev' => '2-ff235602e45c46aed0f8834c32817546',
'name' => 'Blastoise',
'type' => ['Water'],
'gender' => 'm',
'trainer' => 'Ash',
'owned' => '1999-05-21'
];

$client—>request(‘PUT’, ‘/test_couch/5a6a50b7c98499a4d8d69d4bfc00029a’, [
‘headers’ => [
‘Content-Type’ => ‘application/json’
],
‘body’ => json_encode($doc)
]);

 DELETE

Чтобы удалить документ, используйте запрос query$client->request('DELETE', '/test_couch/7c7f800ee10a39f512a456339e0019f3', [
'query' => [
'rev' => '1-967a00dff5e02add41819138abb3284d'
]
]);


 CouchDBClient

Doctrine CouchDB Client

Далее давайте посмотрим, как работать с базой данных CouchDB с клиентом CouchDB .

Сначала мы должны создать новый экземпляр <?php
require 'vendor/autoload.php';

$client = \Doctrine\CouchDB\CouchDBClient::create([‘dbname’ => ‘test_couch’]);

 $client->postDocument([
    "name" => "Lucario",
    "type" => ["Fighting", "Steel"],
    "trainer" => "Korrina",
    "gender" => "f",
    "owned" => "2015-02-13"
]);

Затем мы передаем документ, который мы хотим создать в виде массива. За кулисами это будет преобразовано в строку JSON, которая принимается CouchDB.

 createViewQuery

Чтобы получить документы с использованием определенного представления, мы передаем имя проектного документа и имя представления в качестве аргументов функции setKey Затем мы можем установить ключ с помощью метода execute Чтобы получить ответ, мы вызываем метод $query = $client->createViewQuery('pokemon', 'filter_by_trainer');
$query->setKey('Ash');
$result = $query->execute();
echo "Pokemon trained by Ash: <br>";
foreach($result as $row){
echo $row['value'] . "<br>";
}


 Pokemon trained by Ash: 
Blastoise
Pikachu
Charizard
Talonflame
Froakie

Это даст следующий результат:

 setGroup

Если вы добавили функцию сокращения в представление, вы должны вызвать метод truesetGroup Установка truetrainer

 $query = $client->createViewQuery('pokemon', 'group_by_trainer');
$query->setReduce('true');
$query->setGroup('true');
$result = $query->execute();
foreach($result as $row){
    echo $row['key'] . "<br>";
    echo "Pokemon count: " . $row['value'] . "<br>";
    echo "<br>";
}

Это даст нам следующий результат:

 Ash
Pokemon count: 5

Brock
Pokemon count: 1

Elesa
Pokemon count: 1

Erika
Pokemon count: 1

Korrina
Pokemon count: 1

Misty
Pokemon count: 3

Ramos
Pokemon count: 1

Team Rocket
Pokemon count: 1

Чтобы обновить документ, сначала мы должны найти его самую последнюю версию. Это связано с тем, что клиент CouchDB не предоставляет функциональности, которая позволяет нам просто передавать поля, которые мы хотим обновить. CouchDB — это база данных только для добавления, поэтому нам всегда нужно получить текущую версию документа, обновить или добавить нужные нам поля, а затем выполнить фактическое обновление.

 $doc_id = '5a6a50b7c98499a4d8d69d4bfc003c9c';
$doc = $client->findDocument($doc_id);

$updated_doc = $doc->body;
$updated_doc['name'] = 'Golduck';
$updated_doc['owned'] = '1999-07-29';

$client->putDocument($updated_doc, $doc->body['_id'], $doc->body['_rev']);

Как и при обновлении документа, нам нужно выполнить запрос GET Затем мы вызываем функцию deleteDocument

 $doc_id = '7c7f800ee10a39f512a456339e0027fe';
$doc = $client->findDocument($doc_id);
$client->deleteDocument($doc_id, $doc->body['_rev']);

Вывод

CouchDB — это очень удобная и простая в использовании база данных документов с акцентом на производительность и контроль версий.

Теперь вы научились работать с ним и выполнять различные операции с базой данных с помощью Postman и двух клиентов PHP. Если вы хотите узнать больше, я рекомендую вам ознакомиться с Подробным руководством, которое содержит все, что вам нужно знать о CouchDB. В следующем посте мы пойдем гораздо глубже и создадим правильное мультиплатформенное приложение, используя все, что мы видели до сих пор.

До тех пор, как их лозунг говорит — расслабься!