PHP 5 telah mencapai akhir dukungan dan akan
dihentikan penggunaannya
pada 31 Januari 2026. Setelah penghentian penggunaan, Anda tidak akan dapat men-deploy aplikasi PHP 5, meskipun organisasi Anda sebelumnya menggunakan kebijakan organisasi untuk mengaktifkan kembali deployment runtime lama. Aplikasi PHP 5 yang sudah ada akan terus berjalan dan menerima traffic setelah
tanggal penghentiannya. Sebaiknya Anda
bermigrasi ke versi PHP terbaru yang didukung.
Menggunakan Cloud Firestore dalam Mode Datastore
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Firestore adalah database dokumen NoSQL yang dibangun untuk penskalaan otomatis, performa tinggi, dan kemudahan pengembangan aplikasi. Ini adalah versi terbaru Datastore dan memperkenalkan beberapa peningkatan pada Datastore.
Karena Firestore dalam mode Datastore yang dioptimalkan untuk kasus penggunaan server dan untuk App Engine, sebaiknya gunakan Firestore dalam mode Datastore untuk database yang akan digunakan terutama oleh aplikasi App Engine. Firestore dalam mode Native paling berguna untuk kasus penggunaan notifikasi real-time dan seluler. Untuk mengetahui informasi selengkapnya tentang mode Firestore, lihat Memilih antara Mode Native dan mode Datastore.
Menggunakan mode Datastore dengan App Engine
Untuk menggunakan mode Datastore dengan App Engine:
Jika belum melakukannya, buat database lalu pilih Firestore dalam mode Datastore.
Anda dapat menggunakan database Datastore yang sudah ada dengan aplikasi App Engine. Database yang sudah ada ini akan otomatis di-upgrade ke Firestore dalam mode Datastore.
Di aplikasi Anda, deklarasikan Datastore sebagai dependensi
dengan menambahkan google/cloud-datastore
ke file composer.json
aplikasi Anda dan menjalankan
composer install
dari direktori aplikasi Anda. Pelajari composer lebih lanjut.
Gunakan Library Klien Google Cloud untuk membaca dan menulis entity serta membuat kueri data.
Mengonfigurasi indeks
Mode Datastore menggunakan indeks untuk setiap kueri yang dibuat aplikasi Anda. Indeks diperbarui setiap kali entity berubah, sehingga hasilnya dapat ditampilkan dengan cepat saat aplikasi membuat kueri.
Mode Datastore secara otomatis membuat indeks properti tunggal untuk digunakan dengan jenis kueri yang sederhana. Untuk kueri kompleks yang mencakup beberapa properti, Anda harus mengonfigurasi indeks komposit di file index.yaml
aplikasi.
Server pengembangan App Engine akan memperbarui file index.yaml
Anda dengan indeks komposit yang diperlukan untuk menjalankan pengujian. Demikian pula, emulator mode Datastore dapat membuat indeks saat Anda menjalankan pengujian.
Anda juga dapat menambahkan indeks ke file index.yaml
aplikasi secara manual jika tidak menjalankan pengujian lokal atau pengujian tidak menyertakan kueri yang kompleks.
Menetapkan izin database
Secara default, aplikasi Anda memiliki semua izin yang diperlukan untuk membaca dan menulis ke mode Datastore dan database Firestore di projectGoogle Cloud .
Untuk mengelola izin ini, setiap aplikasi App Engine menggunakan akun layanan default yang memberikan akses baca dan tulis penuh ke mode Datastore dan database Firestore dalam project yang sama dengan aplikasi. Anda dapat mengubah izin akses dari akun layanan default, tetapi aplikasi Anda dapat kehilangan akses kecuali jika Anda menetapkan peran IAM dengan izin yang diperlukan.
Untuk mengetahui informasi tentang cara mengizinkan pengguna, aplikasi, atau project lain mengakses database, lihat Mengakses database.
Menggunakan emulator mode Datastore untuk pengujian lokal
Google Cloud CLI menyertakan emulator dari lingkungan mode untuk mode Datastore produksi secara lokal.
Anda dapat menggunakan emulator untuk mengembangkan dan menguji aplikasi secara lokal. Selain itu, emulator dapat membantu Anda membuat indeks untuk instance mode dari mode Datastore produksi Anda dan menghapus indeks yang tidak diperlukan.
Jika menggunakan server pengembangan lokal App Engine untuk menguji aplikasi, Anda dapat memastikan bahwa server akan menggunakan emulator mode Datastore dengan menetapkan tanda --support_datastore_emulator=true
saat memulai
server.
Jika Anda menggunakan emulator mode Datastore, dev_appserver akan menampilkan:
... Using Cloud Datastore Emulator.
Harga, kuota, dan batas
Mode Datastore menawarkan kuota gratis dengan batas harian. Akun berbayar menawarkan penyimpanan tak terbatas, operasi baca, dan tulis. Informasi selengkapnya tersedia di halaman Kuota Datastore.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-19 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-19 UTC."],[[["\u003cp\u003eFirestore, an upgraded version of Datastore, is a NoSQL document database designed for automatic scaling, high performance, and straightforward application development, offering both Native mode and Datastore mode.\u003c/p\u003e\n"],["\u003cp\u003eFirestore in Datastore mode is recommended for App Engine applications, while Native mode is better suited for mobile and real-time notification use cases, with existing Datastore databases automatically upgrading to this mode.\u003c/p\u003e\n"],["\u003cp\u003eDatastore mode relies on indexes for all application queries, with automatic creation for single-property indexes and manual or emulator-assisted creation for complex composite indexes in the \u003ccode\u003eindex.yaml\u003c/code\u003e file.\u003c/p\u003e\n"],["\u003cp\u003eApp Engine apps have default service account permissions for Datastore mode and Firestore databases within the same Google Cloud project, though permissions can be adjusted via IAM roles.\u003c/p\u003e\n"],["\u003cp\u003eThe Datastore mode emulator, part of the Google Cloud CLI, allows for local development and testing, including index generation and deletion, and can be used in conjunction with the App Engine local development server.\u003c/p\u003e\n"]]],[],null,["# Using Cloud Firestore in Datastore Mode\n\nFirestore is a NoSQL document database built for automatic scaling,\nhigh performance, and ease of application development. It is the newest version\nof Datastore and introduces several improvements over\nDatastore.\n\nBecause Firestore in [Datastore mode](/datastore/docs)\nis optimized for server use cases and for\nApp Engine, we recommend using Firestore in\nDatastore mode for databases that will be used primarily by\nApp Engine apps. Firestore in Native mode is most useful for\nmobile and real-time notification use cases. For more information about\nFirestore modes, see [Choosing between Native Mode and\nDatastore mode](/datastore/docs/firestore-or-datastore).\n\nUsing Datastore mode with App Engine\n------------------------------------\n\nTo use Datastore mode with App Engine:\n\n1. If you haven't already done so,\n [create a database](/datastore/docs/store-query-data#create_a_database)\n and choose Firestore in Datastore mode.\n\n You can use existing Datastore databases with App Engine\n apps. These existing databases [will be automatically upgraded to\n Firestore in Datastore\n mode](/datastore/docs/upgrade-to-firestore).\n\n\n 1. In your app, declare Datastore as a dependency\n\n by adding `google/cloud-datastore` to your app's `composer.json` file and running\n `composer install` from your app's directory. Learn more about\n [composer](https://getcomposer.org).\n\n \u003cbr /\u003e\n\n 2. Use the Google Cloud Client Library to\n [read and write entities](/datastore/docs/concepts/entities)\n and to [query data](/datastore/docs/concepts/queries).\n\n Configuring indexes\n -------------------\n\n Datastore mode uses\n [indexes](/datastore/docs/concepts/indexes)\n for every query your application makes. The indexes are updated whenever an\n entity changes, so the results can be returned quickly when the app makes a\n query.\n\n Datastore mode automatically creates single-property indexes for use with\n simple types of queries. For complex queries that include multiple properties,\n you'll need to configure composite indexes in your app's `index.yaml` file.\n\n The App Engine development server will update your `index.yaml` file\n with the composite indexes needed to run your tests. Similarly, the\n [Datastore mode emulator can generate indexes](/datastore/docs/tools)\n when you run tests.\n\n You can also add the indexes to your app's\n `index.yaml` file [manually](/appengine/docs/legacy/standard/php/configuring-datastore-indexes-with-index-yaml) if you do not run local\n tests or your tests do not include complex queries.\n\n Setting database permissions\n ----------------------------\n\n By default, your app has all the permissions required to read and write to\n Datastore mode and Firestore databases in your\n Google Cloud project.\n\n To manage these permissions, each App Engine app uses a [default service\n account](/appengine/docs/legacy/standard/php/service-account)\n that gives full read and write access to Datastore mode\n and Firestore databases in the same project as the app. You can\n [change the permissions of the default service\n account](/appengine/docs/legacy/standard/php/access-control#modify-service-account),\n but your app may lose access unless you assign an IAM role with the\n [required permissions](/datastore/docs/access/iam#required_permissions).\n\n For information about allowing other users, apps, or projects to access a database, see\n [Accessing your database](/datastore/docs/activate).\n\n Using the Datastore mode emulator for local testing\n ---------------------------------------------------\n\n The Google Cloud CLI includes a local [emulator of the production Datastore mode\n mode environment](/datastore/docs/tools/datastore-emulator). You can use the emulator to develop and test your application locally. In addition, the emulator can help you generate indexes for your production Datastore mode mode instance and delete unneeded indexes.\n\n \u003cbr /\u003e\n\n If you use the App Engine [local development\n server](/appengine/docs/legacy/standard/python/tools/using-local-server) to test your\n app, you can ensure that the server will use the Datastore mode\n emulator by setting the `--support_datastore_emulator=true` flag when starting\n the server.\n\n If you are using the Datastore mode emulator, dev_appserver will display: \n\n ... Using Cloud Datastore Emulator.\n\n Pricing, quotas, and limits\n ---------------------------\n\n Datastore mode offers a free quota with daily limits. Paid\n accounts offer unlimited storage, read, and write operations. More information\n is available on the [Datastore Quotas](/appengine/docs/legacy/standard/php/quotas#Datastore) page."]]