PHPackages                             nickolasburr/magegcs - 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. nickolasburr/magegcs

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

nickolasburr/magegcs
====================

Use Google Cloud Storage as the file storage backend for Magento 1.x.

4253PHP

Since Jan 27Pushed 7y ago1 watchersCompare

[ Source](https://github.com/auroraextensions/magegcs)[ Packagist](https://packagist.org/packages/nickolasburr/magegcs)[ RSS](/packages/nickolasburr-magegcs/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependenciesVersions (1)Used By (0)

Google Cloud Storage for Magento 1.x
====================================

[](#google-cloud-storage-for-magento-1x)

Use [Google Cloud Storage](https://cloud.google.com/storage/) as the backend for storing media assets in Magento 1.x.

Table of Contents
-----------------

[](#table-of-contents)

1. [Prerequisites](#prerequisites)
2. [Documentation](#documentation)
3. [Features](#features)
4. [FAQs](#faqs)
5. [Troubleshooting](#troubleshooting)
6. [Credits](#credits)

Prerequisites
-------------

[](#prerequisites)

Prior to installation, please make sure you've installed [Google Cloud PHP Autoloader](https://github.com/auroraextensions/googlecloudphpautoloader). This extension depends on the autoloader to load the essential [Google Cloud PHP](https://github.com/googleapis/google-cloud-php) libraries.

**IMPORTANT**: Please back up your media files prior to installation. Files lost to accidental deletion cannot be recovered.

Documentation
-------------

[](#documentation)

See [here](https://docs.auroraextensions.com/magento/extensions/1.x/magegcs/latest/) for documentation.

Features
--------

[](#features)

There are several advantages to cloud-based storage solutions like Google Cloud Storage, including:

- Integration with [Google Cloud CDN](https://cloud.google.com/cdn/)
- External backups
- Reduced storage costs

FAQs
----

[](#faqs)

> Do I have to use a service account key for authentication? Or can I use a different method?

Currently, only service account keys are supported for authentication.

> Does the extension provide a CLI?

No, it does not. However, you can perform bucket operations via `gsutil`.

> Are log files synchronized to the bucket?

No, only media files are synchronized.

> Can I synchronize downloadable product files to the bucket?

Yes, it can synchronize both sample and link files.

Troubleshooting
---------------

[](#troubleshooting)

> Fatal error: Uncaught Error: Class 'Google\\Cloud\\Storage\\StorageClient' not found

You need to install and configure [Google Cloud PHP Autoloader](https://github.com/auroraextensions/googlecloudphpautoloader).

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

You need to create and install a service account key to authenticate with Google Cloud. Verify you've completed the following:

1. Generate a Google Cloud service account key with *Storage Admin* privileges
2. Install service account key to local or mounted filesystem with read-only permissions for Magento user
3. Under `System > Configuration > Nickolas Burr Extensions > Google Cloud Storage`, make sure:
    1. The extension is enabled
    2. The Google Cloud project name where the bucket exists is set
    3. The path to the service account key (e.g. `/etc/gcs.json`) is set
    4. The Google Cloud Storage bucket name (e.g. `mybucket`) is set
    5. \[OPTIONAL\] If you use the same bucket for multiple projects, you can specify a subdirectory to synchronize to inside the bucket. Otherwise, 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).

Credits
-------

[](#credits)

Several key parts of this extension are derived from the [magento-s3](https://github.com/thaiphan/magento-s3) extension.

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/e186fc7828ee90af297839392dc98740ca74f302d7f462afd0ffe8c1d5841ace?d=identicon)[nickolasburr](/maintainers/nickolasburr)

---

Top Contributors

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

---

Tags

google-cloud-storagemagento

### Embed Badge

![Health badge](/badges/nickolasburr-magegcs/health.svg)

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

###  Alternatives

[knplabs/gaufrette

PHP library that provides a filesystem abstraction layer

2.5k39.8M123](/packages/knplabs-gaufrette)[google/cloud-storage

Cloud Storage Client for PHP

34390.8M125](/packages/google-cloud-storage)[illuminate/filesystem

The Illuminate Filesystem package.

15261.6M2.6k](/packages/illuminate-filesystem)[superbalist/flysystem-google-storage

Flysystem adapter for Google Cloud Storage

26320.6M30](/packages/superbalist-flysystem-google-storage)[creocoder/yii2-flysystem

The flysystem extension for the Yii framework

2931.7M62](/packages/creocoder-yii2-flysystem)[flowjs/flow-php-server

PHP library for handling chunk uploads. Works with flow.js html5 file uploads.

2451.6M15](/packages/flowjs-flow-php-server)

PHPackages © 2026

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