PHPackages spatie/flysystem-google-cloud-storage - 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 & Storage](/categories/file-storage) 4. / 5. spatie/flysystem-google-cloud-storage ActiveLibrary[File & Storage](/categories/file-storage) spatie/flysystem-google-cloud-storage ===================================== Flysystem adapter for Google Cloud Storage 1.1.2(2y ago)24618.3k—5.5%2MITPHPPHP ^8.0CI passing Since Jul 27Pushed 1mo ago3 watchersCompare [ Source](https://github.com/spatie/flysystem-google-cloud-storage)[ Packagist](https://packagist.org/packages/spatie/flysystem-google-cloud-storage)[ Docs](https://github.com/spatie/flysystem-google-cloud-storage)[ GitHub Sponsors](https://github.com/spatie)[ RSS](/packages/spatie-flysystem-google-cloud-storage/feed)WikiDiscussions main Synced 3d ago READMEChangelog (7)Dependencies (7)Versions (8)Used By (0) Flysystem adapter for Google Cloud Storage ========================================== [](#flysystem-adapter-for-google-cloud-storage) [![Latest Version on Packagist](https://camo.githubusercontent.com/526cb6dc2bd5b878c4ef76c1df9d1e6d6aecb7f9bba2c64f8dbd76fad68f6e20/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7370617469652f666c7973797374656d2d676f6f676c652d636c6f75642d73746f726167652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/spatie/flysystem-google-cloud-storage)[![GitHub Tests Action Status](https://github.com/spatie/flysystem-google-cloud-storage/actions/workflows/run-tests.yml/badge.svg)](https://github.com/spatie/flysystem-google-cloud-storage/actions?query=workflow%3ATests+branch%3Amain)[![GitHub Code Style Action Status](https://github.com/spatie/flysystem-google-cloud-storage/actions/workflows/php-cs-fixer.yml/badge.svg)](https://github.com/spatie/flysystem-google-cloud-storage/actions?query=workflow%3A%22Check+%26+fix+styling%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/37fb5df1ac06792b32dbc8bde752128204b302d64ac1d3fe4f9713d1c39927f4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7370617469652f666c7973797374656d2d676f6f676c652d636c6f75642d73746f726167652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/spatie/flysystem-google-cloud-storage) This package contains a [Google Cloud Storage](https://cloud.google.com/storage) driver for [Flysystem v1](https://flysystem.thephpleague.com). (If you need Google Cloud Storage support on Flysystem v2 or above (or Laravel 9), this package is not for you) ### Notice [](#notice) This package is a fork from [superbalist/flysystem-google-cloud-storage](https://github.com/Superbalist/flysystem-google-cloud-storage). Changes include: - PHP 8 only - merged random open PRs from Superbalist's package Support us ---------- [](#support-us) [![](https://camo.githubusercontent.com/fbdcc6fae6bf702e83677bf49057f8be90b883a6c8a730e3c4dcda18b60565c1/68747470733a2f2f6769746875622d6164732e73332e65752d63656e7472616c2d312e616d617a6f6e6177732e636f6d2f666c7973797374656d2d676f6f676c652d636c6f75642d73746f726167652e6a70673f743d31)](https://spatie.be/github-ad-click/flysystem-google-cloud-storage) We invest a lot of resources into creating [best in class open source packages](https://spatie.be/open-source). You can support us by [buying one of our paid products](https://spatie.be/open-source/support-us). We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on [our contact page](https://spatie.be/about-us). We publish all received postcards on [our virtual postcard wall](https://spatie.be/open-source/postcards). Installation ------------ [](#installation) You can install the package via composer: ``` composer require spatie/flysystem-google-cloud-storage ``` Authentication -------------- [](#authentication) Before you can use the package, you'll need to authenticate with Google. When possible, the credentials will be auto-loaded by the Google Cloud Client. 1. The client will first look at the GOOGLE\_APPLICATION\_CREDENTIALS env var. You can use `putenv('GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json');` to set the location of your credentials file. 2. The client will look for the credentials file at the following paths: - Windows: `%APPDATA%/gcloud/application_default_credentials.json` - MacOS/Unix: `$HOME/.config/gcloud/application_default_credentials.json` 3. If running in Google App Engine, Google Compute Engine or GKE, the built-in service account associated with the app, instance or cluster will be used. Using this in a Kubernetes cluster? Take a look at [Workload Identity](https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity). Usage ----- [](#usage) Here's an example that shows you have you can call the various functions to manipulate files on Google Cloud. ``` use Google\Cloud\Storage\StorageClient; use League\Flysystem\Filesystem; use Spatie\GoogleCloudStorageAdapter\GoogleCloudStorageAdapter; $storageClient = new StorageClient([ 'projectId' => 'your-project-id', // The credentials can manually be specified by passing in a keyFilePath. // 'keyFilePath' => '/path/to/service-account.json', ]); $bucket = $storageClient->bucket('your-bucket-name'); $adapter = new GoogleCloudStorageAdapter($storageClient, $bucket); $filesystem = new Filesystem($adapter); $filesystem->write('path/to/file.txt', 'contents'); $filesystem->update('path/to/file.txt', 'new contents'); $contents = $filesystem->read('path/to/file.txt'); $exists = $filesystem->has('path/to/file.txt'); $filesystem->delete('path/to/file.txt'); $filesystem->rename('filename.txt', 'newname.txt'); $filesystem->copy('filename.txt', 'duplicate.txt'); $filesystem->deleteDir('path/to/directory'); ``` See for full list of available functionality ### Using a custom storage URI [](#using-a-custom-storage-uri) You can configure this adapter to use a custom storage URI. Read more about configuring a custom domain for Google Cloud Storage [here](https://cloud.google.com/storage/docs/request-endpoints#cname). When using a custom storage URI, the bucket name will not prepended to the file path: ``` use Google\Cloud\Storage\StorageClient; use League\Flysystem\Filesystem; use Spatie\GoogleCloudStorageAdapter\GoogleCloudStorageAdapter; $storageClient = new StorageClient([ 'projectId' => 'your-project-id', ]); $bucket = $storageClient->bucket('your-bucket-name'); $adapter = new GoogleCloudStorageAdapter($storageClient, $bucket); // URI defaults to "https://storage.googleapis.com": $filesystem = new Filesystem($adapter); $filesystem->getUrl('path/to/file.txt'); // "https://storage.googleapis.com/your-bucket-name/path/to/file.txt" // Using custom storage uri: $adapter->setStorageApiUri('http://example.com'); $filesystem = new Filesystem($adapter); $filesystem->getUrl('path/to/file.txt'); // "http://example.com/path/to/file.txt" // You can also prefix the file path if needed: $adapter->setStorageApiUri('http://example.com'); $adapter->setPathPrefix('extra-folder/another-folder/'); $filesystem = new Filesystem($adapter); $filesystem->getUrl('path/to/file.txt'); // "http://example.com/extra-folder/another-folder/path/to/file.txt" ``` Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](https://github.com/spatie/.github/blob/main/CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](../../security/policy) on how to report security vulnerabilities. Credits ------- [](#credits) - [Alex Vanderbist](https://github.com/alexvanderbist) - [All Contributors](../../contributors) - [Superbalist](https://github.com/Superbalist) for the initial package License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 50 — FairBetter than 95% of packages Maintenance61 Regular maintenance activity Popularity47 Moderate usage in the ecosystem Community14 Small or concentrated contributor base Maturity61 Established project with proven stability Bus Factor1 Top contributor holds 64.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 ~120 days Recently: every ~180 days Total 7 Last Release 1079d ago Major Versions 0.0.3 → 1.0.02022-02-09 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/7535935?v=4)[Spatie](/maintainers/spatie)[@spatie](https://github.com/spatie) --- Top Contributors [![AlexVanderbist](https://avatars.githubusercontent.com/u/6287961?v=4)](https://github.com/AlexVanderbist "AlexVanderbist (24 commits)")[![freekmurze](https://avatars.githubusercontent.com/u/483853?v=4)](https://github.com/freekmurze "freekmurze (7 commits)")[![AdrianMrn](https://avatars.githubusercontent.com/u/12762044?v=4)](https://github.com/AdrianMrn "AdrianMrn (5 commits)")[![alexandrmazur96](https://avatars.githubusercontent.com/u/20535375?v=4)](https://github.com/alexandrmazur96 "alexandrmazur96 (1 commits)") --- Tags flysystemgoogle-cloudphpspatieflysystem-google-cloud-storage ### Code Quality TestsPHPUnit Static AnalysisPsalm Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/spatie-flysystem-google-cloud-storage/health.svg) ``` [![Health](https://phpackages.com/badges/spatie-flysystem-google-cloud-storage/health.svg)](https://phpackages.com/packages/spatie-flysystem-google-cloud-storage) ``` ### Alternatives [league/flysystem-aws-s3-v3 AWS S3 filesystem adapter for Flysystem. 1.7k285.7M1.0k](/packages/league-flysystem-aws-s3-v3)[unisharp/laravel-filemanager A file upload/editor intended for use with Laravel 5 to 10 and CKEditor / TinyMCE 2.2k3.5M85](/packages/unisharp-laravel-filemanager)[spatie/laravel-backup A Laravel package to backup your application 6.0k24.4M244](/packages/spatie-laravel-backup)[tempest/framework The PHP framework that gets out of your way. 2.2k34.4k15](/packages/tempest-framework)[spatie/flysystem-dropbox Flysystem Adapter for the Dropbox v2 API 3735.0M83](/packages/spatie-flysystem-dropbox)[spatie/laravel-db-snapshots Quickly dump and load databases 1.2k3.1M25](/packages/spatie-laravel-db-snapshots) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)