在PHP開發中如何使用Google Cloud Firestore進行文件儲存與查詢

在PHP開發中如何使用Google Cloud Firestore進行文件儲存和查詢

隨著雲端運算技術的不斷發展，雲端服務已經成為了現代化應用程式開發的必要環節。 Google Cloud Firestore是Google推出的一項基於文件的NoSQL資料庫服務，提供了即時資料庫、離線資料同步、強一致性、自動化擴充、全球部署等優秀功能。本篇文章將主要介紹如何在PHP專案中使用Google Cloud Firestore進行文件儲存與查詢。

步驟1：建立Google Cloud Firestore專案

首先需要登入您的Google Cloud帳號，並在Google Cloud Console中建立一個新的專案。在專案中開啟Firestore選項卡，建立新的Cloud Firestore資料庫，可以選擇測試模式或生產模式。測試模式允許任何人都可以存取您的資料庫，而生產模式需要進行身份驗證和授權才能存取。記錄下此時產生的項目ID。

步驟2：安裝Google Cloud Firestore SDK

在PHP專案中使用Google Cloud Firestore需要安裝Google Cloud Firestore SDK。在終端機中使用composer指令來進行安裝：

composer require google/cloud-firestore

步驟3：設定Google Cloud Firestore SDK

在程式碼中加入以下程式碼來設定Google Cloud Firestore SDK，需要將下文中的“ your_project_id」替換為步驟1產生的專案ID：

<?php
use GoogleCloudFirestoreFirestoreClient;

$firestore = new FirestoreClient([
    'projectId' => 'your_project_id',
]);

步驟4：儲存文件

接下來就可以使用FirestoreClient物件進行文件的儲存與查詢了。以下是在PHP專案中使用FirestoreClient物件儲存一個文件的範例程式碼：

<?php
use GoogleCloudFirestoreFirestoreClient;

$firestore = new FirestoreClient([
    'projectId' => 'your_project_id',
]);

$docRef = $firestore->collection('users')->document('alovelace');
$docRef->set([
    'first' => 'Ada',
    'last' => 'Lovelace',
    'born' => 1815
]);

在上述程式碼中，我們首先建立了一個FirestoreClient對象，並指定了專案ID。然後建立了一個users集合，並在其中建立了一個名為「alovelace」的文檔，並設定了其屬性值。其中，「first」代表名字，「last」代表姓氏，「born」代表出生日期。儲存完成後，Firestore會自動產生一個唯一的文件ID。

步驟5：查詢文件

可以使用get()方法來尋找文件。以下是在PHP專案中使用FirestoreClient物件查詢一個文檔的範例程式碼：

<?php
use GoogleCloudFirestoreFirestoreClient;

$firestore = new FirestoreClient([
    'projectId' => 'your_project_id',
]);

$docRef = $firestore->collection('users')->document('alovelace');
$snapshot = $docRef->snapshot();

if ($snapshot->exists()) {
    printf('User %s was born in %d', $snapshot['first'], $snapshot['born']);
} else {
    printf('Document %s does not exist!', $docRef->name());
}

在上述程式碼中，我們首先取得了名為「alovelace」的文檔，並透過snapshot()方法取得文檔快照。如果文件存在，則輸出「User」的名字和出生日期，否則輸出文件不存在的提示資訊。

步驟6：更新並刪除文件

可以使用update()方法更新文件。以下是在PHP專案中使用FirestoreClient物件更新一個文檔的範例程式碼：

<?php
use GoogleCloudFirestoreFirestoreClient;

$firestore = new FirestoreClient([
    'projectId' => 'your_project_id',
]);

$docRef = $firestore->collection('users')->document('alovelace');
$docRef->update([
    ['path' => 'first', 'value' => 'Ada King'],
    ['path' => 'born', 'value' => 1816]
]);

在上述程式碼中，我們首先取得了名為「alovelace」的文檔，並透過update()方法更新了名字和出生日期。

可以使用delete()方法刪除文件。以下是在PHP專案中使用FirestoreClient物件刪除一個文件的範例程式碼：

<?php
use GoogleCloudFirestoreFirestoreClient;

$firestore = new FirestoreClient([
    'projectId' => 'your_project_id',
]);

$docRef = $firestore->collection('users')->document('alovelace');
$docRef->delete();

在上述程式碼中，我們在名為「alovelace」的文件上呼叫了delete()方法來刪除文件。

結論

Google Cloud Firestore是Google推出的一項基於文件的NoSQL資料庫服務，提供了即時資料庫、離線資料同步、強一致性、自動化擴展、全球部署等優秀特性。在PHP專案中使用FirestoreClient物件可以快速儲存和查詢文檔，並且可以輕鬆更新和刪除文檔。掌握Google Cloud Firestore的使用可以提高PHP開發者的開發效率。

以上是在PHP開發中如何使用Google Cloud Firestore進行文件儲存與查詢的詳細內容。更多資訊請關注PHP中文網其他相關文章！