Laravel Google Cloud Storage

A Google Cloud Storage filesystem for Laravel
Alternatives To Laravel Google Cloud Storage
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Laravel Medialibrary5,33742819112 hours ago387September 21, 202220mitPHP
Associate files with Eloquent models
2 months ago67June 07, 202253apache-2.0Shell
DreamFactory API Management Platform
Aliyun Oss Storage48726112 years ago8April 02, 201856mitPHP
阿里云OSS laravel storage Filesystem adapter, 打造Laravel最好的OSS Storage扩展.
Laravel Google Cloud Storage4853316a year ago15September 22, 202039mitPHP
A Google Cloud Storage filesystem for Laravel
Laravel Filesystem Qiniu46471143 months ago10February 17, 20221PHP
A Qiniu Storage filesystem for Laravel
Laravel Ueditor39266124 years ago13December 22, 20181JavaScript
UEditor integration for Laravel.
2 months ago42September 20, 20227mitPHP
🐎 Lasso is a Laravel package created to make your deployments blazing fast.
Laravel Filesystem Oss30635a year ago9April 20, 2022PHP
:floppy_disk: Oss storage filesystem for Laravel.
Flysystem Qiniu2176214a month ago18October 21, 2022PHP
:floppy_disk: Flysystem adapter for the Qiniu storage.
85 years ago22April 09, 20164mitPHP
Google App Engine Support package for Laravel 5
Alternatives To Laravel Google Cloud Storage
Select To Compare

Alternative Project Comparisons


A Google Cloud Storage filesystem for Laravel.

Author Build Status Software License Packagist Version Total Downloads

This package is a wrapper bridging flysystem-google-storage into Laravel as an available storage disk.


composer require superbalist/laravel-google-cloud-storage

If you are on Laravel 5.4 or earlier, then register the service provider in app.php

'providers' => [
    // ...

If you are on Laravel 5.5 or higher, composer will have registered the provider automatically for you.

Add a new disk to your filesystems.php config

'gcs' => [
    'driver' => 'gcs',
    'project_id' => env('GOOGLE_CLOUD_PROJECT_ID', 'your-project-id'),
    'key_file' => env('GOOGLE_CLOUD_KEY_FILE', null), // optional: /path/to/service-account.json
    'bucket' => env('GOOGLE_CLOUD_STORAGE_BUCKET', 'your-bucket'),
    'path_prefix' => env('GOOGLE_CLOUD_STORAGE_PATH_PREFIX', null), // optional: /default/path/to/apply/in/bucket
    'storage_api_uri' => env('GOOGLE_CLOUD_STORAGE_API_URI', null), // see: Public URLs below
    'visibility' => 'public', // optional: public|private


The Google Client uses a few methods to determine how it should authenticate with the Google API.

  1. If you specify a path in the key key_file in disk config, that json credentials file will be used.

  2. If the GOOGLE_APPLICATION_CREDENTIALS env var is set, it will use that.

  3. It will then try load the key file from a 'well known path':

    • windows: %APPDATA%/gcloud/application_default_credentials.json
    • others: $HOME/.config/gcloud/application_default_credentials.json
  4. If running in Google App Engine, the built-in service account associated with the application will be used.

  5. If running in Google Compute Engine, the built-in service account associated with the virtual machine instance will be used.

  6. If you want to authenticate directly without using a json file, you can specify an array for key_file in disk config with this data:

    'key_file' => [
        'type' => env('GOOGLE_CLOUD_ACCOUNT_TYPE'),
        'private_key_id' => env('GOOGLE_CLOUD_PRIVATE_KEY_ID'),
        'private_key' => env('GOOGLE_CLOUD_PRIVATE_KEY'),
        'client_email' => env('GOOGLE_CLOUD_CLIENT_EMAIL'),
        'client_id' => env('GOOGLE_CLOUD_CLIENT_ID'),
        'auth_uri' => env('GOOGLE_CLOUD_AUTH_URI'),
        'token_uri' => env('GOOGLE_CLOUD_TOKEN_URI'),
        'auth_provider_x509_cert_url' => env('GOOGLE_CLOUD_AUTH_PROVIDER_CERT_URL'),
        'client_x509_cert_url' => env('GOOGLE_CLOUD_CLIENT_CERT_URL'),

Public URLs

The adapter implements a getUrl($path) method which returns a public url to a file.

Note: Method available for Laravel 5.2 and higher. If used on 5.1, it will throw an exception.

$disk = Storage::disk('gcs');
$url = $disk->url('folder/my_file.txt');

If you configure a path_prefix in your config:

$disk = Storage::disk('gcs');
$url = $disk->url('folder/my_file.txt');

If you configure a custom storage_api_uri in your config:

$disk = Storage::disk('gcs');
$url = $disk->url('folder/my_file.txt');

For a custom domain (storage api uri), you will need to configure a CNAME DNS entry pointing to

Please see for further instructions.


$disk = Storage::disk('gcs');

// create a file
$disk->put('avatars/1', $fileContents);

// check if a file exists
$exists = $disk->exists('file.jpg');

// get file modification date
$time = $disk->lastModified('file1.jpg');

// copy a file
$disk->copy('old/file1.jpg', 'new/file1.jpg');

// move a file
$disk->move('old/file1.jpg', 'new/file1.jpg');

// get url to file
$url = $disk->url('folder/my_file.txt');

// Set the visibility of file to public
$disk->setVisibility('folder/my_file.txt', 'public');

// See for full list of available functionality
Popular Laravel Projects
Popular Filesystem Projects
Popular Frameworks Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Cloud Computing
Google Cloud Platform
Google Cloud Storage
Google Storage
Flysystem Adapter