PHPackages                             aedart/athenaeum-etags - 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. [HTTP & Networking](/categories/http)
4. /
5. aedart/athenaeum-etags

ActiveLibrary[HTTP & Networking](/categories/http)

aedart/athenaeum-etags
======================

ETags utilities and Http Conditional Request evaluation for your Laravel Application

10.11.0(4d ago)01.7k↓46.7%1BSD-3-ClausePHPPHP ^8.4

Since Nov 28Pushed 4d ago1 watchersCompare

[ Source](https://github.com/aedart/athenaeum-etags)[ Packagist](https://packagist.org/packages/aedart/athenaeum-etags)[ Docs](https://aedart.github.io/athenaeum/)[ RSS](/packages/aedart-athenaeum-etags/feed)WikiDiscussions main Synced 2d ago

READMEChangelogDependencies (36)Versions (113)Used By (1)

Athenaeum ETags
===============

[](#athenaeum-etags)

This package provides a "profile" based approach to generate [ETags](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/ETag), and an evaluator to deal with [Http Conditional Requests](https://developer.mozilla.org/en-US/docs/Web/HTTP/Conditional_requests), for your Laravel application.

ETags Examples
--------------

[](#etags-examples)

### Generate

[](#generate)

```
use Aedart\ETags\Facades\Generator;

// Generate an ETag for strong comparison, of content
$etag = Generator::makeStrong($content);

echo (string) $etag; // "4720b076892bb2fb65e75af902273c73a2967e4a"
```

Or to generate ETags that are flagged as "weak" (*for weak comparison*)

```
$etag = Generator::makeWeak($content);

echo (string) $etag; // W/"0815"
```

### Parsing

[](#parsing)

To parse ETags from Http headers, you can use the `parse()` method. It returns a collection of `ETag` instances.

```
// E.g. If-None-Match: W/"0815", W/"0816", W/"0817"
$collection = Generator::parse($request->header('If-None-Match'));

foreach ($collection as $etag) {
    echo (string) $etag;
}
```

### Compare

[](#compare)

ETags can also be matched against each other, in accordance with [RFC9110](https://httpwg.org/specs/rfc9110.html#rfc.section.8.8.3.2).

#### Using Collection

[](#using-collection)

```
// Etags from Http Header
$collection = Generator::parse($request->header('If-Match')); // E.g. 'W/"0815"'

// Other Etag for your resource
$etag = Generator::makeWeak($content); // E.g. W/"0815"

// Compare etags against resource's etag
echo $collection->contains($etag, true); // false - strong comparison
echo $collection->contains($etag);       // true - weak comparison
```

#### Using Etag instance

[](#using-etag-instance)

You can also compare individual `ETag` instances, using the `matches()` method.

```
$etagA = Generator::parseSingle('W/"0815"');
$etagB = Generator::parseSingle('W/"0815"');

echo $etagA->matches($etagB, true); // false - strong comparison
echo $etagA->matches($etagB);       // true - weak comparison
```

Evaluate Http Preconditions Examples
------------------------------------

[](#evaluate-http-preconditions-examples)

The `Evaluator` component is able to process the incoming request against all the defined [RFC9110 preconditions](https://httpwg.org/specs/rfc9110.html#preconditions), in accordance with specified [evaluation precedence](https://httpwg.org/specs/rfc9110.html#precedence). Depending on the precondition requested, if it passes or fails, the request can either proceed or it will be aborted using customisable Http Exceptions. Your Laravel application should do the rest, whenever the request is aborted.

```
use Aedart\ETags\Preconditions\Evaluator;
use Aedart\ETags\Preconditions\Resources\GenericResource;

// Process If-Match, If-None-Match, If-Modified-Since... etc
// Depending on condition's pass/fail, the request can be aborted via
// an appropriate Http Exception, or proceed to your logic...
$resource = Evaluator::make($request)
    ->evaluate(new GenericResource(
        data: $model,
        etag: $model->getStrongEtag(),
        lastModifiedDate: $model->updated_at
    ));
```

To summarise, the following preconditions are supported:

- [If-Match](https://httpwg.org/specs/rfc9110.html#field.if-match)
- [If-None-Match](https://httpwg.org/specs/rfc9110.html#field.if-none-match)
- [If-Modified-Since](https://httpwg.org/specs/rfc9110.html#field.if-modified-since)
- [If-Unmodified-Since](https://httpwg.org/specs/rfc9110.html#field.if-unmodified-since)
- [If-Range](https://httpwg.org/specs/rfc9110.html#field.if-range)

The `Evaluator` also supports adding your own custom preconditions to be evaluated, should you need such.

Official Documentation
----------------------

[](#official-documentation)

Please read the [official documentation](https://aedart.github.io/athenaeum/) for additional information.

The mono repository is located at [github.com/aedart/athenaeum](https://github.com/aedart/athenaeum)

Versioning
----------

[](#versioning)

This package follows [Semantic Versioning 2.0.0](http://semver.org/)

License
-------

[](#license)

[BSD-3-Clause](http://spdx.org/licenses/BSD-3-Clause), Read the LICENSE file included in this package

###  Health Score

56

—

FairBetter than 97% of packages

Maintenance99

Actively maintained with recent releases

Popularity18

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity81

Battle-tested with a long release history

 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.

###  Release Activity

Cadence

Every ~11 days

Total

112

Last Release

4d ago

Major Versions

6.8.1 → 7.0.02023-02-16

7.33.0 → 8.0.02024-03-18

8.22.0 → 9.0.02025-03-04

9.25.1 → 10.0.02026-03-30

PHP version history (6 changes)6.6.0PHP ^8.0.2

7.0.0PHP ^8.1

7.21.0PHP ^8.1.22

8.0.0PHP ^8.2

9.0.0PHP ^8.3

10.0.0PHP ^8.4

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1523223?v=4)[Alin Eugen Deac](/maintainers/aedart)[@aedart](https://github.com/aedart)

---

Top Contributors

[![aedart](https://avatars.githubusercontent.com/u/1523223?v=4)](https://github.com/aedart "aedart (234 commits)")

---

Tags

generatorEtagAthenaeumEntity TagHTTP conditional requests

### Embed Badge

![Health badge](/badges/aedart-athenaeum-etags/health.svg)

```
[![Health](https://phpackages.com/badges/aedart-athenaeum-etags/health.svg)](https://phpackages.com/packages/aedart-athenaeum-etags)
```

###  Alternatives

[api-platform/laravel

API Platform support for Laravel

58171.6k14](/packages/api-platform-laravel)

PHPackages © 2026

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