openai-php/symfony

Symfony Bundle for OpenAI

v0.17.0 2025-10-02 13:32 UTC

Requires

• php: ^8.2.0
• nyholm/psr7: ^1.8.2
• openai-php/client: ^0.17.0
• psr/http-client: ^1.0.3
• psr/http-factory: ^1.1.0
• symfony/config: ^6.4|^7.3|^8.0
• symfony/dependency-injection: ^6.4|^7.3|^8.0
• symfony/http-client: ^6.4|^7.3|^8.0
• symfony/http-kernel: ^6.4|^7.3|^8.0

Requires (Dev)

• laravel/pint: ^1.24.0
• phpstan/phpstan: ^2.1.22
• rector/rector: ^2.1.5
• symfony/framework-bundle: ^6.4|^7.3|^8.0
• symfony/phpunit-bridge: ^6.4.25|^7.3|^8.0

MIT

• Jérôme Tamarelle
• Nuno Maduro

• symfony
• php
• api
• client
• language
• sdk
• processing
• natural
• codex
• GPT-3
• openai
• dall-e

README

OpenAI PHP for Symfony is a community-maintained PHP API client that allows you to interact with the Open AI API. If you or your business relies on this package, it's important to support the developers who have contributed their time and effort to create and maintain this valuable tool:

• Nuno Maduro: github.com/sponsors/nunomaduro
• Sandro Gehri: github.com/sponsors/gehrisandro

Note: This repository contains the integration code of the OpenAI PHP for Symfony. If you want to use the OpenAI PHP client in a framework-agnostic way, take a look at the openai-php/client repository.

Get Started

Requires PHP 8.1+

First, install OpenAI via the Composer package manager:

composer require openai-php/symfony

Next, register the bundle in your config/bundles.php:

return [
    // ...
    OpenAI\Symfony\OpenAIBundle::class => ['all' => true],
]

This will create a .env configuration file in your project, which you can modify to your needs using environment variables:

OPENAI_API_KEY=sk-...
OPENAI_ORGANIZATION=...

For more configuration options, take a look at the Configuration Reference.

Finally, you may use the openai service to access the OpenAI API:

$result = $container->get('openai')->completions()->create([
    'model' => 'gpt-4o-mini',
    'prompt' => 'PHP is',
]);

echo $result['choices'][0]['text']; // an open-source, widely-used, server-side scripting language.

Usage

For usage examples, take a look at the openai-php/client repository.

Configuration Reference

The bundle provides the following configuration options, which you can set in your config/packages/openai.yaml file:

openai:
    api_key: '%env(OPENAI_API_KEY)%' # Your OpenAI API key (required)
    organization: '%env(OPENAI_ORGANIZATION)%' # Your OpenAI organization ID (optional)
    project: 'proj_...' # The project ID (optional)
    base_uri: 'api.openai.com/v1' # The base URI for the OpenAI API (optional)

OpenAI PHP for Symfony is an open-sourced software licensed under the MIT license.