PHPackages                             auroraextensions/googlecloudstorage - 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. [File &amp; Storage](/categories/file-storage)
4. /
5. auroraextensions/googlecloudstorage

ActiveMagento2-module[File &amp; Storage](/categories/file-storage)

auroraextensions/googlecloudstorage
===================================

Google Cloud Storage integration for Magento.

1.2.1(3y ago)146.6k8[2 issues](https://github.com/auroraextensions/googlecloudstorage/issues)[2 PRs](https://github.com/auroraextensions/googlecloudstorage/pulls)MITPHPPHP ^7.2||^8.0

Since Sep 30Pushed 2y ago1 watchersCompare

[ Source](https://github.com/auroraextensions/googlecloudstorage)[ Packagist](https://packagist.org/packages/auroraextensions/googlecloudstorage)[ RSS](/packages/auroraextensions-googlecloudstorage/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependencies (10)Versions (6)Used By (0)

Google Cloud Storage
====================

[](#google-cloud-storage)

- [Description](#description)
- [Installation](#installation)
- [Configuration](#configuration)
- [Synchronization](#synchronization)
- [Service Account](#service-account)
- [Troubleshooting](#troubleshooting)

[Description](#id1)
-------------------

[](#description)

Use [Google Cloud Storage](https://cloud.google.com/storage/) to store media assets in Magento.

[Installation](#id2)
--------------------

[](#installation)

We highly recommend installing via Composer for package management.

```
composer require auroraextensions/googlecloudstorage
```

[Configuration](#id3)
---------------------

[](#configuration)

Once installed, update the environment configuration file. See [env.php.sample](https://github.com/auroraextensions/googlecloudstorage/blob/master/env.php.sample) for an example. The following information should be readily available:

1. Google Cloud project ID
2. Path to the Google Cloud service account JSON key file. See [Service Account](#service-account) for more details.
3. Google Cloud Storage bucket name
4. Google Cloud Storage bucket region (if applicable)

Next, enable the module with the Magento autoloader.

```
php bin/magento module:enable AuroraExtensions_GoogleCloudStorage
```

[Synchronization](#id4)
-----------------------

[](#synchronization)

You can initiate the bulk synchronization process through the Magento backend, just as you would with any other media storage configuration. Additionally, you can initiate the bulk synchronization process from the command line using the provided synchronization CLI command.

```
php bin/magento gcs:media:sync
```

**IMPORTANT**: This process can be very slow, especially if you have a lot of media files.

[Service Account](#id5)
-----------------------

[](#service-account)

For the purposes of authenticating with Google Cloud Platform, this module leverages the flexibility and ease of use provided by Google Cloud service accounts. Before moving forward, please make sure to complete the following:

1. Create a Google Cloud service account with **Storage Admin** privileges. Once the service account is created, you will be prompted to download a JSON key file. Store this key file in a safe place.
2. Install the service account JSON key file to the local or mounted filesystem with read-only permissions for the Magento user.
3. Verify the following fields are set and correct in the environment configuration file (env.php):
    1. All required fields
    2. The Google Cloud project name is where the bucket exists
    3. The path to the Google Cloud service account JSON key file (e.g. /etc/gcs.json). Relative paths are assumed to be relative to the Magento root directory.
    4. \[OPTIONAL\] If you use the same bucket for multiple projects, you can specify a subdirectory to synchronize to inside the bucket. By default, it will synchronize to /.

For more information on Google Cloud service account keys, please see [Creating and Managing Service Account Keys](https://cloud.google.com/iam/docs/creating-managing-service-account-keys).

For an example configuration file, please see [env.php.sample](https://github.com/auroraextensions/googlecloudstorage/blob/master/env.php.sample).

[Troubleshooting](#id6)
-----------------------

[](#troubleshooting)

> Given keyfile at path /path/to/magento was invalid

You need to create and install a service account key to authenticate with Google Cloud. See [Service Account](#service-account) for specific details on Google Cloud service accounts.

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance17

Infrequent updates — may be unmaintained

Popularity28

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 97.9% of commits — single point of failure

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 ~318 days

Total

5

Last Release

1185d ago

PHP version history (3 changes)1.0.0PHP &gt;=7.2

1.1.0PHP ~7.2.0||~7.3.0||~7.4.0

1.2.1PHP ^7.2||^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/270c3d6fe70cec0479131d41d37fa4980679363605856166dc202cc44fe83740?d=identicon)[auroraextensions](/maintainers/auroraextensions)

---

Top Contributors

[![nickolasburr](https://avatars.githubusercontent.com/u/4663695?v=4)](https://github.com/nickolasburr "nickolasburr (191 commits)")[![davidwindell](https://avatars.githubusercontent.com/u/1720090?v=4)](https://github.com/davidwindell "davidwindell (4 commits)")

---

Tags

google-cloud-storagemagentomagento2

### Embed Badge

![Health badge](/badges/auroraextensions-googlecloudstorage/health.svg)

```
[![Health](https://phpackages.com/badges/auroraextensions-googlecloudstorage/health.svg)](https://phpackages.com/packages/auroraextensions-googlecloudstorage)
```

###  Alternatives

[symfony/symfony

The Symfony PHP framework

31.4k86.9M2.2k](/packages/symfony-symfony)[matomo/matomo

Matomo is the leading Free/Libre open analytics platform

21.6k38.2k](/packages/matomo-matomo)[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.2k532.1M2.5k](/packages/aws-aws-sdk-php)[tempest/framework

The PHP framework that gets out of your way.

2.2k31.1k12](/packages/tempest-framework)[flow-php/flow

PHP ETL - Extract Transform Load - Data processing framework

84735.1k](/packages/flow-php-flow)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.4M517](/packages/shopware-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
