pax_global_header00006660000000000000000000000064151453060740014517gustar00rootroot0000000000000052 comment=1b4f3e00a5bdf14b9c2e6bcc5cb879490b2dface php-core-1.4.0/000077500000000000000000000000001514530607400132365ustar00rootroot00000000000000php-core-1.4.0/.gitignore000066400000000000000000000000521514530607400152230ustar00rootroot00000000000000.idea vendor .phpunit.cache/test-results php-core-1.4.0/README.md000066400000000000000000000145071514530607400145240ustar00rootroot00000000000000![SharpAPI GitHub cover](https://sharpapi.com/sharpapi-github-laravel-bg.jpg "SharpAPI Laravel Client") # SharpAPI.com PHP Core functionalities & communication ## 🚀 Automate workflows with AI-powered API ### Leverage AI API to streamline workflows in E-Commerce, Marketing, Content Management, HR Tech, Travel, and more. See more at [SharpAPI.com Website »](https://sharpapi.com/) --- ## Quota Method The `quota()` method returns a `SubscriptionInfo` DTO with the following fields: | Field | Type | Description | |---|---|---| | `timestamp` | `Carbon` | Timestamp of the subscription check | | `on_trial` | `bool` | Whether the account is on a trial period | | `trial_ends` | `Carbon` | End date of the trial period | | `subscribed` | `bool` | Whether the user is currently subscribed | | `current_subscription_start` | `Carbon` | Start of the current subscription period | | `current_subscription_end` | `Carbon` | End of the current subscription period | | `current_subscription_reset` | `Carbon` | Quota reset timestamp | | `subscription_words_quota` | `int` | Total word quota for the period | | `subscription_words_used` | `int` | Words used in the current period | | `subscription_words_used_percentage` | `float` | Percentage of word quota used | | `requests_per_minute` | `int` | Maximum API requests allowed per minute | ```php $client = new SharpApiClient('your-api-key'); $quota = $client->quota(); echo $quota->subscription_words_quota; echo $quota->requests_per_minute; ``` --- ## Two-Layer Rate Limiting Architecture The SDK uses a two-layer approach to keep your requests within API limits: | Layer | Type | How it works | |---|---|---| | **Native Throttling** | Proactive (client-side) | Sliding window rate limiter blocks outgoing requests *before* they hit the server | | **429 Retry & Adaptive Polling** | Reactive (server-side) | Catches HTTP 429 responses, retries with backoff, and slows polling when limits are low | The proactive layer prevents most 429 errors from ever occurring. The reactive layer acts as a safety net for edge cases (clock drift, concurrent processes, plan changes). --- ## Native Throttling Every `SharpApiClient` instance includes an in-memory **sliding window rate limiter** (`SlidingWindowRateLimiter`) that tracks request timestamps in a 60-second rolling window. Before each API call, `waitIfNeeded()` checks the window. If capacity is available the request proceeds immediately; if not, the call sleeps until the oldest timestamp expires out of the window. - **Default limit:** 60 requests/minute (matches most subscription plans) - **Per-process, in-memory** — no external dependencies (Redis, database, etc.) - **Server-adaptive** — when the server returns a higher `X-RateLimit-Limit` header (e.g. after a plan upgrade), the limiter automatically ratchets up to match. It never ratchets *down*, so your configured default is always the floor. - **Metadata bypass** — `ping()` and `quota()` skip throttling to avoid deadlocks when checking connectivity or subscription status. ### Configuration ```php $client = new SharpApiClient('your-api-key'); // Change the throttle limit (default: 60) $client->setRequestsPerMinute(120); // Disable throttling entirely (pass 0) $client->setRequestsPerMinute(0); ``` ### Advanced Throttling Controls You can access the underlying `SlidingWindowRateLimiter` instance directly for fine-grained control: ```php $limiter = $client->getRateLimiter(); // Non-blocking check — returns true if a request can proceed without waiting $limiter->canProceed(); // How many requests are available in the current window $limiter->remaining(); // e.g. 42 ``` **Cross-process state caching** — save and restore the server-reported rate limit state (e.g. between HTTP requests in a web app): ```php // After an API call, cache the server-reported state $state = $client->getRateLimitState(); // $state = ['limit' => 60, 'remaining' => 58] cache()->put('sharpapi_rate_state', $state, 60); // In the next process/request, restore it $client->setRateLimitState(cache()->get('sharpapi_rate_state')); ``` **Quick quota check** — verify the server still reports available capacity before making a request: ```php if ($client->canMakeRequest()) { // Server-reported remaining > 0 (or no server data yet) } ``` --- ## Automatic 429 Retry & Adaptive Polling If a request does hit the server rate limit, the SDK handles it automatically: 1. **Retry automatically** — reads the `Retry-After` header, sleeps for the specified duration, and retries the request (up to 3 times by default). 2. **Slow down polling** — during `fetchResults()`, when `X-RateLimit-Remaining` drops below the low threshold, polling intervals are automatically increased to avoid hitting the limit. ### Inspecting Rate-Limit State After any API call, you can check the current rate-limit values: ```php $client = new SharpApiClient('your-api-key'); $client->ping(); echo $client->getRateLimitLimit(); // e.g. 60 (requests per window) echo $client->getRateLimitRemaining(); // e.g. 58 (remaining in current window) ``` > **Note:** `getRateLimitLimit()` and `getRateLimitRemaining()` return `null` before the first API call or after endpoints that don't return rate-limit headers (e.g. `/ping`, `/quota`). ### Configuration ```php // Max automatic retries on HTTP 429 (default: 3) $client->setMaxRetryOnRateLimit(5); // Threshold below which polling intervals are increased (default: 3) $client->setRateLimitLowThreshold(5); ``` When `rateLimitRemaining` is at or below the threshold, polling intervals in `fetchResults()` are multiplied by an increasing factor (2x at threshold, growing as remaining approaches 0). This helps avoid 429 errors during long-running job polling. --- ## Credits - [A2Z WEB LTD](https://github.com/a2zwebltd) - [Dawid Makowski](https://github.com/makowskid) - Boost your [Laravel AI](https://sharpapi.com/) capabilities! --- ## License The MIT License (MIT). --- ## Social Media 🚀 For the latest news, tutorials, and case studies, don't forget to follow us on: - [SharpAPI X (formerly Twitter)](https://x.com/SharpAPI) - [SharpAPI YouTube](https://www.youtube.com/@SharpAPI) - [SharpAPI Vimeo](https://vimeo.com/SharpAPI) - [SharpAPI LinkedIn](https://www.linkedin.com/products/a2z-web-ltd-sharpapicom-automate-with-aipowered-api/) - [SharpAPI Facebook](https://www.facebook.com/profile.php?id=61554115896974) php-core-1.4.0/composer.json000066400000000000000000000015611514530607400157630ustar00rootroot00000000000000{ "name": "sharpapi/php-core", "description": "SharpAPI.com PHP Core functionalities & communication", "type": "library", "require": { "php": "^8.1", "guzzlehttp/guzzle": "^7.8.2", "nesbot/carbon": "^2.0|^3.0", "ext-json": "*", "ext-mbstring": "*", "spatie/url": "^2.4" }, "license": "MIT", "autoload": { "psr-4": { "SharpAPI\\Core\\": "src/" } }, "autoload-dev": { "psr-4": { "SharpAPI\\Core\\Tests\\": "tests/" } }, "authors": [ { "name": "Dawid Makowski", "email": "contact@sharpapi.com" } ], "extra": { "branch-alias": { "dev-master": "1.3.x-dev" } }, "minimum-stability": "stable", "require-dev": { "phpunit/phpunit": "^10" } } php-core-1.4.0/composer.lock000066400000000000000000003246061514530607400157520ustar00rootroot00000000000000{ "_readme": [ "This file locks the dependencies of your project to a known state", "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies", "This file is @generated automatically" ], "content-hash": "f451cf2218c95d4ae08b260260e4960e", "packages": [ { "name": "carbonphp/carbon-doctrine-types", "version": "3.2.0", "source": { "type": "git", "url": "https://github.com/CarbonPHP/carbon-doctrine-types.git", "reference": "18ba5ddfec8976260ead6e866180bd5d2f71aa1d" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/CarbonPHP/carbon-doctrine-types/zipball/18ba5ddfec8976260ead6e866180bd5d2f71aa1d", "reference": "18ba5ddfec8976260ead6e866180bd5d2f71aa1d", "shasum": "" }, "require": { "php": "^8.1" }, "conflict": { "doctrine/dbal": "<4.0.0 || >=5.0.0" }, "require-dev": { "doctrine/dbal": "^4.0.0", "nesbot/carbon": "^2.71.0 || ^3.0.0", "phpunit/phpunit": "^10.3" }, "type": "library", "autoload": { "psr-4": { "Carbon\\Doctrine\\": "src/Carbon/Doctrine/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "KyleKatarn", "email": "kylekatarnls@gmail.com" } ], "description": "Types to use Carbon in Doctrine", "keywords": [ "carbon", "date", "datetime", "doctrine", "time" ], "support": { "issues": "https://github.com/CarbonPHP/carbon-doctrine-types/issues", "source": "https://github.com/CarbonPHP/carbon-doctrine-types/tree/3.2.0" }, "funding": [ { "url": "https://github.com/kylekatarnls", "type": "github" }, { "url": "https://opencollective.com/Carbon", "type": "open_collective" }, { "url": "https://tidelift.com/funding/github/packagist/nesbot/carbon", "type": "tidelift" } ], "time": "2024-02-09T16:56:22+00:00" }, { "name": "guzzlehttp/guzzle", "version": "7.9.3", "source": { "type": "git", "url": "https://github.com/guzzle/guzzle.git", "reference": "7b2f29fe81dc4da0ca0ea7d42107a0845946ea77" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/guzzle/guzzle/zipball/7b2f29fe81dc4da0ca0ea7d42107a0845946ea77", "reference": "7b2f29fe81dc4da0ca0ea7d42107a0845946ea77", "shasum": "" }, "require": { "ext-json": "*", "guzzlehttp/promises": "^1.5.3 || ^2.0.3", "guzzlehttp/psr7": "^2.7.0", "php": "^7.2.5 || ^8.0", "psr/http-client": "^1.0", "symfony/deprecation-contracts": "^2.2 || ^3.0" }, "provide": { "psr/http-client-implementation": "1.0" }, "require-dev": { "bamarni/composer-bin-plugin": "^1.8.2", "ext-curl": "*", "guzzle/client-integration-tests": "3.0.2", "php-http/message-factory": "^1.1", "phpunit/phpunit": "^8.5.39 || ^9.6.20", "psr/log": "^1.1 || ^2.0 || ^3.0" }, "suggest": { "ext-curl": "Required for CURL handler support", "ext-intl": "Required for Internationalized Domain Name (IDN) support", "psr/log": "Required for using the Log middleware" }, "type": "library", "extra": { "bamarni-bin": { "bin-links": true, "forward-command": false } }, "autoload": { "files": [ "src/functions_include.php" ], "psr-4": { "GuzzleHttp\\": "src/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Graham Campbell", "email": "hello@gjcampbell.co.uk", "homepage": "https://github.com/GrahamCampbell" }, { "name": "Michael Dowling", "email": "mtdowling@gmail.com", "homepage": "https://github.com/mtdowling" }, { "name": "Jeremy Lindblom", "email": "jeremeamia@gmail.com", "homepage": "https://github.com/jeremeamia" }, { "name": "George Mponos", "email": "gmponos@gmail.com", "homepage": "https://github.com/gmponos" }, { "name": "Tobias Nyholm", "email": "tobias.nyholm@gmail.com", "homepage": "https://github.com/Nyholm" }, { "name": "Márk Sági-Kazár", "email": "mark.sagikazar@gmail.com", "homepage": "https://github.com/sagikazarmark" }, { "name": "Tobias Schultze", "email": "webmaster@tubo-world.de", "homepage": "https://github.com/Tobion" } ], "description": "Guzzle is a PHP HTTP client library", "keywords": [ "client", "curl", "framework", "http", "http client", "psr-18", "psr-7", "rest", "web service" ], "support": { "issues": "https://github.com/guzzle/guzzle/issues", "source": "https://github.com/guzzle/guzzle/tree/7.9.3" }, "funding": [ { "url": "https://github.com/GrahamCampbell", "type": "github" }, { "url": "https://github.com/Nyholm", "type": "github" }, { "url": "https://tidelift.com/funding/github/packagist/guzzlehttp/guzzle", "type": "tidelift" } ], "time": "2025-03-27T13:37:11+00:00" }, { "name": "guzzlehttp/promises", "version": "2.2.0", "source": { "type": "git", "url": "https://github.com/guzzle/promises.git", "reference": "7c69f28996b0a6920945dd20b3857e499d9ca96c" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/guzzle/promises/zipball/7c69f28996b0a6920945dd20b3857e499d9ca96c", "reference": "7c69f28996b0a6920945dd20b3857e499d9ca96c", "shasum": "" }, "require": { "php": "^7.2.5 || ^8.0" }, "require-dev": { "bamarni/composer-bin-plugin": "^1.8.2", "phpunit/phpunit": "^8.5.39 || ^9.6.20" }, "type": "library", "extra": { "bamarni-bin": { "bin-links": true, "forward-command": false } }, "autoload": { "psr-4": { "GuzzleHttp\\Promise\\": "src/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Graham Campbell", "email": "hello@gjcampbell.co.uk", "homepage": "https://github.com/GrahamCampbell" }, { "name": "Michael Dowling", "email": "mtdowling@gmail.com", "homepage": "https://github.com/mtdowling" }, { "name": "Tobias Nyholm", "email": "tobias.nyholm@gmail.com", "homepage": "https://github.com/Nyholm" }, { "name": "Tobias Schultze", "email": "webmaster@tubo-world.de", "homepage": "https://github.com/Tobion" } ], "description": "Guzzle promises library", "keywords": [ "promise" ], "support": { "issues": "https://github.com/guzzle/promises/issues", "source": "https://github.com/guzzle/promises/tree/2.2.0" }, "funding": [ { "url": "https://github.com/GrahamCampbell", "type": "github" }, { "url": "https://github.com/Nyholm", "type": "github" }, { "url": "https://tidelift.com/funding/github/packagist/guzzlehttp/promises", "type": "tidelift" } ], "time": "2025-03-27T13:27:01+00:00" }, { "name": "guzzlehttp/psr7", "version": "2.7.1", "source": { "type": "git", "url": "https://github.com/guzzle/psr7.git", "reference": "c2270caaabe631b3b44c85f99e5a04bbb8060d16" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/guzzle/psr7/zipball/c2270caaabe631b3b44c85f99e5a04bbb8060d16", "reference": "c2270caaabe631b3b44c85f99e5a04bbb8060d16", "shasum": "" }, "require": { "php": "^7.2.5 || ^8.0", "psr/http-factory": "^1.0", "psr/http-message": "^1.1 || ^2.0", "ralouphie/getallheaders": "^3.0" }, "provide": { "psr/http-factory-implementation": "1.0", "psr/http-message-implementation": "1.0" }, "require-dev": { "bamarni/composer-bin-plugin": "^1.8.2", "http-interop/http-factory-tests": "0.9.0", "phpunit/phpunit": "^8.5.39 || ^9.6.20" }, "suggest": { "laminas/laminas-httphandlerrunner": "Emit PSR-7 responses" }, "type": "library", "extra": { "bamarni-bin": { "bin-links": true, "forward-command": false } }, "autoload": { "psr-4": { "GuzzleHttp\\Psr7\\": "src/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Graham Campbell", "email": "hello@gjcampbell.co.uk", "homepage": "https://github.com/GrahamCampbell" }, { "name": "Michael Dowling", "email": "mtdowling@gmail.com", "homepage": "https://github.com/mtdowling" }, { "name": "George Mponos", "email": "gmponos@gmail.com", "homepage": "https://github.com/gmponos" }, { "name": "Tobias Nyholm", "email": "tobias.nyholm@gmail.com", "homepage": "https://github.com/Nyholm" }, { "name": "Márk Sági-Kazár", "email": "mark.sagikazar@gmail.com", "homepage": "https://github.com/sagikazarmark" }, { "name": "Tobias Schultze", "email": "webmaster@tubo-world.de", "homepage": "https://github.com/Tobion" }, { "name": "Márk Sági-Kazár", "email": "mark.sagikazar@gmail.com", "homepage": "https://sagikazarmark.hu" } ], "description": "PSR-7 message implementation that also provides common utility methods", "keywords": [ "http", "message", "psr-7", "request", "response", "stream", "uri", "url" ], "support": { "issues": "https://github.com/guzzle/psr7/issues", "source": "https://github.com/guzzle/psr7/tree/2.7.1" }, "funding": [ { "url": "https://github.com/GrahamCampbell", "type": "github" }, { "url": "https://github.com/Nyholm", "type": "github" }, { "url": "https://tidelift.com/funding/github/packagist/guzzlehttp/psr7", "type": "tidelift" } ], "time": "2025-03-27T12:30:47+00:00" }, { "name": "nesbot/carbon", "version": "3.9.0", "source": { "type": "git", "url": "https://github.com/CarbonPHP/carbon.git", "reference": "6d16a8a015166fe54e22c042e0805c5363aef50d" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/CarbonPHP/carbon/zipball/6d16a8a015166fe54e22c042e0805c5363aef50d", "reference": "6d16a8a015166fe54e22c042e0805c5363aef50d", "shasum": "" }, "require": { "carbonphp/carbon-doctrine-types": "<100.0", "ext-json": "*", "php": "^8.1", "psr/clock": "^1.0", "symfony/clock": "^6.3 || ^7.0", "symfony/polyfill-mbstring": "^1.0", "symfony/translation": "^4.4.18 || ^5.2.1|| ^6.0 || ^7.0" }, "provide": { "psr/clock-implementation": "1.0" }, "require-dev": { "doctrine/dbal": "^3.6.3 || ^4.0", "doctrine/orm": "^2.15.2 || ^3.0", "friendsofphp/php-cs-fixer": "^3.57.2", "kylekatarnls/multi-tester": "^2.5.3", "ondrejmirtes/better-reflection": "^6.25.0.4", "phpmd/phpmd": "^2.15.0", "phpstan/extension-installer": "^1.3.1", "phpstan/phpstan": "^1.11.2", "phpunit/phpunit": "^10.5.20", "squizlabs/php_codesniffer": "^3.9.0" }, "bin": [ "bin/carbon" ], "type": "library", "extra": { "laravel": { "providers": [ "Carbon\\Laravel\\ServiceProvider" ] }, "phpstan": { "includes": [ "extension.neon" ] }, "branch-alias": { "dev-2.x": "2.x-dev", "dev-master": "3.x-dev" } }, "autoload": { "psr-4": { "Carbon\\": "src/Carbon/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Brian Nesbitt", "email": "brian@nesbot.com", "homepage": "https://markido.com" }, { "name": "kylekatarnls", "homepage": "https://github.com/kylekatarnls" } ], "description": "An API extension for DateTime that supports 281 different languages.", "homepage": "https://carbon.nesbot.com", "keywords": [ "date", "datetime", "time" ], "support": { "docs": "https://carbon.nesbot.com/docs", "issues": "https://github.com/CarbonPHP/carbon/issues", "source": "https://github.com/CarbonPHP/carbon" }, "funding": [ { "url": "https://github.com/sponsors/kylekatarnls", "type": "github" }, { "url": "https://opencollective.com/Carbon#sponsor", "type": "opencollective" }, { "url": "https://tidelift.com/subscription/pkg/packagist-nesbot-carbon?utm_source=packagist-nesbot-carbon&utm_medium=referral&utm_campaign=readme", "type": "tidelift" } ], "time": "2025-03-27T12:57:33+00:00" }, { "name": "psr/clock", "version": "1.0.0", "source": { "type": "git", "url": "https://github.com/php-fig/clock.git", "reference": "e41a24703d4560fd0acb709162f73b8adfc3aa0d" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/php-fig/clock/zipball/e41a24703d4560fd0acb709162f73b8adfc3aa0d", "reference": "e41a24703d4560fd0acb709162f73b8adfc3aa0d", "shasum": "" }, "require": { "php": "^7.0 || ^8.0" }, "type": "library", "autoload": { "psr-4": { "Psr\\Clock\\": "src/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "PHP-FIG", "homepage": "https://www.php-fig.org/" } ], "description": "Common interface for reading the clock.", "homepage": "https://github.com/php-fig/clock", "keywords": [ "clock", "now", "psr", "psr-20", "time" ], "support": { "issues": "https://github.com/php-fig/clock/issues", "source": "https://github.com/php-fig/clock/tree/1.0.0" }, "time": "2022-11-25T14:36:26+00:00" }, { "name": "psr/http-client", "version": "1.0.3", "source": { "type": "git", "url": "https://github.com/php-fig/http-client.git", "reference": "bb5906edc1c324c9a05aa0873d40117941e5fa90" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/php-fig/http-client/zipball/bb5906edc1c324c9a05aa0873d40117941e5fa90", "reference": "bb5906edc1c324c9a05aa0873d40117941e5fa90", "shasum": "" }, "require": { "php": "^7.0 || ^8.0", "psr/http-message": "^1.0 || ^2.0" }, "type": "library", "extra": { "branch-alias": { "dev-master": "1.0.x-dev" } }, "autoload": { "psr-4": { "Psr\\Http\\Client\\": "src/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "PHP-FIG", "homepage": "https://www.php-fig.org/" } ], "description": "Common interface for HTTP clients", "homepage": "https://github.com/php-fig/http-client", "keywords": [ "http", "http-client", "psr", "psr-18" ], "support": { "source": "https://github.com/php-fig/http-client" }, "time": "2023-09-23T14:17:50+00:00" }, { "name": "psr/http-factory", "version": "1.1.0", "source": { "type": "git", "url": "https://github.com/php-fig/http-factory.git", "reference": "2b4765fddfe3b508ac62f829e852b1501d3f6e8a" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/php-fig/http-factory/zipball/2b4765fddfe3b508ac62f829e852b1501d3f6e8a", "reference": "2b4765fddfe3b508ac62f829e852b1501d3f6e8a", "shasum": "" }, "require": { "php": ">=7.1", "psr/http-message": "^1.0 || ^2.0" }, "type": "library", "extra": { "branch-alias": { "dev-master": "1.0.x-dev" } }, "autoload": { "psr-4": { "Psr\\Http\\Message\\": "src/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "PHP-FIG", "homepage": "https://www.php-fig.org/" } ], "description": "PSR-17: Common interfaces for PSR-7 HTTP message factories", "keywords": [ "factory", "http", "message", "psr", "psr-17", "psr-7", "request", "response" ], "support": { "source": "https://github.com/php-fig/http-factory" }, "time": "2024-04-15T12:06:14+00:00" }, { "name": "psr/http-message", "version": "2.0", "source": { "type": "git", "url": "https://github.com/php-fig/http-message.git", "reference": "402d35bcb92c70c026d1a6a9883f06b2ead23d71" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/php-fig/http-message/zipball/402d35bcb92c70c026d1a6a9883f06b2ead23d71", "reference": "402d35bcb92c70c026d1a6a9883f06b2ead23d71", "shasum": "" }, "require": { "php": "^7.2 || ^8.0" }, "type": "library", "extra": { "branch-alias": { "dev-master": "2.0.x-dev" } }, "autoload": { "psr-4": { "Psr\\Http\\Message\\": "src/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "PHP-FIG", "homepage": "https://www.php-fig.org/" } ], "description": "Common interface for HTTP messages", "homepage": "https://github.com/php-fig/http-message", "keywords": [ "http", "http-message", "psr", "psr-7", "request", "response" ], "support": { "source": "https://github.com/php-fig/http-message/tree/2.0" }, "time": "2023-04-04T09:54:51+00:00" }, { "name": "ralouphie/getallheaders", "version": "3.0.3", "source": { "type": "git", "url": "https://github.com/ralouphie/getallheaders.git", "reference": "120b605dfeb996808c31b6477290a714d356e822" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/ralouphie/getallheaders/zipball/120b605dfeb996808c31b6477290a714d356e822", "reference": "120b605dfeb996808c31b6477290a714d356e822", "shasum": "" }, "require": { "php": ">=5.6" }, "require-dev": { "php-coveralls/php-coveralls": "^2.1", "phpunit/phpunit": "^5 || ^6.5" }, "type": "library", "autoload": { "files": [ "src/getallheaders.php" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Ralph Khattar", "email": "ralph.khattar@gmail.com" } ], "description": "A polyfill for getallheaders.", "support": { "issues": "https://github.com/ralouphie/getallheaders/issues", "source": "https://github.com/ralouphie/getallheaders/tree/develop" }, "time": "2019-03-08T08:55:37+00:00" }, { "name": "spatie/macroable", "version": "2.0.0", "source": { "type": "git", "url": "https://github.com/spatie/macroable.git", "reference": "ec2c320f932e730607aff8052c44183cf3ecb072" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/spatie/macroable/zipball/ec2c320f932e730607aff8052c44183cf3ecb072", "reference": "ec2c320f932e730607aff8052c44183cf3ecb072", "shasum": "" }, "require": { "php": "^8.0" }, "require-dev": { "phpunit/phpunit": "^8.0|^9.3" }, "type": "library", "autoload": { "psr-4": { "Spatie\\Macroable\\": "src" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Freek Van der Herten", "email": "freek@spatie.be", "homepage": "https://spatie.be", "role": "Developer" } ], "description": "A trait to dynamically add methods to a class", "homepage": "https://github.com/spatie/macroable", "keywords": [ "macroable", "spatie" ], "support": { "issues": "https://github.com/spatie/macroable/issues", "source": "https://github.com/spatie/macroable/tree/2.0.0" }, "time": "2021-03-26T22:39:02+00:00" }, { "name": "spatie/url", "version": "2.4.0", "source": { "type": "git", "url": "https://github.com/spatie/url.git", "reference": "93a51db743cdec22b081c64593e193887c9cd395" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/spatie/url/zipball/93a51db743cdec22b081c64593e193887c9cd395", "reference": "93a51db743cdec22b081c64593e193887c9cd395", "shasum": "" }, "require": { "php": "^8.0", "psr/http-message": "^1.0 || ^2.0", "spatie/macroable": "^1.0 || ^2.0" }, "require-dev": { "pestphp/pest": "^1.21" }, "type": "library", "autoload": { "psr-4": { "Spatie\\Url\\": "src" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Sebastian De Deyne", "email": "sebastian@spatie.be", "homepage": "https://spatie.be", "role": "Developer" } ], "description": "Parse, build and manipulate URL's", "homepage": "https://github.com/spatie/url", "keywords": [ "spatie", "url" ], "support": { "issues": "https://github.com/spatie/url/issues", "source": "https://github.com/spatie/url/tree/2.4.0" }, "funding": [ { "url": "https://spatie.be/open-source/support-us", "type": "custom" }, { "url": "https://github.com/spatie", "type": "github" } ], "time": "2024-03-08T11:35:19+00:00" }, { "name": "symfony/clock", "version": "v7.2.0", "source": { "type": "git", "url": "https://github.com/symfony/clock.git", "reference": "b81435fbd6648ea425d1ee96a2d8e68f4ceacd24" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/symfony/clock/zipball/b81435fbd6648ea425d1ee96a2d8e68f4ceacd24", "reference": "b81435fbd6648ea425d1ee96a2d8e68f4ceacd24", "shasum": "" }, "require": { "php": ">=8.2", "psr/clock": "^1.0", "symfony/polyfill-php83": "^1.28" }, "provide": { "psr/clock-implementation": "1.0" }, "type": "library", "autoload": { "files": [ "Resources/now.php" ], "psr-4": { "Symfony\\Component\\Clock\\": "" }, "exclude-from-classmap": [ "/Tests/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Nicolas Grekas", "email": "p@tchwork.com" }, { "name": "Symfony Community", "homepage": "https://symfony.com/contributors" } ], "description": "Decouples applications from the system clock", "homepage": "https://symfony.com", "keywords": [ "clock", "psr20", "time" ], "support": { "source": "https://github.com/symfony/clock/tree/v7.2.0" }, "funding": [ { "url": "https://symfony.com/sponsor", "type": "custom" }, { "url": "https://github.com/fabpot", "type": "github" }, { "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", "type": "tidelift" } ], "time": "2024-09-25T14:21:43+00:00" }, { "name": "symfony/deprecation-contracts", "version": "v3.5.1", "source": { "type": "git", "url": "https://github.com/symfony/deprecation-contracts.git", "reference": "74c71c939a79f7d5bf3c1ce9f5ea37ba0114c6f6" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/74c71c939a79f7d5bf3c1ce9f5ea37ba0114c6f6", "reference": "74c71c939a79f7d5bf3c1ce9f5ea37ba0114c6f6", "shasum": "" }, "require": { "php": ">=8.1" }, "type": "library", "extra": { "thanks": { "url": "https://github.com/symfony/contracts", "name": "symfony/contracts" }, "branch-alias": { "dev-main": "3.5-dev" } }, "autoload": { "files": [ "function.php" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Nicolas Grekas", "email": "p@tchwork.com" }, { "name": "Symfony Community", "homepage": "https://symfony.com/contributors" } ], "description": "A generic function and convention to trigger deprecation notices", "homepage": "https://symfony.com", "support": { "source": "https://github.com/symfony/deprecation-contracts/tree/v3.5.1" }, "funding": [ { "url": "https://symfony.com/sponsor", "type": "custom" }, { "url": "https://github.com/fabpot", "type": "github" }, { "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", "type": "tidelift" } ], "time": "2024-09-25T14:20:29+00:00" }, { "name": "symfony/polyfill-mbstring", "version": "v1.31.0", "source": { "type": "git", "url": "https://github.com/symfony/polyfill-mbstring.git", "reference": "85181ba99b2345b0ef10ce42ecac37612d9fd341" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/85181ba99b2345b0ef10ce42ecac37612d9fd341", "reference": "85181ba99b2345b0ef10ce42ecac37612d9fd341", "shasum": "" }, "require": { "php": ">=7.2" }, "provide": { "ext-mbstring": "*" }, "suggest": { "ext-mbstring": "For best performance" }, "type": "library", "extra": { "thanks": { "url": "https://github.com/symfony/polyfill", "name": "symfony/polyfill" } }, "autoload": { "files": [ "bootstrap.php" ], "psr-4": { "Symfony\\Polyfill\\Mbstring\\": "" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Nicolas Grekas", "email": "p@tchwork.com" }, { "name": "Symfony Community", "homepage": "https://symfony.com/contributors" } ], "description": "Symfony polyfill for the Mbstring extension", "homepage": "https://symfony.com", "keywords": [ "compatibility", "mbstring", "polyfill", "portable", "shim" ], "support": { "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.31.0" }, "funding": [ { "url": "https://symfony.com/sponsor", "type": "custom" }, { "url": "https://github.com/fabpot", "type": "github" }, { "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", "type": "tidelift" } ], "time": "2024-09-09T11:45:10+00:00" }, { "name": "symfony/polyfill-php83", "version": "v1.31.0", "source": { "type": "git", "url": "https://github.com/symfony/polyfill-php83.git", "reference": "2fb86d65e2d424369ad2905e83b236a8805ba491" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/symfony/polyfill-php83/zipball/2fb86d65e2d424369ad2905e83b236a8805ba491", "reference": "2fb86d65e2d424369ad2905e83b236a8805ba491", "shasum": "" }, "require": { "php": ">=7.2" }, "type": "library", "extra": { "thanks": { "url": "https://github.com/symfony/polyfill", "name": "symfony/polyfill" } }, "autoload": { "files": [ "bootstrap.php" ], "psr-4": { "Symfony\\Polyfill\\Php83\\": "" }, "classmap": [ "Resources/stubs" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Nicolas Grekas", "email": "p@tchwork.com" }, { "name": "Symfony Community", "homepage": "https://symfony.com/contributors" } ], "description": "Symfony polyfill backporting some PHP 8.3+ features to lower PHP versions", "homepage": "https://symfony.com", "keywords": [ "compatibility", "polyfill", "portable", "shim" ], "support": { "source": "https://github.com/symfony/polyfill-php83/tree/v1.31.0" }, "funding": [ { "url": "https://symfony.com/sponsor", "type": "custom" }, { "url": "https://github.com/fabpot", "type": "github" }, { "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", "type": "tidelift" } ], "time": "2024-09-09T11:45:10+00:00" }, { "name": "symfony/translation", "version": "v7.2.4", "source": { "type": "git", "url": "https://github.com/symfony/translation.git", "reference": "283856e6981286cc0d800b53bd5703e8e363f05a" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/symfony/translation/zipball/283856e6981286cc0d800b53bd5703e8e363f05a", "reference": "283856e6981286cc0d800b53bd5703e8e363f05a", "shasum": "" }, "require": { "php": ">=8.2", "symfony/deprecation-contracts": "^2.5|^3", "symfony/polyfill-mbstring": "~1.0", "symfony/translation-contracts": "^2.5|^3.0" }, "conflict": { "symfony/config": "<6.4", "symfony/console": "<6.4", "symfony/dependency-injection": "<6.4", "symfony/http-client-contracts": "<2.5", "symfony/http-kernel": "<6.4", "symfony/service-contracts": "<2.5", "symfony/twig-bundle": "<6.4", "symfony/yaml": "<6.4" }, "provide": { "symfony/translation-implementation": "2.3|3.0" }, "require-dev": { "nikic/php-parser": "^4.18|^5.0", "psr/log": "^1|^2|^3", "symfony/config": "^6.4|^7.0", "symfony/console": "^6.4|^7.0", "symfony/dependency-injection": "^6.4|^7.0", "symfony/finder": "^6.4|^7.0", "symfony/http-client-contracts": "^2.5|^3.0", "symfony/http-kernel": "^6.4|^7.0", "symfony/intl": "^6.4|^7.0", "symfony/polyfill-intl-icu": "^1.21", "symfony/routing": "^6.4|^7.0", "symfony/service-contracts": "^2.5|^3", "symfony/yaml": "^6.4|^7.0" }, "type": "library", "autoload": { "files": [ "Resources/functions.php" ], "psr-4": { "Symfony\\Component\\Translation\\": "" }, "exclude-from-classmap": [ "/Tests/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Fabien Potencier", "email": "fabien@symfony.com" }, { "name": "Symfony Community", "homepage": "https://symfony.com/contributors" } ], "description": "Provides tools to internationalize your application", "homepage": "https://symfony.com", "support": { "source": "https://github.com/symfony/translation/tree/v7.2.4" }, "funding": [ { "url": "https://symfony.com/sponsor", "type": "custom" }, { "url": "https://github.com/fabpot", "type": "github" }, { "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", "type": "tidelift" } ], "time": "2025-02-13T10:27:23+00:00" }, { "name": "symfony/translation-contracts", "version": "v3.5.1", "source": { "type": "git", "url": "https://github.com/symfony/translation-contracts.git", "reference": "4667ff3bd513750603a09c8dedbea942487fb07c" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/symfony/translation-contracts/zipball/4667ff3bd513750603a09c8dedbea942487fb07c", "reference": "4667ff3bd513750603a09c8dedbea942487fb07c", "shasum": "" }, "require": { "php": ">=8.1" }, "type": "library", "extra": { "thanks": { "url": "https://github.com/symfony/contracts", "name": "symfony/contracts" }, "branch-alias": { "dev-main": "3.5-dev" } }, "autoload": { "psr-4": { "Symfony\\Contracts\\Translation\\": "" }, "exclude-from-classmap": [ "/Test/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Nicolas Grekas", "email": "p@tchwork.com" }, { "name": "Symfony Community", "homepage": "https://symfony.com/contributors" } ], "description": "Generic abstractions related to translation", "homepage": "https://symfony.com", "keywords": [ "abstractions", "contracts", "decoupling", "interfaces", "interoperability", "standards" ], "support": { "source": "https://github.com/symfony/translation-contracts/tree/v3.5.1" }, "funding": [ { "url": "https://symfony.com/sponsor", "type": "custom" }, { "url": "https://github.com/fabpot", "type": "github" }, { "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", "type": "tidelift" } ], "time": "2024-09-25T14:20:29+00:00" } ], "packages-dev": [ { "name": "myclabs/deep-copy", "version": "1.13.4", "source": { "type": "git", "url": "https://github.com/myclabs/DeepCopy.git", "reference": "07d290f0c47959fd5eed98c95ee5602db07e0b6a" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/myclabs/DeepCopy/zipball/07d290f0c47959fd5eed98c95ee5602db07e0b6a", "reference": "07d290f0c47959fd5eed98c95ee5602db07e0b6a", "shasum": "" }, "require": { "php": "^7.1 || ^8.0" }, "conflict": { "doctrine/collections": "<1.6.8", "doctrine/common": "<2.13.3 || >=3 <3.2.2" }, "require-dev": { "doctrine/collections": "^1.6.8", "doctrine/common": "^2.13.3 || ^3.2.2", "phpspec/prophecy": "^1.10", "phpunit/phpunit": "^7.5.20 || ^8.5.23 || ^9.5.13" }, "type": "library", "autoload": { "files": [ "src/DeepCopy/deep_copy.php" ], "psr-4": { "DeepCopy\\": "src/DeepCopy/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "description": "Create deep copies (clones) of your objects", "keywords": [ "clone", "copy", "duplicate", "object", "object graph" ], "support": { "issues": "https://github.com/myclabs/DeepCopy/issues", "source": "https://github.com/myclabs/DeepCopy/tree/1.13.4" }, "funding": [ { "url": "https://tidelift.com/funding/github/packagist/myclabs/deep-copy", "type": "tidelift" } ], "time": "2025-08-01T08:46:24+00:00" }, { "name": "nikic/php-parser", "version": "v5.7.0", "source": { "type": "git", "url": "https://github.com/nikic/PHP-Parser.git", "reference": "dca41cd15c2ac9d055ad70dbfd011130757d1f82" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/nikic/PHP-Parser/zipball/dca41cd15c2ac9d055ad70dbfd011130757d1f82", "reference": "dca41cd15c2ac9d055ad70dbfd011130757d1f82", "shasum": "" }, "require": { "ext-ctype": "*", "ext-json": "*", "ext-tokenizer": "*", "php": ">=7.4" }, "require-dev": { "ircmaxell/php-yacc": "^0.0.7", "phpunit/phpunit": "^9.0" }, "bin": [ "bin/php-parse" ], "type": "library", "extra": { "branch-alias": { "dev-master": "5.x-dev" } }, "autoload": { "psr-4": { "PhpParser\\": "lib/PhpParser" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "BSD-3-Clause" ], "authors": [ { "name": "Nikita Popov" } ], "description": "A PHP parser written in PHP", "keywords": [ "parser", "php" ], "support": { "issues": "https://github.com/nikic/PHP-Parser/issues", "source": "https://github.com/nikic/PHP-Parser/tree/v5.7.0" }, "time": "2025-12-06T11:56:16+00:00" }, { "name": "phar-io/manifest", "version": "2.0.4", "source": { "type": "git", "url": "https://github.com/phar-io/manifest.git", "reference": "54750ef60c58e43759730615a392c31c80e23176" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/phar-io/manifest/zipball/54750ef60c58e43759730615a392c31c80e23176", "reference": "54750ef60c58e43759730615a392c31c80e23176", "shasum": "" }, "require": { "ext-dom": "*", "ext-libxml": "*", "ext-phar": "*", "ext-xmlwriter": "*", "phar-io/version": "^3.0.1", "php": "^7.2 || ^8.0" }, "type": "library", "extra": { "branch-alias": { "dev-master": "2.0.x-dev" } }, "autoload": { "classmap": [ "src/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "BSD-3-Clause" ], "authors": [ { "name": "Arne Blankerts", "email": "arne@blankerts.de", "role": "Developer" }, { "name": "Sebastian Heuer", "email": "sebastian@phpeople.de", "role": "Developer" }, { "name": "Sebastian Bergmann", "email": "sebastian@phpunit.de", "role": "Developer" } ], "description": "Component for reading phar.io manifest information from a PHP Archive (PHAR)", "support": { "issues": "https://github.com/phar-io/manifest/issues", "source": "https://github.com/phar-io/manifest/tree/2.0.4" }, "funding": [ { "url": "https://github.com/theseer", "type": "github" } ], "time": "2024-03-03T12:33:53+00:00" }, { "name": "phar-io/version", "version": "3.2.1", "source": { "type": "git", "url": "https://github.com/phar-io/version.git", "reference": "4f7fd7836c6f332bb2933569e566a0d6c4cbed74" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/phar-io/version/zipball/4f7fd7836c6f332bb2933569e566a0d6c4cbed74", "reference": "4f7fd7836c6f332bb2933569e566a0d6c4cbed74", "shasum": "" }, "require": { "php": "^7.2 || ^8.0" }, "type": "library", "autoload": { "classmap": [ "src/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "BSD-3-Clause" ], "authors": [ { "name": "Arne Blankerts", "email": "arne@blankerts.de", "role": "Developer" }, { "name": "Sebastian Heuer", "email": "sebastian@phpeople.de", "role": "Developer" }, { "name": "Sebastian Bergmann", "email": "sebastian@phpunit.de", "role": "Developer" } ], "description": "Library for handling version information and constraints", "support": { "issues": "https://github.com/phar-io/version/issues", "source": "https://github.com/phar-io/version/tree/3.2.1" }, "time": "2022-02-21T01:04:05+00:00" }, { "name": "phpunit/php-code-coverage", "version": "10.1.16", "source": { "type": "git", "url": "https://github.com/sebastianbergmann/php-code-coverage.git", "reference": "7e308268858ed6baedc8704a304727d20bc07c77" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/sebastianbergmann/php-code-coverage/zipball/7e308268858ed6baedc8704a304727d20bc07c77", "reference": "7e308268858ed6baedc8704a304727d20bc07c77", "shasum": "" }, "require": { "ext-dom": "*", "ext-libxml": "*", "ext-xmlwriter": "*", "nikic/php-parser": "^4.19.1 || ^5.1.0", "php": ">=8.1", "phpunit/php-file-iterator": "^4.1.0", "phpunit/php-text-template": "^3.0.1", "sebastian/code-unit-reverse-lookup": "^3.0.0", "sebastian/complexity": "^3.2.0", "sebastian/environment": "^6.1.0", "sebastian/lines-of-code": "^2.0.2", "sebastian/version": "^4.0.1", "theseer/tokenizer": "^1.2.3" }, "require-dev": { "phpunit/phpunit": "^10.1" }, "suggest": { "ext-pcov": "PHP extension that provides line coverage", "ext-xdebug": "PHP extension that provides line coverage as well as branch and path coverage" }, "type": "library", "extra": { "branch-alias": { "dev-main": "10.1.x-dev" } }, "autoload": { "classmap": [ "src/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "BSD-3-Clause" ], "authors": [ { "name": "Sebastian Bergmann", "email": "sebastian@phpunit.de", "role": "lead" } ], "description": "Library that provides collection, processing, and rendering functionality for PHP code coverage information.", "homepage": "https://github.com/sebastianbergmann/php-code-coverage", "keywords": [ "coverage", "testing", "xunit" ], "support": { "issues": "https://github.com/sebastianbergmann/php-code-coverage/issues", "security": "https://github.com/sebastianbergmann/php-code-coverage/security/policy", "source": "https://github.com/sebastianbergmann/php-code-coverage/tree/10.1.16" }, "funding": [ { "url": "https://github.com/sebastianbergmann", "type": "github" } ], "time": "2024-08-22T04:31:57+00:00" }, { "name": "phpunit/php-file-iterator", "version": "4.1.0", "source": { "type": "git", "url": "https://github.com/sebastianbergmann/php-file-iterator.git", "reference": "a95037b6d9e608ba092da1b23931e537cadc3c3c" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/sebastianbergmann/php-file-iterator/zipball/a95037b6d9e608ba092da1b23931e537cadc3c3c", "reference": "a95037b6d9e608ba092da1b23931e537cadc3c3c", "shasum": "" }, "require": { "php": ">=8.1" }, "require-dev": { "phpunit/phpunit": "^10.0" }, "type": "library", "extra": { "branch-alias": { "dev-main": "4.0-dev" } }, "autoload": { "classmap": [ "src/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "BSD-3-Clause" ], "authors": [ { "name": "Sebastian Bergmann", "email": "sebastian@phpunit.de", "role": "lead" } ], "description": "FilterIterator implementation that filters files based on a list of suffixes.", "homepage": "https://github.com/sebastianbergmann/php-file-iterator/", "keywords": [ "filesystem", "iterator" ], "support": { "issues": "https://github.com/sebastianbergmann/php-file-iterator/issues", "security": "https://github.com/sebastianbergmann/php-file-iterator/security/policy", "source": "https://github.com/sebastianbergmann/php-file-iterator/tree/4.1.0" }, "funding": [ { "url": "https://github.com/sebastianbergmann", "type": "github" } ], "time": "2023-08-31T06:24:48+00:00" }, { "name": "phpunit/php-invoker", "version": "4.0.0", "source": { "type": "git", "url": "https://github.com/sebastianbergmann/php-invoker.git", "reference": "f5e568ba02fa5ba0ddd0f618391d5a9ea50b06d7" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/sebastianbergmann/php-invoker/zipball/f5e568ba02fa5ba0ddd0f618391d5a9ea50b06d7", "reference": "f5e568ba02fa5ba0ddd0f618391d5a9ea50b06d7", "shasum": "" }, "require": { "php": ">=8.1" }, "require-dev": { "ext-pcntl": "*", "phpunit/phpunit": "^10.0" }, "suggest": { "ext-pcntl": "*" }, "type": "library", "extra": { "branch-alias": { "dev-main": "4.0-dev" } }, "autoload": { "classmap": [ "src/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "BSD-3-Clause" ], "authors": [ { "name": "Sebastian Bergmann", "email": "sebastian@phpunit.de", "role": "lead" } ], "description": "Invoke callables with a timeout", "homepage": "https://github.com/sebastianbergmann/php-invoker/", "keywords": [ "process" ], "support": { "issues": "https://github.com/sebastianbergmann/php-invoker/issues", "source": "https://github.com/sebastianbergmann/php-invoker/tree/4.0.0" }, "funding": [ { "url": "https://github.com/sebastianbergmann", "type": "github" } ], "time": "2023-02-03T06:56:09+00:00" }, { "name": "phpunit/php-text-template", "version": "3.0.1", "source": { "type": "git", "url": "https://github.com/sebastianbergmann/php-text-template.git", "reference": "0c7b06ff49e3d5072f057eb1fa59258bf287a748" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/sebastianbergmann/php-text-template/zipball/0c7b06ff49e3d5072f057eb1fa59258bf287a748", "reference": "0c7b06ff49e3d5072f057eb1fa59258bf287a748", "shasum": "" }, "require": { "php": ">=8.1" }, "require-dev": { "phpunit/phpunit": "^10.0" }, "type": "library", "extra": { "branch-alias": { "dev-main": "3.0-dev" } }, "autoload": { "classmap": [ "src/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "BSD-3-Clause" ], "authors": [ { "name": "Sebastian Bergmann", "email": "sebastian@phpunit.de", "role": "lead" } ], "description": "Simple template engine.", "homepage": "https://github.com/sebastianbergmann/php-text-template/", "keywords": [ "template" ], "support": { "issues": "https://github.com/sebastianbergmann/php-text-template/issues", "security": "https://github.com/sebastianbergmann/php-text-template/security/policy", "source": "https://github.com/sebastianbergmann/php-text-template/tree/3.0.1" }, "funding": [ { "url": "https://github.com/sebastianbergmann", "type": "github" } ], "time": "2023-08-31T14:07:24+00:00" }, { "name": "phpunit/php-timer", "version": "6.0.0", "source": { "type": "git", "url": "https://github.com/sebastianbergmann/php-timer.git", "reference": "e2a2d67966e740530f4a3343fe2e030ffdc1161d" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/sebastianbergmann/php-timer/zipball/e2a2d67966e740530f4a3343fe2e030ffdc1161d", "reference": "e2a2d67966e740530f4a3343fe2e030ffdc1161d", "shasum": "" }, "require": { "php": ">=8.1" }, "require-dev": { "phpunit/phpunit": "^10.0" }, "type": "library", "extra": { "branch-alias": { "dev-main": "6.0-dev" } }, "autoload": { "classmap": [ "src/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "BSD-3-Clause" ], "authors": [ { "name": "Sebastian Bergmann", "email": "sebastian@phpunit.de", "role": "lead" } ], "description": "Utility class for timing", "homepage": "https://github.com/sebastianbergmann/php-timer/", "keywords": [ "timer" ], "support": { "issues": "https://github.com/sebastianbergmann/php-timer/issues", "source": "https://github.com/sebastianbergmann/php-timer/tree/6.0.0" }, "funding": [ { "url": "https://github.com/sebastianbergmann", "type": "github" } ], "time": "2023-02-03T06:57:52+00:00" }, { "name": "phpunit/phpunit", "version": "10.5.63", "source": { "type": "git", "url": "https://github.com/sebastianbergmann/phpunit.git", "reference": "33198268dad71e926626b618f3ec3966661e4d90" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/sebastianbergmann/phpunit/zipball/33198268dad71e926626b618f3ec3966661e4d90", "reference": "33198268dad71e926626b618f3ec3966661e4d90", "shasum": "" }, "require": { "ext-dom": "*", "ext-json": "*", "ext-libxml": "*", "ext-mbstring": "*", "ext-xml": "*", "ext-xmlwriter": "*", "myclabs/deep-copy": "^1.13.4", "phar-io/manifest": "^2.0.4", "phar-io/version": "^3.2.1", "php": ">=8.1", "phpunit/php-code-coverage": "^10.1.16", "phpunit/php-file-iterator": "^4.1.0", "phpunit/php-invoker": "^4.0.0", "phpunit/php-text-template": "^3.0.1", "phpunit/php-timer": "^6.0.0", "sebastian/cli-parser": "^2.0.1", "sebastian/code-unit": "^2.0.0", "sebastian/comparator": "^5.0.5", "sebastian/diff": "^5.1.1", "sebastian/environment": "^6.1.0", "sebastian/exporter": "^5.1.4", "sebastian/global-state": "^6.0.2", "sebastian/object-enumerator": "^5.0.0", "sebastian/recursion-context": "^5.0.1", "sebastian/type": "^4.0.0", "sebastian/version": "^4.0.1" }, "suggest": { "ext-soap": "To be able to generate mocks based on WSDL files" }, "bin": [ "phpunit" ], "type": "library", "extra": { "branch-alias": { "dev-main": "10.5-dev" } }, "autoload": { "files": [ "src/Framework/Assert/Functions.php" ], "classmap": [ "src/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "BSD-3-Clause" ], "authors": [ { "name": "Sebastian Bergmann", "email": "sebastian@phpunit.de", "role": "lead" } ], "description": "The PHP Unit Testing framework.", "homepage": "https://phpunit.de/", "keywords": [ "phpunit", "testing", "xunit" ], "support": { "issues": "https://github.com/sebastianbergmann/phpunit/issues", "security": "https://github.com/sebastianbergmann/phpunit/security/policy", "source": "https://github.com/sebastianbergmann/phpunit/tree/10.5.63" }, "funding": [ { "url": "https://phpunit.de/sponsors.html", "type": "custom" }, { "url": "https://github.com/sebastianbergmann", "type": "github" }, { "url": "https://liberapay.com/sebastianbergmann", "type": "liberapay" }, { "url": "https://thanks.dev/u/gh/sebastianbergmann", "type": "thanks_dev" }, { "url": "https://tidelift.com/funding/github/packagist/phpunit/phpunit", "type": "tidelift" } ], "time": "2026-01-27T05:48:37+00:00" }, { "name": "sebastian/cli-parser", "version": "2.0.1", "source": { "type": "git", "url": "https://github.com/sebastianbergmann/cli-parser.git", "reference": "c34583b87e7b7a8055bf6c450c2c77ce32a24084" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/sebastianbergmann/cli-parser/zipball/c34583b87e7b7a8055bf6c450c2c77ce32a24084", "reference": "c34583b87e7b7a8055bf6c450c2c77ce32a24084", "shasum": "" }, "require": { "php": ">=8.1" }, "require-dev": { "phpunit/phpunit": "^10.0" }, "type": "library", "extra": { "branch-alias": { "dev-main": "2.0-dev" } }, "autoload": { "classmap": [ "src/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "BSD-3-Clause" ], "authors": [ { "name": "Sebastian Bergmann", "email": "sebastian@phpunit.de", "role": "lead" } ], "description": "Library for parsing CLI options", "homepage": "https://github.com/sebastianbergmann/cli-parser", "support": { "issues": "https://github.com/sebastianbergmann/cli-parser/issues", "security": "https://github.com/sebastianbergmann/cli-parser/security/policy", "source": "https://github.com/sebastianbergmann/cli-parser/tree/2.0.1" }, "funding": [ { "url": "https://github.com/sebastianbergmann", "type": "github" } ], "time": "2024-03-02T07:12:49+00:00" }, { "name": "sebastian/code-unit", "version": "2.0.0", "source": { "type": "git", "url": "https://github.com/sebastianbergmann/code-unit.git", "reference": "a81fee9eef0b7a76af11d121767abc44c104e503" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/sebastianbergmann/code-unit/zipball/a81fee9eef0b7a76af11d121767abc44c104e503", "reference": "a81fee9eef0b7a76af11d121767abc44c104e503", "shasum": "" }, "require": { "php": ">=8.1" }, "require-dev": { "phpunit/phpunit": "^10.0" }, "type": "library", "extra": { "branch-alias": { "dev-main": "2.0-dev" } }, "autoload": { "classmap": [ "src/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "BSD-3-Clause" ], "authors": [ { "name": "Sebastian Bergmann", "email": "sebastian@phpunit.de", "role": "lead" } ], "description": "Collection of value objects that represent the PHP code units", "homepage": "https://github.com/sebastianbergmann/code-unit", "support": { "issues": "https://github.com/sebastianbergmann/code-unit/issues", "source": "https://github.com/sebastianbergmann/code-unit/tree/2.0.0" }, "funding": [ { "url": "https://github.com/sebastianbergmann", "type": "github" } ], "time": "2023-02-03T06:58:43+00:00" }, { "name": "sebastian/code-unit-reverse-lookup", "version": "3.0.0", "source": { "type": "git", "url": "https://github.com/sebastianbergmann/code-unit-reverse-lookup.git", "reference": "5e3a687f7d8ae33fb362c5c0743794bbb2420a1d" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/sebastianbergmann/code-unit-reverse-lookup/zipball/5e3a687f7d8ae33fb362c5c0743794bbb2420a1d", "reference": "5e3a687f7d8ae33fb362c5c0743794bbb2420a1d", "shasum": "" }, "require": { "php": ">=8.1" }, "require-dev": { "phpunit/phpunit": "^10.0" }, "type": "library", "extra": { "branch-alias": { "dev-main": "3.0-dev" } }, "autoload": { "classmap": [ "src/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "BSD-3-Clause" ], "authors": [ { "name": "Sebastian Bergmann", "email": "sebastian@phpunit.de" } ], "description": "Looks up which function or method a line of code belongs to", "homepage": "https://github.com/sebastianbergmann/code-unit-reverse-lookup/", "support": { "issues": "https://github.com/sebastianbergmann/code-unit-reverse-lookup/issues", "source": "https://github.com/sebastianbergmann/code-unit-reverse-lookup/tree/3.0.0" }, "funding": [ { "url": "https://github.com/sebastianbergmann", "type": "github" } ], "time": "2023-02-03T06:59:15+00:00" }, { "name": "sebastian/comparator", "version": "5.0.5", "source": { "type": "git", "url": "https://github.com/sebastianbergmann/comparator.git", "reference": "55dfef806eb7dfeb6e7a6935601fef866f8ca48d" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/sebastianbergmann/comparator/zipball/55dfef806eb7dfeb6e7a6935601fef866f8ca48d", "reference": "55dfef806eb7dfeb6e7a6935601fef866f8ca48d", "shasum": "" }, "require": { "ext-dom": "*", "ext-mbstring": "*", "php": ">=8.1", "sebastian/diff": "^5.0", "sebastian/exporter": "^5.0" }, "require-dev": { "phpunit/phpunit": "^10.5" }, "type": "library", "extra": { "branch-alias": { "dev-main": "5.0-dev" } }, "autoload": { "classmap": [ "src/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "BSD-3-Clause" ], "authors": [ { "name": "Sebastian Bergmann", "email": "sebastian@phpunit.de" }, { "name": "Jeff Welch", "email": "whatthejeff@gmail.com" }, { "name": "Volker Dusch", "email": "github@wallbash.com" }, { "name": "Bernhard Schussek", "email": "bschussek@2bepublished.at" } ], "description": "Provides the functionality to compare PHP values for equality", "homepage": "https://github.com/sebastianbergmann/comparator", "keywords": [ "comparator", "compare", "equality" ], "support": { "issues": "https://github.com/sebastianbergmann/comparator/issues", "security": "https://github.com/sebastianbergmann/comparator/security/policy", "source": "https://github.com/sebastianbergmann/comparator/tree/5.0.5" }, "funding": [ { "url": "https://github.com/sebastianbergmann", "type": "github" }, { "url": "https://liberapay.com/sebastianbergmann", "type": "liberapay" }, { "url": "https://thanks.dev/u/gh/sebastianbergmann", "type": "thanks_dev" }, { "url": "https://tidelift.com/funding/github/packagist/sebastian/comparator", "type": "tidelift" } ], "time": "2026-01-24T09:25:16+00:00" }, { "name": "sebastian/complexity", "version": "3.2.0", "source": { "type": "git", "url": "https://github.com/sebastianbergmann/complexity.git", "reference": "68ff824baeae169ec9f2137158ee529584553799" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/sebastianbergmann/complexity/zipball/68ff824baeae169ec9f2137158ee529584553799", "reference": "68ff824baeae169ec9f2137158ee529584553799", "shasum": "" }, "require": { "nikic/php-parser": "^4.18 || ^5.0", "php": ">=8.1" }, "require-dev": { "phpunit/phpunit": "^10.0" }, "type": "library", "extra": { "branch-alias": { "dev-main": "3.2-dev" } }, "autoload": { "classmap": [ "src/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "BSD-3-Clause" ], "authors": [ { "name": "Sebastian Bergmann", "email": "sebastian@phpunit.de", "role": "lead" } ], "description": "Library for calculating the complexity of PHP code units", "homepage": "https://github.com/sebastianbergmann/complexity", "support": { "issues": "https://github.com/sebastianbergmann/complexity/issues", "security": "https://github.com/sebastianbergmann/complexity/security/policy", "source": "https://github.com/sebastianbergmann/complexity/tree/3.2.0" }, "funding": [ { "url": "https://github.com/sebastianbergmann", "type": "github" } ], "time": "2023-12-21T08:37:17+00:00" }, { "name": "sebastian/diff", "version": "5.1.1", "source": { "type": "git", "url": "https://github.com/sebastianbergmann/diff.git", "reference": "c41e007b4b62af48218231d6c2275e4c9b975b2e" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/sebastianbergmann/diff/zipball/c41e007b4b62af48218231d6c2275e4c9b975b2e", "reference": "c41e007b4b62af48218231d6c2275e4c9b975b2e", "shasum": "" }, "require": { "php": ">=8.1" }, "require-dev": { "phpunit/phpunit": "^10.0", "symfony/process": "^6.4" }, "type": "library", "extra": { "branch-alias": { "dev-main": "5.1-dev" } }, "autoload": { "classmap": [ "src/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "BSD-3-Clause" ], "authors": [ { "name": "Sebastian Bergmann", "email": "sebastian@phpunit.de" }, { "name": "Kore Nordmann", "email": "mail@kore-nordmann.de" } ], "description": "Diff implementation", "homepage": "https://github.com/sebastianbergmann/diff", "keywords": [ "diff", "udiff", "unidiff", "unified diff" ], "support": { "issues": "https://github.com/sebastianbergmann/diff/issues", "security": "https://github.com/sebastianbergmann/diff/security/policy", "source": "https://github.com/sebastianbergmann/diff/tree/5.1.1" }, "funding": [ { "url": "https://github.com/sebastianbergmann", "type": "github" } ], "time": "2024-03-02T07:15:17+00:00" }, { "name": "sebastian/environment", "version": "6.1.0", "source": { "type": "git", "url": "https://github.com/sebastianbergmann/environment.git", "reference": "8074dbcd93529b357029f5cc5058fd3e43666984" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/sebastianbergmann/environment/zipball/8074dbcd93529b357029f5cc5058fd3e43666984", "reference": "8074dbcd93529b357029f5cc5058fd3e43666984", "shasum": "" }, "require": { "php": ">=8.1" }, "require-dev": { "phpunit/phpunit": "^10.0" }, "suggest": { "ext-posix": "*" }, "type": "library", "extra": { "branch-alias": { "dev-main": "6.1-dev" } }, "autoload": { "classmap": [ "src/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "BSD-3-Clause" ], "authors": [ { "name": "Sebastian Bergmann", "email": "sebastian@phpunit.de" } ], "description": "Provides functionality to handle HHVM/PHP environments", "homepage": "https://github.com/sebastianbergmann/environment", "keywords": [ "Xdebug", "environment", "hhvm" ], "support": { "issues": "https://github.com/sebastianbergmann/environment/issues", "security": "https://github.com/sebastianbergmann/environment/security/policy", "source": "https://github.com/sebastianbergmann/environment/tree/6.1.0" }, "funding": [ { "url": "https://github.com/sebastianbergmann", "type": "github" } ], "time": "2024-03-23T08:47:14+00:00" }, { "name": "sebastian/exporter", "version": "5.1.4", "source": { "type": "git", "url": "https://github.com/sebastianbergmann/exporter.git", "reference": "0735b90f4da94969541dac1da743446e276defa6" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/sebastianbergmann/exporter/zipball/0735b90f4da94969541dac1da743446e276defa6", "reference": "0735b90f4da94969541dac1da743446e276defa6", "shasum": "" }, "require": { "ext-mbstring": "*", "php": ">=8.1", "sebastian/recursion-context": "^5.0" }, "require-dev": { "phpunit/phpunit": "^10.5" }, "type": "library", "extra": { "branch-alias": { "dev-main": "5.1-dev" } }, "autoload": { "classmap": [ "src/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "BSD-3-Clause" ], "authors": [ { "name": "Sebastian Bergmann", "email": "sebastian@phpunit.de" }, { "name": "Jeff Welch", "email": "whatthejeff@gmail.com" }, { "name": "Volker Dusch", "email": "github@wallbash.com" }, { "name": "Adam Harvey", "email": "aharvey@php.net" }, { "name": "Bernhard Schussek", "email": "bschussek@gmail.com" } ], "description": "Provides the functionality to export PHP variables for visualization", "homepage": "https://www.github.com/sebastianbergmann/exporter", "keywords": [ "export", "exporter" ], "support": { "issues": "https://github.com/sebastianbergmann/exporter/issues", "security": "https://github.com/sebastianbergmann/exporter/security/policy", "source": "https://github.com/sebastianbergmann/exporter/tree/5.1.4" }, "funding": [ { "url": "https://github.com/sebastianbergmann", "type": "github" }, { "url": "https://liberapay.com/sebastianbergmann", "type": "liberapay" }, { "url": "https://thanks.dev/u/gh/sebastianbergmann", "type": "thanks_dev" }, { "url": "https://tidelift.com/funding/github/packagist/sebastian/exporter", "type": "tidelift" } ], "time": "2025-09-24T06:09:11+00:00" }, { "name": "sebastian/global-state", "version": "6.0.2", "source": { "type": "git", "url": "https://github.com/sebastianbergmann/global-state.git", "reference": "987bafff24ecc4c9ac418cab1145b96dd6e9cbd9" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/sebastianbergmann/global-state/zipball/987bafff24ecc4c9ac418cab1145b96dd6e9cbd9", "reference": "987bafff24ecc4c9ac418cab1145b96dd6e9cbd9", "shasum": "" }, "require": { "php": ">=8.1", "sebastian/object-reflector": "^3.0", "sebastian/recursion-context": "^5.0" }, "require-dev": { "ext-dom": "*", "phpunit/phpunit": "^10.0" }, "type": "library", "extra": { "branch-alias": { "dev-main": "6.0-dev" } }, "autoload": { "classmap": [ "src/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "BSD-3-Clause" ], "authors": [ { "name": "Sebastian Bergmann", "email": "sebastian@phpunit.de" } ], "description": "Snapshotting of global state", "homepage": "https://www.github.com/sebastianbergmann/global-state", "keywords": [ "global state" ], "support": { "issues": "https://github.com/sebastianbergmann/global-state/issues", "security": "https://github.com/sebastianbergmann/global-state/security/policy", "source": "https://github.com/sebastianbergmann/global-state/tree/6.0.2" }, "funding": [ { "url": "https://github.com/sebastianbergmann", "type": "github" } ], "time": "2024-03-02T07:19:19+00:00" }, { "name": "sebastian/lines-of-code", "version": "2.0.2", "source": { "type": "git", "url": "https://github.com/sebastianbergmann/lines-of-code.git", "reference": "856e7f6a75a84e339195d48c556f23be2ebf75d0" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/sebastianbergmann/lines-of-code/zipball/856e7f6a75a84e339195d48c556f23be2ebf75d0", "reference": "856e7f6a75a84e339195d48c556f23be2ebf75d0", "shasum": "" }, "require": { "nikic/php-parser": "^4.18 || ^5.0", "php": ">=8.1" }, "require-dev": { "phpunit/phpunit": "^10.0" }, "type": "library", "extra": { "branch-alias": { "dev-main": "2.0-dev" } }, "autoload": { "classmap": [ "src/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "BSD-3-Clause" ], "authors": [ { "name": "Sebastian Bergmann", "email": "sebastian@phpunit.de", "role": "lead" } ], "description": "Library for counting the lines of code in PHP source code", "homepage": "https://github.com/sebastianbergmann/lines-of-code", "support": { "issues": "https://github.com/sebastianbergmann/lines-of-code/issues", "security": "https://github.com/sebastianbergmann/lines-of-code/security/policy", "source": "https://github.com/sebastianbergmann/lines-of-code/tree/2.0.2" }, "funding": [ { "url": "https://github.com/sebastianbergmann", "type": "github" } ], "time": "2023-12-21T08:38:20+00:00" }, { "name": "sebastian/object-enumerator", "version": "5.0.0", "source": { "type": "git", "url": "https://github.com/sebastianbergmann/object-enumerator.git", "reference": "202d0e344a580d7f7d04b3fafce6933e59dae906" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/sebastianbergmann/object-enumerator/zipball/202d0e344a580d7f7d04b3fafce6933e59dae906", "reference": "202d0e344a580d7f7d04b3fafce6933e59dae906", "shasum": "" }, "require": { "php": ">=8.1", "sebastian/object-reflector": "^3.0", "sebastian/recursion-context": "^5.0" }, "require-dev": { "phpunit/phpunit": "^10.0" }, "type": "library", "extra": { "branch-alias": { "dev-main": "5.0-dev" } }, "autoload": { "classmap": [ "src/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "BSD-3-Clause" ], "authors": [ { "name": "Sebastian Bergmann", "email": "sebastian@phpunit.de" } ], "description": "Traverses array structures and object graphs to enumerate all referenced objects", "homepage": "https://github.com/sebastianbergmann/object-enumerator/", "support": { "issues": "https://github.com/sebastianbergmann/object-enumerator/issues", "source": "https://github.com/sebastianbergmann/object-enumerator/tree/5.0.0" }, "funding": [ { "url": "https://github.com/sebastianbergmann", "type": "github" } ], "time": "2023-02-03T07:08:32+00:00" }, { "name": "sebastian/object-reflector", "version": "3.0.0", "source": { "type": "git", "url": "https://github.com/sebastianbergmann/object-reflector.git", "reference": "24ed13d98130f0e7122df55d06c5c4942a577957" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/sebastianbergmann/object-reflector/zipball/24ed13d98130f0e7122df55d06c5c4942a577957", "reference": "24ed13d98130f0e7122df55d06c5c4942a577957", "shasum": "" }, "require": { "php": ">=8.1" }, "require-dev": { "phpunit/phpunit": "^10.0" }, "type": "library", "extra": { "branch-alias": { "dev-main": "3.0-dev" } }, "autoload": { "classmap": [ "src/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "BSD-3-Clause" ], "authors": [ { "name": "Sebastian Bergmann", "email": "sebastian@phpunit.de" } ], "description": "Allows reflection of object attributes, including inherited and non-public ones", "homepage": "https://github.com/sebastianbergmann/object-reflector/", "support": { "issues": "https://github.com/sebastianbergmann/object-reflector/issues", "source": "https://github.com/sebastianbergmann/object-reflector/tree/3.0.0" }, "funding": [ { "url": "https://github.com/sebastianbergmann", "type": "github" } ], "time": "2023-02-03T07:06:18+00:00" }, { "name": "sebastian/recursion-context", "version": "5.0.1", "source": { "type": "git", "url": "https://github.com/sebastianbergmann/recursion-context.git", "reference": "47e34210757a2f37a97dcd207d032e1b01e64c7a" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/sebastianbergmann/recursion-context/zipball/47e34210757a2f37a97dcd207d032e1b01e64c7a", "reference": "47e34210757a2f37a97dcd207d032e1b01e64c7a", "shasum": "" }, "require": { "php": ">=8.1" }, "require-dev": { "phpunit/phpunit": "^10.5" }, "type": "library", "extra": { "branch-alias": { "dev-main": "5.0-dev" } }, "autoload": { "classmap": [ "src/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "BSD-3-Clause" ], "authors": [ { "name": "Sebastian Bergmann", "email": "sebastian@phpunit.de" }, { "name": "Jeff Welch", "email": "whatthejeff@gmail.com" }, { "name": "Adam Harvey", "email": "aharvey@php.net" } ], "description": "Provides functionality to recursively process PHP variables", "homepage": "https://github.com/sebastianbergmann/recursion-context", "support": { "issues": "https://github.com/sebastianbergmann/recursion-context/issues", "security": "https://github.com/sebastianbergmann/recursion-context/security/policy", "source": "https://github.com/sebastianbergmann/recursion-context/tree/5.0.1" }, "funding": [ { "url": "https://github.com/sebastianbergmann", "type": "github" }, { "url": "https://liberapay.com/sebastianbergmann", "type": "liberapay" }, { "url": "https://thanks.dev/u/gh/sebastianbergmann", "type": "thanks_dev" }, { "url": "https://tidelift.com/funding/github/packagist/sebastian/recursion-context", "type": "tidelift" } ], "time": "2025-08-10T07:50:56+00:00" }, { "name": "sebastian/type", "version": "4.0.0", "source": { "type": "git", "url": "https://github.com/sebastianbergmann/type.git", "reference": "462699a16464c3944eefc02ebdd77882bd3925bf" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/sebastianbergmann/type/zipball/462699a16464c3944eefc02ebdd77882bd3925bf", "reference": "462699a16464c3944eefc02ebdd77882bd3925bf", "shasum": "" }, "require": { "php": ">=8.1" }, "require-dev": { "phpunit/phpunit": "^10.0" }, "type": "library", "extra": { "branch-alias": { "dev-main": "4.0-dev" } }, "autoload": { "classmap": [ "src/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "BSD-3-Clause" ], "authors": [ { "name": "Sebastian Bergmann", "email": "sebastian@phpunit.de", "role": "lead" } ], "description": "Collection of value objects that represent the types of the PHP type system", "homepage": "https://github.com/sebastianbergmann/type", "support": { "issues": "https://github.com/sebastianbergmann/type/issues", "source": "https://github.com/sebastianbergmann/type/tree/4.0.0" }, "funding": [ { "url": "https://github.com/sebastianbergmann", "type": "github" } ], "time": "2023-02-03T07:10:45+00:00" }, { "name": "sebastian/version", "version": "4.0.1", "source": { "type": "git", "url": "https://github.com/sebastianbergmann/version.git", "reference": "c51fa83a5d8f43f1402e3f32a005e6262244ef17" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/sebastianbergmann/version/zipball/c51fa83a5d8f43f1402e3f32a005e6262244ef17", "reference": "c51fa83a5d8f43f1402e3f32a005e6262244ef17", "shasum": "" }, "require": { "php": ">=8.1" }, "type": "library", "extra": { "branch-alias": { "dev-main": "4.0-dev" } }, "autoload": { "classmap": [ "src/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "BSD-3-Clause" ], "authors": [ { "name": "Sebastian Bergmann", "email": "sebastian@phpunit.de", "role": "lead" } ], "description": "Library that helps with managing the version number of Git-hosted PHP projects", "homepage": "https://github.com/sebastianbergmann/version", "support": { "issues": "https://github.com/sebastianbergmann/version/issues", "source": "https://github.com/sebastianbergmann/version/tree/4.0.1" }, "funding": [ { "url": "https://github.com/sebastianbergmann", "type": "github" } ], "time": "2023-02-07T11:34:05+00:00" }, { "name": "theseer/tokenizer", "version": "1.3.1", "source": { "type": "git", "url": "https://github.com/theseer/tokenizer.git", "reference": "b7489ce515e168639d17feec34b8847c326b0b3c" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/theseer/tokenizer/zipball/b7489ce515e168639d17feec34b8847c326b0b3c", "reference": "b7489ce515e168639d17feec34b8847c326b0b3c", "shasum": "" }, "require": { "ext-dom": "*", "ext-tokenizer": "*", "ext-xmlwriter": "*", "php": "^7.2 || ^8.0" }, "type": "library", "autoload": { "classmap": [ "src/" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "BSD-3-Clause" ], "authors": [ { "name": "Arne Blankerts", "email": "arne@blankerts.de", "role": "Developer" } ], "description": "A small library for converting tokenized PHP source code into XML and potentially other formats", "support": { "issues": "https://github.com/theseer/tokenizer/issues", "source": "https://github.com/theseer/tokenizer/tree/1.3.1" }, "funding": [ { "url": "https://github.com/theseer", "type": "github" } ], "time": "2025-11-17T20:03:58+00:00" } ], "aliases": [], "minimum-stability": "stable", "stability-flags": {}, "prefer-stable": false, "prefer-lowest": false, "platform": { "php": "^8.1", "ext-json": "*", "ext-mbstring": "*" }, "platform-dev": {}, "plugin-api-version": "2.9.0" } php-core-1.4.0/phpunit.xml000066400000000000000000000010271514530607400154470ustar00rootroot00000000000000 tests src php-core-1.4.0/src/000077500000000000000000000000001514530607400140255ustar00rootroot00000000000000php-core-1.4.0/src/Client/000077500000000000000000000000001514530607400152435ustar00rootroot00000000000000php-core-1.4.0/src/Client/SharpApiClient.php000066400000000000000000000451221514530607400206260ustar00rootroot00000000000000setApiKey($apiKey); if (empty($this->apiKey)) { throw new InvalidArgumentException('API key is required.'); } $this->setApiBaseUrl($apiBaseUrl ?? 'https://sharpapi.com/api/v1'); $this->setUserAgent($userAgent ?? 'SharpAPIPHPAgent/1.3.0'); $this->client = new Client([ 'headers' => $this->getHeaders(), ]); $this->rateLimiter = new SlidingWindowRateLimiter($this->requestsPerMinute); } public function getApiBaseUrl(): string { return $this->apiBaseUrl; } public function setApiBaseUrl(string $apiBaseUrl): void { $this->apiBaseUrl = $apiBaseUrl; } public function getApiKey(): string { return $this->apiKey; } public function setApiKey(string $apiKey): void { $this->apiKey = $apiKey; } public function getUserAgent(): string { return $this->userAgent; } public function setUserAgent(string $userAgent): void { $this->userAgent = $userAgent; } public function getApiJobStatusPollingInterval(): int { return $this->apiJobStatusPollingInterval; } /** * @api */ public function setApiJobStatusPollingInterval(int $apiJobStatusPollingInterval): void { $this->apiJobStatusPollingInterval = $apiJobStatusPollingInterval; } public function isUseCustomInterval(): bool { return $this->useCustomInterval; } /** * @api */ public function setUseCustomInterval(bool $useCustomInterval): void { $this->useCustomInterval = $useCustomInterval; } public function getApiJobStatusPollingWait(): int { return $this->apiJobStatusPollingWait; } /** * @api */ public function setApiJobStatusPollingWait(int $apiJobStatusPollingWait): void { $this->apiJobStatusPollingWait = $apiJobStatusPollingWait; } /** * @return int|null The rate limit (requests per window) from the last API response, or null if not yet known. * * @api */ public function getRateLimitLimit(): ?int { return $this->rateLimitLimit; } /** * @return int|null The remaining requests in the current window from the last API response, or null if not yet known. * * @api */ public function getRateLimitRemaining(): ?int { return $this->rateLimitRemaining; } /** * @return int Maximum number of automatic retries on HTTP 429. * * @api */ public function getMaxRetryOnRateLimit(): int { return $this->maxRetryOnRateLimit; } /** * @param int $maxRetryOnRateLimit Maximum number of automatic retries on HTTP 429. * * @api */ public function setMaxRetryOnRateLimit(int $maxRetryOnRateLimit): void { $this->maxRetryOnRateLimit = $maxRetryOnRateLimit; } /** * @return int When remaining requests fall at or below this threshold, polling intervals are increased. * * @api */ public function getRateLimitLowThreshold(): int { return $this->rateLimitLowThreshold; } /** * @param int $rateLimitLowThreshold When remaining requests fall at or below this threshold, polling intervals are increased. * * @api */ public function setRateLimitLowThreshold(int $rateLimitLowThreshold): void { $this->rateLimitLowThreshold = $rateLimitLowThreshold; } /** * @api */ public function getRequestsPerMinute(): int { return $this->requestsPerMinute; } /** * @api */ public function setRequestsPerMinute(int $rpm): void { $this->requestsPerMinute = $rpm; if ($rpm > 0) { $this->rateLimiter = new SlidingWindowRateLimiter($rpm); } else { $this->rateLimiter = null; } } /** * @api */ public function getRateLimiter(): ?SlidingWindowRateLimiter { return $this->rateLimiter; } /** * Returns the current rate limit state for external caching. * * @return array{limit: int|null, remaining: int|null} * * @api */ public function getRateLimitState(): array { return [ 'limit' => $this->rateLimitLimit, 'remaining' => $this->rateLimitRemaining, ]; } /** * Restores rate limit state from an external cache. * * @param array{limit?: int|null, remaining?: int|null} $state * * @api */ public function setRateLimitState(array $state): void { if (isset($state['limit'])) { $this->rateLimitLimit = $state['limit']; } if (isset($state['remaining'])) { $this->rateLimitRemaining = $state['remaining']; } } /** * Checks if a request can be made based on server-reported remaining quota. * * @api */ public function canMakeRequest(): bool { return $this->rateLimitRemaining === null || $this->rateLimitRemaining > 0; } /** * Sends a ping request to the API to check its availability and retrieve the current timestamp. * * @return array|null * @api */ public function ping(): ?array { $this->throttleRequests = false; try { $response = $this->makeRequest('GET', '/ping'); return json_decode($response->getBody()->__toString(), true); } finally { $this->throttleRequests = true; } } /** * Retrieves the subscription quota information. * * @return SubscriptionInfo|null A DTO containing subscription details. * * @api */ public function quota(): ?SubscriptionInfo { $this->throttleRequests = false; try { $response = $this->makeRequest('GET', '/quota'); $info = json_decode($response->getBody()->__toString(), true); return new SubscriptionInfo( timestamp: new Carbon($info['timestamp']), on_trial: $info['on_trial'], trial_ends: new Carbon($info['trial_ends']), subscribed: $info['subscribed'], current_subscription_start: new Carbon($info['current_subscription_start']), current_subscription_end: new Carbon($info['current_subscription_end']), current_subscription_reset: new Carbon($info['current_subscription_reset']), subscription_words_quota: $info['subscription_words_quota'], subscription_words_used: $info['subscription_words_used'], subscription_words_used_percentage: $info['subscription_words_used_percentage'], requests_per_minute: $info['requests_per_minute'] ); } finally { $this->throttleRequests = true; } } /** * Generic method to make an HTTP request using Guzzle. * * @param string $method The HTTP method (e.g., 'GET', 'POST'). * @param string $url The API endpoint relative to the base URL. * @param array $data Optional request data for POST requests. * @param string|null $filePath Optional file path for file upload. * @return ResponseInterface The Guzzle response object. * * @throws GuzzleException if the request fails. * @throws ApiException */ protected function makeRequest( string $method, string $url, array $data = [], ?string $filePath = null ): ResponseInterface { $options = [ 'headers' => $this->getHeaders(), ]; if ($method === 'POST') { if (is_string($filePath) && strlen($filePath)) { $multipart = []; // Attach file $multipart[] = [ 'name' => 'file', 'contents' => file_get_contents($filePath), 'filename' => basename($filePath), ]; // Add each key-value pair from $data as a form-data field foreach ($data as $key => $value) { $multipart[] = [ 'name' => $key, 'contents' => is_array($value) ? json_encode($value) : $value, ]; } $options['multipart'] = $multipart; } else { $options['json'] = $data; } } return $this->executeWithRateLimitRetry($method, $this->getApiBaseUrl().$url, $options); } /** * Makes a GET request with proper query parameter handling. * * This method was added to properly support GET requests with query parameters * for utility endpoints (airports, web scraping, skills, job positions). * Unlike the generic makeRequest() method which only handles POST data, * this method correctly passes query parameters using Guzzle's 'query' option. * * @param string $url The API endpoint relative to the base URL. * @param array $queryParams Query parameters to append to the URL. * @return ResponseInterface The Guzzle response object. * * @throws GuzzleException if the request fails. * @throws ApiException * * @api */ protected function makeGetRequest( string $url, array $queryParams = [] ): ResponseInterface { $options = [ 'headers' => $this->getHeaders(), ]; if (! empty($queryParams)) { $options['query'] = $queryParams; } return $this->executeWithRateLimitRetry('GET', $this->getApiBaseUrl().$url, $options); } /** * @api */ protected function parseStatusUrl(ResponseInterface $response): mixed { return json_decode($response->getBody()->__toString(), true)['status_url']; } /** * Polls the API for job results, waiting for the job status to be `SUCCESS` or `FAILED`. * * @param string $statusUrl The URL to check the job status. * @return SharpApiJob A DTO representing the completed job with its result. * * @throws ApiException|GuzzleException if the job fails or polling times out. * * @api */ public function fetchResults(string $statusUrl): SharpApiJob { $waitingTime = 0; do { $this->rateLimiter?->waitIfNeeded(); try { $response = $this->client->request('GET', $statusUrl, ['headers' => $this->getHeaders()]); } catch (ClientException $e) { if ($e->getResponse()->getStatusCode() === 429) { $retryResponse = $e->getResponse(); $this->extractRateLimitHeaders($retryResponse); $retryDelay = isset($retryResponse->getHeader('Retry-After')[0]) ? (int) $retryResponse->getHeader('Retry-After')[0] : $this->getApiJobStatusPollingInterval(); $waitingTime += $retryDelay; if ($waitingTime >= $this->getApiJobStatusPollingWait()) { throw new ApiException('Polling timed out while waiting for job completion (rate limited).', 429); } sleep($retryDelay); continue; } throw $e; } $this->extractRateLimitHeaders($response); $jobStatus = json_decode($response->getBody()->__toString(), true)['data']['attributes']; if ($jobStatus['status'] === SharpApiJobStatusEnum::SUCCESS->value || $jobStatus['status'] === SharpApiJobStatusEnum::FAILED->value) { break; } $retryAfter = isset($response->getHeader('Retry-After')[0]) ? (int) $response->getHeader('Retry-After')[0] : $this->getApiJobStatusPollingInterval(); if ($this->isUseCustomInterval()) { $retryAfter = $this->getApiJobStatusPollingInterval(); } $retryAfter = $this->adjustIntervalForRateLimit($retryAfter); $waitingTime += $retryAfter; if ($waitingTime >= $this->getApiJobStatusPollingWait()) { throw new ApiException('Polling timed out while waiting for job completion.'); } sleep($retryAfter); } while (true); $data = json_decode($response->getBody()->__toString(), true)['data']; $url = Url::fromString($statusUrl); $result = count($url->getSegments()) == 5 ? (object) json_decode($data['attributes']['result']) : (object) $data['attributes']['result']; return new SharpApiJob( id: $data['id'], type: $data['attributes']['type'], status: $data['attributes']['status'], result: $result ?? null ); } /** * Extracts rate-limit headers from an API response and stores them. * * @param ResponseInterface $response The API response. */ protected function extractRateLimitHeaders(ResponseInterface $response): void { $limit = $response->getHeader('X-RateLimit-Limit'); if (! empty($limit)) { $this->rateLimitLimit = (int) $limit[0]; $this->rateLimiter?->adaptFromServerLimit($this->rateLimitLimit); } $remaining = $response->getHeader('X-RateLimit-Remaining'); if (! empty($remaining)) { $this->rateLimitRemaining = (int) $remaining[0]; } } /** * Adjusts a polling interval when the rate-limit remaining count is low. * * When remaining is at or below the threshold, the base interval is multiplied * by a scaling factor that increases as remaining approaches 0. * * @param int $baseInterval The original polling interval in seconds. * @return int The adjusted interval. */ protected function adjustIntervalForRateLimit(int $baseInterval): int { if ($this->rateLimitRemaining === null || $this->rateLimitRemaining > $this->rateLimitLowThreshold) { return $baseInterval; } // Scale: 2x at threshold, increasing as remaining approaches 0 $scale = 2 + ($this->rateLimitLowThreshold - $this->rateLimitRemaining); return $baseInterval * $scale; } /** * Wraps an HTTP request with automatic 429 retry logic and proactive throttling. * * On success, rate-limit headers are extracted. On HTTP 429, the request is * retried after sleeping for the Retry-After duration, up to maxRetryOnRateLimit times. * All other client exceptions are re-thrown. * * @param string $method The HTTP method. * @param string $url The full request URL. * @param array $options Guzzle request options. * @return ResponseInterface The successful response. * * @throws ApiException if retries are exhausted on 429. * @throws GuzzleException for non-429 failures. */ protected function executeWithRateLimitRetry(string $method, string $url, array $options): ResponseInterface { if ($this->throttleRequests) { $this->rateLimiter?->waitIfNeeded(); } $attempts = 0; while (true) { try { $response = $this->client->request($method, $url, $options); $this->extractRateLimitHeaders($response); return $response; } catch (ClientException $e) { if ($e->getResponse()->getStatusCode() !== 429) { throw $e; } $attempts++; $retryResponse = $e->getResponse(); $this->extractRateLimitHeaders($retryResponse); if ($attempts >= $this->maxRetryOnRateLimit) { throw new ApiException( 'Rate limit exceeded. Retries exhausted after '.$attempts.' attempts.', 429 ); } $retryAfter = isset($retryResponse->getHeader('Retry-After')[0]) ? (int) $retryResponse->getHeader('Retry-After')[0] : 1; sleep($retryAfter); if ($this->throttleRequests) { $this->rateLimiter?->waitIfNeeded(); } } } } /** * Prepares the headers for API requests. * * @return array An associative array of headers. */ protected function getHeaders(): array { return [ 'Authorization' => 'Bearer '.$this->getApiKey(), 'Accept' => 'application/json', 'User-Agent' => $this->getUserAgent(), ]; } } php-core-1.4.0/src/DTO/000077500000000000000000000000001514530607400144535ustar00rootroot00000000000000php-core-1.4.0/src/DTO/SharpApiJob.php000066400000000000000000000037351514530607400173360ustar00rootroot00000000000000 $this->id, 'type' => $this->type, 'status' => $this->status, 'result' => $this->result, ]; } /** * Returns the job result as a prettified JSON string. * * @api * * @return string|bool|null The JSON-encoded result, or null if no result. */ public function getResultJson(): string|bool|null { return $this->result ? json_encode($this->result, JSON_PRETTY_PRINT) : null; } /** * Returns the job result as a PHP associative array. * * @api * * @return array|null The result as an associative array, or null if no result. */ public function getResultArray(): ?array { return $this->result ? (array) $this->result : null; } /** * Returns the job result as a PHP stdClass object. * * @api * * @return stdClass|null The result as an object, or null if no result. */ public function getResultObject(): ?stdClass { return $this->result; } } php-core-1.4.0/src/DTO/SubscriptionInfo.php000066400000000000000000000055711514530607400204740ustar00rootroot00000000000000 $this->timestamp->toDateTimeString(), 'on_trial' => $this->on_trial, 'trial_ends' => $this->trial_ends->toDateTimeString(), 'subscribed' => $this->subscribed, 'current_subscription_start' => $this->current_subscription_start->toDateTimeString(), 'current_subscription_end' => $this->current_subscription_end->toDateTimeString(), 'current_subscription_reset' => $this->current_subscription_reset->toDateTimeString(), 'subscription_words_quota' => $this->subscription_words_quota, 'subscription_words_used' => $this->subscription_words_used, 'subscription_words_used_percentage' => $this->subscription_words_used_percentage, 'requests_per_minute' => $this->requests_per_minute, ]; } } php-core-1.4.0/src/Enums/000077500000000000000000000000001514530607400151145ustar00rootroot00000000000000php-core-1.4.0/src/Enums/SharpApiJobStatusEnum.php000066400000000000000000000017311514530607400220220ustar00rootroot00000000000000 'New', self::PENDING => 'Pending', self::FAILED => 'Failed', self::SUCCESS => 'Success', }; } /** * Get a color associated with each status for UI representation. * * @api */ public function color(): string { return match ($this) { self::NEW => 'gray', self::PENDING => 'yellow', self::FAILED => 'red', self::SUCCESS => 'green', }; } } php-core-1.4.0/src/Exceptions/000077500000000000000000000000001514530607400161465ustar00rootroot00000000000000php-core-1.4.0/src/Exceptions/ApiException.php000066400000000000000000000002521514530607400212460ustar00rootroot00000000000000maxRequests = max(1, $maxRequests); $this->windowSeconds = max(1, $windowSeconds); } /** * Block until the sliding window has capacity, then record the request. * * @return float Seconds waited (0.0 if no wait was needed) */ public function waitIfNeeded(): float { $waited = 0.0; while (true) { $this->pruneExpired(); if (count($this->timestamps) < $this->maxRequests) { $this->timestamps[] = microtime(true); return $waited; } // Calculate how long until the oldest request expires from the window $oldest = $this->timestamps[0]; $expiresAt = $oldest + $this->windowSeconds; $sleepSeconds = $expiresAt - microtime(true) + 0.05; // 50ms buffer if ($sleepSeconds > 0) { usleep((int) ($sleepSeconds * 1_000_000)); $waited += $sleepSeconds; } } } /** * Check if a request can proceed without waiting. * @api */ public function canProceed(): bool { $this->pruneExpired(); return count($this->timestamps) < $this->maxRequests; } /** * Number of requests remaining in the current window. */ public function remaining(): int { $this->pruneExpired(); return max(0, $this->maxRequests - count($this->timestamps)); } /** * Adopt a higher limit from the server's X-RateLimit-Limit header. * * One-way ratchet: only increases, never decreases below the configured default. * This handles plan upgrades where the server advertises a higher limit. */ public function adaptFromServerLimit(int $serverLimit): void { if ($serverLimit > $this->maxRequests) { $this->maxRequests = $serverLimit; } } public function getMaxRequests(): int { return $this->maxRequests; } public function setMaxRequests(int $maxRequests): void { $this->maxRequests = max(1, $maxRequests); } public function getWindowSeconds(): int { return $this->windowSeconds; } /** * Remove timestamps that have fallen outside the sliding window. */ private function pruneExpired(): void { $cutoff = microtime(true) - $this->windowSeconds; $this->timestamps = array_values( array_filter($this->timestamps, fn (float $ts) => $ts > $cutoff) ); } } php-core-1.4.0/tests/000077500000000000000000000000001514530607400144005ustar00rootroot00000000000000php-core-1.4.0/tests/RateLimitTest.php000066400000000000000000000354471514530607400176600ustar00rootroot00000000000000 $handler]); return new TestableSharpApiClient('test-api-key', $guzzle); } private function jsonBody(array $data): string { return json_encode($data); } private function rateLimitHeaders(int $limit = 100, int $remaining = 99): array { return [ 'X-RateLimit-Limit' => [(string) $limit], 'X-RateLimit-Remaining' => [(string) $remaining], ]; } // ----------------------------------------------------------------------- // extractRateLimitHeaders tests // ----------------------------------------------------------------------- public function testRateLimitHeadersNullBeforeAnyCall(): void { $mock = new MockHandler([]); $client = $this->createClient($mock); $this->assertNull($client->getRateLimitLimit()); $this->assertNull($client->getRateLimitRemaining()); } public function testRateLimitHeadersPopulatedAfterSuccessfulRequest(): void { $mock = new MockHandler([ new Response(200, $this->rateLimitHeaders(60, 58), $this->jsonBody(['ping' => 'pong'])), ]); $client = $this->createClient($mock); $client->ping(); $this->assertSame(60, $client->getRateLimitLimit()); $this->assertSame(58, $client->getRateLimitRemaining()); } public function testRateLimitHeadersUpdateAcrossMultipleCalls(): void { $mock = new MockHandler([ new Response(200, $this->rateLimitHeaders(100, 50), $this->jsonBody(['ping' => 'pong'])), new Response(200, $this->rateLimitHeaders(100, 49), $this->jsonBody(['ping' => 'pong'])), ]); $client = $this->createClient($mock); $client->ping(); $this->assertSame(50, $client->getRateLimitRemaining()); $client->ping(); $this->assertSame(49, $client->getRateLimitRemaining()); } public function testRateLimitHeadersMissingLeavesValuesNull(): void { $mock = new MockHandler([ new Response(200, [], $this->jsonBody(['ping' => 'pong'])), ]); $client = $this->createClient($mock); $client->ping(); $this->assertNull($client->getRateLimitLimit()); $this->assertNull($client->getRateLimitRemaining()); } public function testPartialRateLimitHeadersOnlyLimitPresent(): void { $mock = new MockHandler([ new Response(200, ['X-RateLimit-Limit' => ['100']], $this->jsonBody(['ping' => 'pong'])), ]); $client = $this->createClient($mock); $client->ping(); $this->assertSame(100, $client->getRateLimitLimit()); $this->assertNull($client->getRateLimitRemaining()); } // ----------------------------------------------------------------------- // 429 retry logic tests // ----------------------------------------------------------------------- public function testRetryOn429ThenSucceed(): void { $mock = new MockHandler([ new Response(429, array_merge($this->rateLimitHeaders(100, 0), ['Retry-After' => ['0']]), ''), new Response(200, $this->rateLimitHeaders(100, 99), $this->jsonBody(['ping' => 'pong'])), ]); $client = $this->createClient($mock); $result = $client->ping(); $this->assertSame(['ping' => 'pong'], $result); $this->assertSame(99, $client->getRateLimitRemaining()); } public function testRetryExhaustedThrowsApiException(): void { // Default maxRetryOnRateLimit is 3, so 3 x 429 should exhaust retries $mock = new MockHandler([ new Response(429, ['Retry-After' => ['0']], ''), new Response(429, ['Retry-After' => ['0']], ''), new Response(429, ['Retry-After' => ['0']], ''), ]); $client = $this->createClient($mock); $this->expectException(ApiException::class); $this->expectExceptionCode(429); $this->expectExceptionMessageMatches('/Rate limit exceeded.*3 attempts/'); $client->ping(); } public function testCustomMaxRetryOnRateLimit(): void { // Set max retries to 1: first 429 attempt, then exhausted $mock = new MockHandler([ new Response(429, ['Retry-After' => ['0']], ''), ]); $client = $this->createClient($mock); $client->setMaxRetryOnRateLimit(1); $this->expectException(ApiException::class); $this->expectExceptionCode(429); $this->expectExceptionMessageMatches('/1 attempts/'); $client->ping(); } public function testMultiple429sBeforeSuccess(): void { $mock = new MockHandler([ new Response(429, ['Retry-After' => ['0']], ''), new Response(429, ['Retry-After' => ['0']], ''), new Response(200, $this->rateLimitHeaders(100, 97), $this->jsonBody(['ping' => 'pong'])), ]); $client = $this->createClient($mock); $result = $client->ping(); $this->assertSame(['ping' => 'pong'], $result); $this->assertSame(97, $client->getRateLimitRemaining()); } public function testNon429ClientExceptionIsNotRetried(): void { $mock = new MockHandler([ new Response(403, [], $this->jsonBody(['error' => 'Forbidden'])), ]); $client = $this->createClient($mock); $this->expectException(\GuzzleHttp\Exception\ClientException::class); $client->ping(); } public function testRateLimitHeadersExtractedFrom429Response(): void { $mock = new MockHandler([ new Response(429, array_merge($this->rateLimitHeaders(100, 0), ['Retry-After' => ['0']]), ''), new Response(200, $this->rateLimitHeaders(100, 100), $this->jsonBody(['ping' => 'pong'])), ]); $client = $this->createClient($mock); $client->ping(); // After success, headers from the 200 response should be stored $this->assertSame(100, $client->getRateLimitLimit()); $this->assertSame(100, $client->getRateLimitRemaining()); } // ----------------------------------------------------------------------- // makeGetRequest path (used by utility endpoints) // ----------------------------------------------------------------------- public function testMakeGetRequestExtractsRateLimitHeaders(): void { $mock = new MockHandler([ new Response(200, $this->rateLimitHeaders(60, 42), $this->jsonBody(['data' => []])), ]); $client = $this->createClient($mock); $client->testMakeGetRequest('/airports', ['per_page' => 5]); $this->assertSame(60, $client->getRateLimitLimit()); $this->assertSame(42, $client->getRateLimitRemaining()); } public function testMakeGetRequestRetries429(): void { $mock = new MockHandler([ new Response(429, ['Retry-After' => ['0']], ''), new Response(200, $this->rateLimitHeaders(60, 59), $this->jsonBody(['data' => []])), ]); $client = $this->createClient($mock); $response = $client->testMakeGetRequest('/airports'); $body = json_decode($response->getBody()->__toString(), true); $this->assertSame(['data' => []], $body); $this->assertSame(59, $client->getRateLimitRemaining()); } // ----------------------------------------------------------------------- // Getter/setter round-trip tests // ----------------------------------------------------------------------- public function testMaxRetryOnRateLimitGetterSetter(): void { $mock = new MockHandler([]); $client = $this->createClient($mock); $this->assertSame(3, $client->getMaxRetryOnRateLimit()); $client->setMaxRetryOnRateLimit(7); $this->assertSame(7, $client->getMaxRetryOnRateLimit()); } public function testRateLimitLowThresholdGetterSetter(): void { $mock = new MockHandler([]); $client = $this->createClient($mock); $this->assertSame(3, $client->getRateLimitLowThreshold()); $client->setRateLimitLowThreshold(15); $this->assertSame(15, $client->getRateLimitLowThreshold()); } // ----------------------------------------------------------------------- // adjustIntervalForRateLimit (tested via fetchResults polling) // ----------------------------------------------------------------------- public function testAdaptivePollingScalesIntervalWhenRemainingLow(): void { // Use reflection to test the private adjustIntervalForRateLimit method directly $mock = new MockHandler([]); $client = $this->createClient($mock); $client->setRateLimitLowThreshold(5); $ref = new \ReflectionClass(\SharpAPI\Core\Client\SharpApiClient::class); // Set rateLimitRemaining to 3 (below threshold of 5) $remainingProp = $ref->getProperty('rateLimitRemaining'); $remainingProp->setAccessible(true); $remainingProp->setValue($client, 3); $method = $ref->getMethod('adjustIntervalForRateLimit'); $method->setAccessible(true); // Scale = 2 + (threshold - remaining) = 2 + (5 - 3) = 4 // Result = baseInterval * 4 = 10 * 4 = 40 $result = $method->invoke($client, 10); $this->assertSame(40, $result); } public function testAdaptivePollingNoScaleWhenRemainingAboveThreshold(): void { $mock = new MockHandler([]); $client = $this->createClient($mock); $client->setRateLimitLowThreshold(5); $ref = new \ReflectionClass(\SharpAPI\Core\Client\SharpApiClient::class); $remainingProp = $ref->getProperty('rateLimitRemaining'); $remainingProp->setAccessible(true); $remainingProp->setValue($client, 50); $method = $ref->getMethod('adjustIntervalForRateLimit'); $method->setAccessible(true); // remaining (50) > threshold (5), so no scaling $result = $method->invoke($client, 10); $this->assertSame(10, $result); } public function testAdaptivePollingNoScaleWhenRemainingIsNull(): void { $mock = new MockHandler([]); $client = $this->createClient($mock); $client->setRateLimitLowThreshold(5); $ref = new \ReflectionClass(\SharpAPI\Core\Client\SharpApiClient::class); $method = $ref->getMethod('adjustIntervalForRateLimit'); $method->setAccessible(true); // remaining is null by default, so no scaling $result = $method->invoke($client, 10); $this->assertSame(10, $result); } public function testAdaptivePollingAtExactThreshold(): void { $mock = new MockHandler([]); $client = $this->createClient($mock); $client->setRateLimitLowThreshold(5); $ref = new \ReflectionClass(\SharpAPI\Core\Client\SharpApiClient::class); $remainingProp = $ref->getProperty('rateLimitRemaining'); $remainingProp->setAccessible(true); $remainingProp->setValue($client, 5); $method = $ref->getMethod('adjustIntervalForRateLimit'); $method->setAccessible(true); // At threshold: scale = 2 + (5 - 5) = 2 // Result = 10 * 2 = 20 $result = $method->invoke($client, 10); $this->assertSame(20, $result); } public function testAdaptivePollingAtZeroRemaining(): void { $mock = new MockHandler([]); $client = $this->createClient($mock); $client->setRateLimitLowThreshold(5); $ref = new \ReflectionClass(\SharpAPI\Core\Client\SharpApiClient::class); $remainingProp = $ref->getProperty('rateLimitRemaining'); $remainingProp->setAccessible(true); $remainingProp->setValue($client, 0); $method = $ref->getMethod('adjustIntervalForRateLimit'); $method->setAccessible(true); // At zero: scale = 2 + (5 - 0) = 7 // Result = 10 * 7 = 70 $result = $method->invoke($client, 10); $this->assertSame(70, $result); } // ----------------------------------------------------------------------- // fetchResults 429 handling in polling loop // ----------------------------------------------------------------------- public function testFetchResults429RetryInPollingLoop(): void { // First: make a successful request to establish client // Then test fetchResults polling with a 429 mid-poll $mock = new MockHandler([ // fetchResults first poll: 429 new Response(429, array_merge($this->rateLimitHeaders(100, 0), ['Retry-After' => ['0']]), ''), // fetchResults retry: pending new Response(200, $this->rateLimitHeaders(100, 99), $this->jsonBody([ 'data' => [ 'id' => 'job-123', 'attributes' => [ 'type' => 'test', 'status' => 'success', 'result' => json_encode(['pass' => true]), ], ], ])), ]); $client = $this->createClient($mock); $client->setApiJobStatusPollingInterval(0); $result = $client->fetchResults('https://sharpapi.com/api/v1/dispatch/job/job-123/result'); $this->assertSame('job-123', $result->id); $this->assertSame('success', $result->status); } public function testFetchResultsPollingTimeout(): void { // Return "pending" every time — the client should eventually time out $mock = new MockHandler([ new Response(200, ['Retry-After' => ['0']], $this->jsonBody([ 'data' => ['id' => 'job-1', 'attributes' => ['type' => 'test', 'status' => 'pending', 'result' => null]], ])), ]); $client = $this->createClient($mock); $client->setApiJobStatusPollingInterval(0); $client->setApiJobStatusPollingWait(0); // immediate timeout $this->expectException(ApiException::class); $this->expectExceptionMessageMatches('/timed out/i'); $client->fetchResults('https://sharpapi.com/api/v1/dispatch/job/job-1/result'); } // ----------------------------------------------------------------------- // User-Agent version check // ----------------------------------------------------------------------- public function testDefaultUserAgentContainsVersion130(): void { $mock = new MockHandler([]); $client = $this->createClient($mock); $this->assertStringContainsString('1.3.0', $client->getUserAgent()); } } php-core-1.4.0/tests/TestableSharpApiClient.php000066400000000000000000000023141514530607400214430ustar00rootroot00000000000000getProperty('client'); $prop->setAccessible(true); $prop->setValue($this, $mockClient); } /** * Expose makeRequest for testing. */ public function testMakeRequest( string $method, string $url, array $data = [], ?string $filePath = null ): \Psr\Http\Message\ResponseInterface { return $this->makeRequest($method, $url, $data, $filePath); } /** * Expose makeGetRequest for testing. */ public function testMakeGetRequest( string $url, array $queryParams = [] ): \Psr\Http\Message\ResponseInterface { return $this->makeGetRequest($url, $queryParams); } }