Skip to content

docs: explain the HTTP client adapter requirement #278

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
zahidgh wants to merge 2 commits into
base: trunk
Choose a base branch
from
+16 −0
Open

docs: explain the HTTP client adapter requirement #278

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
78e7060
docs: explain HTTP client adapter requirement
zahidgh Aug 21, 2026
0d4b8dd
Merge remote-tracking branch 'origin/trunk' into codex/resolve-http-c…
zahidgh Aug 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,20 @@ While this project is stewarded by [WordPress AI Team](https://make.wordpress.or
composer require wordpress/php-ai-client
```

### HTTP client adapter

The client uses [HTTPlug](https://httplug.io/) and PSR-18 for HTTP transport. Composer installs the abstraction, but your application must also provide a compatible HTTP client adapter before sending requests. Choose an adapter that fits your application:

```bash
# cURL adapter
composer require php-http/curl-client

# or Guzzle 7 adapter
composer require php-http/guzzle7-adapter
```

If no adapter is available, HTTP client discovery will fail when a provider request is created. Install and configure the adapter in the same application where the PHP AI Client runs; a provider package alone does not supply a transport implementation.

## Code examples

### Text generation using a specific model
Expand Down
2 changes: 2 additions & 0 deletions composer.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,8 @@
"wordpress/ai-provider-for-openai": "^1.0"
},
"suggest": {
"php-http/curl-client": "HTTPlug adapter for cURL HTTP requests",
"php-http/guzzle7-adapter": "HTTPlug adapter for Guzzle 7 HTTP requests",
"wordpress/ai-provider-for-anthropic": "For Anthropic Claude model support",
"wordpress/ai-provider-for-google": "For Google Gemini model support",
"wordpress/ai-provider-for-openai": "For OpenAI GPT model support"
Expand Down
Loading