Weave Code
Cloud Storage Laravel Package
google/cloud-storage
Google Cloud Storage for PHP is an idiomatic client for uploading, downloading, and managing objects and buckets, with ACL support, a gs:// stream wrapper, and simple Composer installation.
At a glance
Frequently asked questions about Cloud Storage
- How do I install google/cloud-storage in a Laravel app?
- Install it with Composer by running composer require google/cloud-storage. It is a framework-agnostic PHP package, so Laravel does not need a dedicated service provider. You can bind Google\Cloud\Storage\StorageClient in Laravel's service container or resolve it through a facade for cleaner dependency injection.
- How do I authenticate google/cloud-storage in Laravel?
- Authenticate with a Google Cloud service account JSON key or Application Default Credentials. In Laravel, keep the credential path in config/services.php and read it from env() rather than committing keys to version control. Grant the service account only the IAM roles it needs for the buckets and objects it manages.
- Can I use google/cloud-storage as a Laravel filesystem disk?
- Not out of the box, because google/cloud-storage is the low-level Google Cloud PHP client rather than a Laravel filesystem adapter. You can plug it into Laravel's Filesystem contract through a custom adapter, often via Flysystem, to get a unified Storage facade idiom across local and cloud disks. Many teams wrap it behind their own adapter to keep GCS-specific logic isolated.
- Does google/cloud-storage support Laravel 8, 9, 10, 11, and PHP 8.1 through 8.4?
- The assessment context previously stated PHP 8.1 through 8.4 and Laravel 8+, but those claims were tied to google/cloud-storage v1.51.0. The current release is v2.5.5, so you must re-validate the support matrix against the 2.x composer.json constraints and upgrade guide. Do not rely on the older Laravel or PHP version claims until that check is complete.
- What changed between google/cloud-storage 1.x and 2.x?
- The package crossed a major version boundary from 1.x to 2.x, which conventionally signals possible breaking changes. The published notes for v2.5.5 are chore-only and do not reveal compatibility details, so they cannot be used to infer what changed. Diff the 1.x to 2.x changelog, look for an UPGRADING.md or upgrade guide, and check class signatures, config keys, and minimum PHP constraints before upgrading.
- How do I use the gs:// stream wrapper with Laravel?
- Call registerStreamWrapper() on your StorageClient instance, then use native PHP file functions such as file_get_contents('gs://bucket/file.txt'). Register the wrapper early, for example in a Laravel service provider, so controllers and services can use gs:// paths transparently. Make sure the same authenticated client and credentials are available wherever the wrapper is used.
- How do I generate signed URLs for private Google Cloud Storage files in Laravel?
- Use the Google Cloud Storage client's signed URL support on the object or blob, setting an expiration appropriate for your download flow. Signed URLs compose cleanly with Laravel auth middleware and policies, so you can authorize a user before issuing the URL. The signing credentials need permission to sign, such as a service account private key or IAM signBlob access.
- Is google/cloud-storage suitable for high-throughput uploads like 1000+ files per hour?
- The client wraps Google's REST API and can support high-throughput workloads, but you should validate your specific pattern with resumable uploads for files above 5MB. Use retry and backoff options to handle transient failures and monitor GCS quotas and throttling. Client instantiation can add roughly 100 to 300ms on first use, so bind it as a singleton or cache the client instance in Laravel.
- How do I control Google Cloud Storage costs and lifecycle rules in Laravel?
- StandardStorage costs about $0.02 per GB-month and can escalate with frequent small uploads or no lifecycle rules. Configure bucket lifecycle transitions to Nearline or Coldline for colder data and set billing alerts. Manage lifecycle rules in Google Cloud Storage itself rather than trying to implement them only in Laravel application code.
- Can Google Cloud Storage events trigger Laravel queues?
- Yes. Cloud Storage events such as OBJECT_FINALIZE can feed Pub/Sub and dispatch Laravel jobs for post-processing like image optimisation or metadata indexing. This supports event-driven and serverless architectures, including Cloud Run deployments. Make your listeners idempotent and use retries because event delivery can be repeated.
Weaver
How can I help you explore Laravel packages today?