PHPackages google/cloud-firestore - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Database & ORM](/categories/database) 4. / 5. google/cloud-firestore ActiveLibrary[Database & ORM](/categories/database) google/cloud-firestore ====================== Cloud Firestore Client for PHP v1.55.0(5mo ago)1804.1M↓12.8%3420Apache-2.0PHPPHP ^8.1CI passing Since Nov 16Pushed 2mo ago56 watchersCompare [ Source](https://github.com/googleapis/google-cloud-php-firestore)[ Packagist](https://packagist.org/packages/google/cloud-firestore)[ RSS](/packages/google-cloud-firestore/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (9)Versions (153)Used By (20) Cloud Firestore for PHP ======================= [](#cloud-firestore-for-php) > Idiomatic PHP client for [Cloud Firestore](https://cloud.google.com/firestore/). [![Latest Stable Version](https://camo.githubusercontent.com/112fabe80fa7847ed3025e3d70d79b19aea8af221c5d5c7190714b073682746f/68747470733a2f2f706f7365722e707567782e6f72672f676f6f676c652f636c6f75642d6669726573746f72652f762f737461626c65)](https://packagist.org/packages/google/cloud-firestore) [![Packagist](https://camo.githubusercontent.com/9206fce5931b5599afd93050231b4796690a04e4a6f9a91e24a70dbfe167c2bf/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f676f6f676c652f636c6f75642d6669726573746f72652e737667)](https://packagist.org/packages/google/cloud-firestore) - [API documentation](https://cloud.google.com/php/docs/reference/cloud-firestore/latest) **NOTE:** This repository is part of [Google Cloud PHP](https://github.com/googleapis/google-cloud-php). Any support requests, bug reports, or development contributions should be directed to that project. A NoSQL document database built for automatic scaling, high performance, and ease of application development. While the Cloud Firestore interface has many of the same features as traditional databases, as a NoSQL database it differs from them in the way it describes relationships between data objects. ### Installation [](#installation) To begin, install the preferred dependency manager for PHP, [Composer](https://getcomposer.org/). Now install this component: ``` $ composer require google/cloud-firestore ``` This component requires the gRPC extension. Please see our [gRPC installation guide](https://cloud.google.com/php/grpc)for more information on how to configure the extension. ### Authentication [](#authentication) Please see our [Authentication guide](https://github.com/googleapis/google-cloud-php/blob/main/AUTHENTICATION.md) for more information on authenticating your client. Once authenticated, you'll be ready to start making requests. ### Sample [](#sample) ``` use Google\ApiCore\ApiException; use Google\Cloud\Firestore\V1\Client\FirestoreClient; use Google\Cloud\Firestore\V1\Document; use Google\Cloud\Firestore\V1\GetDocumentRequest; // Create a client. $firestoreClient = new FirestoreClient(); // Prepare the request message. $request = (new GetDocumentRequest()) ->setName($name); // Call the API and handle any network failures. try { /** @var Document $response */ $response = $firestoreClient->getDocument($request); printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString()); } catch (ApiException $ex) { printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage()); } ``` ### Debugging [](#debugging) Please see our [Debugging guide](https://github.com/googleapis/google-cloud-php/blob/main/DEBUG.md)for more information about the debugging tools. ### Version [](#version) This component is considered GA (generally available). As such, it will not introduce backwards-incompatible changes in any minor or patch releases. We will address issues and requests with the highest priority. ### Next Steps [](#next-steps) 1. Understand the [official documentation](https://cloud.google.com/firestore/docs/). 2. Take a look at [in-depth usage samples](https://github.com/GoogleCloudPlatform/php-docs-samples/tree/master/firestore). ### Health Score 72 — ExcellentBetter than 100% of packages Maintenance81 Actively maintained with recent releases Popularity61 Solid adoption and visibility Community45 Growing community involvement Maturity90 Battle-tested with a long release history Bus Factor3 3 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~20 days Recently: every ~25 days Total 152 Last Release 62d ago Major Versions v0.15.8 → v1.0.02019-02-06 v1.55.0 → v2.0.2-RC12026-01-23 PHP version history (3 changes)v1.30.0PHP >=7.4 v1.41.2PHP ^8.0 v1.52.0PHP ^8.1 ### Community Maintainers ![](https://www.gravatar.com/avatar/a8713415b20b4be4cec8f8b22741e3cd05f76eee9e38de1de5bf32727349b7c5?d=identicon)[bshaffer](/maintainers/bshaffer) ![](https://www.gravatar.com/avatar/3901206952845568d7557a60855b097f6d1bafaa7a24020cfcf5bb8de74f9d28?d=identicon)[google-cloud](/maintainers/google-cloud) --- Top Contributors [![release-please[bot]](https://avatars.githubusercontent.com/in/40688?v=4)](https://github.com/release-please[bot] "release-please[bot] (86 commits)")[![jdpedrie](https://avatars.githubusercontent.com/u/89034?v=4)](https://github.com/jdpedrie "jdpedrie (84 commits)")[![gcf-owl-bot[bot]](https://avatars.githubusercontent.com/in/99011?v=4)](https://github.com/gcf-owl-bot[bot] "gcf-owl-bot[bot] (66 commits)")[![bshaffer](https://avatars.githubusercontent.com/u/103941?v=4)](https://github.com/bshaffer "bshaffer (56 commits)")[![yoshi-automation](https://avatars.githubusercontent.com/u/44816363?v=4)](https://github.com/yoshi-automation "yoshi-automation (43 commits)")[![dwsupplee](https://avatars.githubusercontent.com/u/2079879?v=4)](https://github.com/dwsupplee "dwsupplee (30 commits)")[![vishwarajanand](https://avatars.githubusercontent.com/u/7369612?v=4)](https://github.com/vishwarajanand "vishwarajanand (13 commits)")[![michaelbausor](https://avatars.githubusercontent.com/u/14846209?v=4)](https://github.com/michaelbausor "michaelbausor (12 commits)")[![ajupazhamayil](https://avatars.githubusercontent.com/u/14087896?v=4)](https://github.com/ajupazhamayil "ajupazhamayil (6 commits)")[![yash30201](https://avatars.githubusercontent.com/u/54198301?v=4)](https://github.com/yash30201 "yash30201 (5 commits)")[![Hectorhammett](https://avatars.githubusercontent.com/u/9062626?v=4)](https://github.com/Hectorhammett "Hectorhammett (3 commits)")[![jeromegamez](https://avatars.githubusercontent.com/u/67554?v=4)](https://github.com/jeromegamez "jeromegamez (3 commits)")[![danielgsims](https://avatars.githubusercontent.com/u/695933?v=4)](https://github.com/danielgsims "danielgsims (2 commits)")[![chingor13](https://avatars.githubusercontent.com/u/32483?v=4)](https://github.com/chingor13 "chingor13 (2 commits)")[![ava12](https://avatars.githubusercontent.com/u/1997053?v=4)](https://github.com/ava12 "ava12 (2 commits)")[![saranshdhingra](https://avatars.githubusercontent.com/u/1038319?v=4)](https://github.com/saranshdhingra "saranshdhingra (2 commits)")[![WeiranFang](https://avatars.githubusercontent.com/u/8175562?v=4)](https://github.com/WeiranFang "WeiranFang (2 commits)")[![frederichoule](https://avatars.githubusercontent.com/u/3178959?v=4)](https://github.com/frederichoule "frederichoule (1 commits)")[![davidkmenta](https://avatars.githubusercontent.com/u/759218?v=4)](https://github.com/davidkmenta "davidkmenta (1 commits)")[![renovate-bot](https://avatars.githubusercontent.com/u/25180681?v=4)](https://github.com/renovate-bot "renovate-bot (1 commits)") ### Code Quality TestsPHPUnit Code StylePHP\_CodeSniffer ### Embed Badge ![Health badge](/badges/google-cloud-firestore/health.svg) ``` [![Health](https://phpackages.com/badges/google-cloud-firestore/health.svg)](https://phpackages.com/packages/google-cloud-firestore) ``` ### Alternatives [google/cloud-bigquery BigQuery Client for PHP 8917.2M41](/packages/google-cloud-bigquery)[bavix/laravel-wallet It's easy to work with a virtual wallet. 1.3k1.1M11](/packages/bavix-laravel-wallet)[dyrynda/laravel-model-uuid This package allows you to easily work with UUIDs in your Laravel models. 4802.8M8](/packages/dyrynda-laravel-model-uuid)[google/cloud-datastore Cloud Datastore Client for PHP 241.2M21](/packages/google-cloud-datastore)[google/cloud-spanner Cloud Spanner Client for PHP 20551.5k5](/packages/google-cloud-spanner)[google/cloud-bigtable Cloud Bigtable Client for PHP 13387.1k](/packages/google-cloud-bigtable) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)