initial release commit

Author: kamarton

.github/workflows/phpunit.yml

@@ -0,0 +1,30 @@
+name: Run PHPUnit Tests
+
+on:
+  push:
+    paths-ignore:
+      - 'README.md'
+
+jobs:
+  phpunit:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        php-version: [ 8.2, 8.3, 8.4 ]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php-version }}
+          coverage: none
+
+      - name: Install dependencies
+        run: composer install --no-progress --no-suggest --prefer-dist
+
+      - name: Run PHPUnit tests/*
+        run: vendor/bin/phpunit tests/*

.gitignore

@@ -0,0 +1,3 @@
+.idea
+vendor
+composer.phar

README.md

@@ -0,0 +1,74 @@
+# HTTP Cache - `smartondev/httpcache`
+
+**This code is under development and not ready for production use.**
+
+## Installation
+
+```bash
+composer require smartondev/httpcache
+```
+
+## Usage
+
+```php
+use Smartondev\HttpCache\CacheHeaderBuilder;
+use Smartondev\HttpCache\ETagHeaderBuilder;
+use Smartondev\HttpCache\ETagMatcher;
+use SmartonDev\HttpCache\ModifiedMatcher;
+
+// max-age 30 day, private, no-store
+$headers = (new CacheHeaderBuilder())
+    ->withMaxAge(hours: 30)
+    ->withPrivate()
+    ->withNoStore()
+    ->toHeaders();
+
+// max-age 60 sec, shared max age 120 sec, stale-while-revalidate 30 sec
+$headers = (new CacheHeaderBuilder())
+    ->withMaxAge(60)
+    ->withSharedMaxAge(120)
+    ->withStaleWhileRevalidate(30)
+    ->toHeaders();
+
+// etag
+$etagMatcher = (new ETagMatcher())
+    ->withHeaders($requestHeaders);
+$etagHeaderBuilder = (new ETagHeaderBuilder())
+    ->withComputedEtag()
+if($etagMatcher->matches($etag)->matches()) {
+    // 304 Not Modified
+    return response(null, 304);
+}
+
+// modified since
+$modifiedMatcher = (new ModifiedMatcher())
+    ->withHeaders($requestHeaders);
+if($modifiedMatcher->matches($lastModified)->isBeforeModifiedSince()) {
+    // 304 Not Modified
+    return response(null, 304);
+}
+```
+
+...
+
+### Durations
+
+```php
+$headers = (new CacheHeaderBuilder())
+    ->withMaxAge(30) // 30 sec
+    ->withMaxAge(seconds: 30) // 30 sec
+    ->withMaxAge(minutes: 30) // 30 min
+    ->withMaxAge(hours: 30) // 30 hours
+    ->withMaxAge(days: 30) // 30 days
+    ->withMaxAge(weeks: 30) // 30 weeks
+    ->withMaxAge(months: 30) // 30 months
+    ->withMaxAge(years: 30) // 30 years
+    ->withMaxAge(days: 10, hours: 5, minutes: 30) // 10 days 5 hours 30 minutes
+    ->toHeaders();
+```
+
+...
+
+## Author
+
+- [Márton Somogyi](https://github.com/kamarton)

composer.json

@@ -0,0 +1,31 @@
+{
+  "name": "smartondev/httpcache",
+  "description": "Simple HTTP cache management library",
+  "type": "library",
+  "license": "Apache-2.0",
+  "authors": [
+    {
+      "name": "Márton Somogyi",
+      "email": "kamarton@gmail.com"
+    }
+  ],
+  "require": {
+    "php": "^8.2"
+  },
+  "require-dev": {
+    "phpunit/phpunit": "^11.0"
+  },
+  "autoload": {
+    "psr-4": {
+      "SmartonDev\\HttpCache\\": "src/"
+    },
+    "files": [
+        "src/helpers.php"
+    ]
+  },
+  "autoload-dev": {
+    "psr-4": {
+      "SmartonDev\\HttpCache\\Tests\\": "tests/"
+    }
+  }
+}