---
title: "Retries, caching & rate limits — Git for Laravel | Roundly"
description: "Read retries with backoff, ETag conditional caching, client-side pacing with adaptive back-off, rate-limit status and safe request logging."
url: https://roundly-consulting.com/open-source/docs/git-for-laravel/resilience
language: en
---

[All packages](https://roundly-consulting.com/open-source.md)

[Git for Laravel](https://roundly-consulting.com/open-source/docs/git-for-laravel.md)

# Retries, caching & rate limits

## Retries

Reads (GET) retry a dropped connection, a 429 or a 5xx with backoff (retry.times attempts). A 4xx is never retried, and a write is never retried at all — a 5xx on a write may already have landed.

## Client-side rate limiting

Every request goes through the http-client-rate-limits-for-laravel limiter. By default requests are paced — when a provider’s window is exhausted the call waits until it frees up rather than failing. With adaptive on (the default) the limiter also reads each provider’s own Retry-After / X-RateLimit-\* headers and backs off exactly as the server asks. Set max\_wait to fail fast instead:

```bash
GITHUB_RATELIMIT_MAX_WAIT=2000   # fail fast when a defer would exceed 2 s
GITHUB_RATELIMIT_JITTER=250      # spread retries by up to 250 ms
GITHUB_RATELIMIT_ENABLED=false   # or turn the client-side limiter off entirely
```

A defer that would exceed max\_wait throws RateLimitExceededException, which carries the wait as a retry hint through the toolkit’s HasRetryAfter contract:

```php
use RoundlyConsulting\Git\Exceptions\RateLimitExceededException;
use RoundlyConsulting\PackageToolkit\Contracts\HasRetryAfter;

try {
    Git::github()->repositories();
} catch (RateLimitExceededException $e) {
    $e->retryAfterSeconds();   // the wait the limiter would have needed
}

// In your exception handler — works for any throttled Roundly package:
if ($e instanceof HasRetryAfter) {
    return response('Too Many Requests', 429, ['Retry-After' => $e->retryAfterSeconds()]);
}
```

The limiter defaults to an in-memory store — per process, fine for CLI and single-worker use. For a quota shared across workers or servers, point http-client-rate-limits.store at a cache, Redis or database store (HTTP\_CLIENT\_RATE\_LIMITS\_STORE); git does not force a store.

Each credential keeps its own budget: the limiter key is git:<provider>:<owner>:<digest>, a digest of the token, OAuth grant or GitHub App installation — never the secret itself — or anon without a credential. The forges count quota per token or installation, so one installation’s exhausted quota, and the adaptive Retry-After penalty that comes with it, never stalls another; the scoped mints of one installation share its budget, as GitHub counts them.

## Server-reported status

The last response’s server-reported rate limit is exposed on the provider:

```php
$status = Git::github()->rateLimit(); // ?RateLimitStatus { limit, remaining, used, resetAt }

$status?->remaining;
$status?->resetAt;             // ?Carbon
```

## Conditional caching and logging

With cache.enabled, ETags are stored and replayed via If-None-Match, and 304 responses are served from cache. Cache entries are keyed per credential, so two accounts never share one. Logging writes method, URL, status and duration at debug level, and never tokens or bodies:

```bash
GIT_CACHE_ENABLED=true
GIT_CACHE_STORE=redis
GIT_CACHE_TTL=3600
GIT_LOGGING_ENABLED=true
GIT_LOGGING_CHANNEL=stack
```

## Show your open-source love

This package is free and MIT-licensed. If it saves you time, a one-off donation or a Patreon membership keeps it maintained, tested and documented.

[More ways to support, including crypto](https://roundly-consulting.com/support-us.md)

By donating, you agree to our [donation terms](https://roundly-consulting.com/donation-terms.md).

[Support our open source work (opens in a new tab)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Join us on Patreon (opens in a new tab)](https://www.patreon.com/cw/roundly)

## Want this built into your product?

We integrate our packages into custom Laravel and AI builds. Tell us what you're working on and we'll reply within 48 hours.

[Get a quote in 48 hours](https://roundly-consulting.com/contact.md) [Browse all packages](https://roundly-consulting.com/open-source/docs/git-for-laravel.md)