chore(merge): merge pull request #1 from openapi/dev

Update PHP version & shrink codebase

Author: francescobianco

.github/pull_request_template.md

@@ -0,0 +1,48 @@
+## 📋 Description
+
+Brief description of the changes made in this PR.
+
+## ✨ Type of Change
+
+- [ ] 🐛 Bug fix (fixes an issue)
+- [ ] ✨ New feature (adds functionality)
+- [ ] 🔧 Refactoring (code restructuring without functional changes)
+- [ ] 📚 Documentation (updates to documentation)
+- [ ] 🧪 Tests (adding or modifying tests)
+- [ ] 🔒 Security (security-related fixes)
+- [ ] ⚡ Performance (performance improvements)
+- [ ] 🎨 Style (formatting changes, no logic changes)
+
+## 🔍 Main Changes
+
+- 
+- 
+- 
+
+## 🧪 Testing
+
+- [ ] I have tested the changes locally
+- [ ] I have added/updated unit tests
+- [ ] All tests pass (`./vendor/bin/phpunit`)
+- [ ] I have verified PHP 8.0+ compatibility
+
+## 📝 Additional Notes
+
+Any additional information, considerations, or important context for reviewers.
+
+## 🔗 Related Issue
+
+Closes #[issue_number] (if applicable)
+
+## 📸 Screenshots (if applicable)
+
+If changes affect the interface or visible behavior, include screenshots.
+
+## ✅ Checklist
+
+- [ ] My code follows the project conventions
+- [ ] I have performed a self-review of my code
+- [ ] I have commented complex code where necessary
+- [ ] Documentation has been updated (if needed)
+- [ ] I have not introduced breaking changes (or documented them)
+- [ ] I have verified no sensitive information is in the code

.gitignore

@@ -1,11 +1,13 @@
 .idea/
 .vscode/
+reference/
 /vendor/
 node_modules/
 npm-debug.log
 yarn-error.log
 storage/*.key
 .env
+composer.lock
 Homestead.yaml
 Homestead.json
 /.vagrant

CLAUDE.md

@@ -0,0 +1,84 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Language Policy
+
+**IMPORTANT:** The primary language for this codebase is English. All code, comments, documentation, commit messages, PR descriptions, and communications should be in English.
+
+## Development Commands
+
+### Testing
+```bash
+# Run PHPUnit tests
+./vendor/bin/phpunit tests/
+
+# Run specific test file
+./vendor/bin/phpunit tests/ApiClientTest.php
+
+# Note: Most integration tests are skipped by default as they require valid API tokens
+```
+
+### Dependencies
+```bash
+# Install Composer dependencies
+composer install
+
+# Install dev dependencies
+composer install --dev
+```
+
+### Git Workflow
+```bash
+# Quick development push (defined in Makefile)
+make dev-push
+```
+
+## Architecture Overview
+
+This is a minimal, agnostic PHP SDK for OpenAPI services with only essential HTTP primitives. The architecture follows a clean, simple design inspired by the Rust implementation found in `reference/openapi-rust-sdk/`.
+
+### Core Components
+
+- **`OauthClient`** (`src/OauthClient.php`): Handles OAuth authentication and token management
+  - Uses Basic Auth with username/apikey for authentication 
+  - Supports both production (`oauth.openapi.it`) and test (`test.oauth.openapi.it`) environments
+  - Methods: `getScopes()`, `createToken()`, `getTokens()`, `deleteToken()`, `getCounters()`
+
+- **`Client`** (`src/Client.php`): Agnostic HTTP client for making API calls
+  - Uses Bearer token authentication 
+  - Supports GET, POST, PUT, DELETE, PATCH methods
+  - Handles URL parameter encoding for GET requests
+  - JSON payload encoding for POST/PUT/PATCH requests
+  - 30-second timeout for all requests
+
+- **`Exception`** (`src/Exception.php`): Custom exception handling for HTTP and cURL errors
+
+- **Cache System** (`src/Cache/`): Optional caching interface with array-based implementation
+  - `CacheInterface`: Contract for cache implementations
+  - `ArrayCache`: In-memory cache implementation
+
+### Key Design Principles
+
+1. **Agnostic**: No API-specific classes - works with any OpenAPI service
+2. **Minimal**: Only core HTTP primitives, minimal dependencies (PHP 8.0+, cURL, JSON)
+3. **Clean Interface**: Simple method signatures following REST conventions
+4. **Environment Flexibility**: Built-in test/production environment switching
+
+### Examples Usage Patterns
+
+The `examples/` directory contains practical usage demonstrations:
+- Token generation with OAuth client
+- API calls with different HTTP methods
+- Complete workflow integration
+
+### PSR-4 Autoloading
+
+The project uses PSR-4 autoloading with `OpenApi\` namespace mapped to `src/` directory.
+
+## Requirements
+
+- PHP 8.0+
+- cURL extension
+- JSON extension
+- PHPUnit 9.5+ for testing