README

OpenAI PHP for Laravel是一个由社区维护的PHP API客户端，允许您与Open AI API交互。如果您或您的业务依赖于此包，那么支持那些为此宝贵工具付出时间和精力的开发者非常重要

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

注意：此存储库包含OpenAI PHP for Laravel的集成代码。如果您想以框架无关的方式使用OpenAI PHP客户端，请查看openai-php/client存储库。

开始使用

需要PHP 8.1+

首先，通过Composer包管理器安装OpenAI

composer require openai-php/laravel

接下来，执行安装命令

php artisan openai:install

这将在您的项目中创建一个config/openai.php配置文件，您可以使用环境变量进行修改以满足您的需求。OpenAI API密钥和组织ID的环境变量已经附加到您的.env文件中。

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

最后，您可以使用OpenAI外观来访问OpenAI API

use OpenAI\Laravel\Facades\OpenAI;

$result = OpenAI::chat()->create([
    'model' => 'gpt-3.5-turbo',
    'messages' => [
        ['role' => 'user', 'content' => 'Hello!'],
    ],
]);

echo $result->choices[0]->message->content; // Hello! How can I assist you today?

配置

配置通过环境变量或直接在配置文件（config/openai.php）中进行。

OpenAI API密钥和组织

指定您的OpenAI API密钥和组织。这将被用于与OpenAI API进行身份验证 - 您可以在OpenAI仪表板中找到您的API密钥和组织，在https://openai.com。

OPENAI_API_KEY=
OPENAI_ORGANIZATION=

请求超时

超时可以用来指定等待响应的最大秒数。默认情况下，客户端将在30秒后超时。

OPENAI_REQUEST_TIMEOUT=

用法

有关用法示例，请参阅openai-php/client存储库。

测试

OpenAI外观附带一个fake()方法，允许您模拟API响应。

模拟响应将按照提供给fake()方法的顺序返回。

所有响应都具有fake()方法，允许您通过仅提供与您的测试用例相关的参数来轻松创建响应对象。

use OpenAI\Laravel\Facades\OpenAI;
use OpenAI\Responses\Completions\CreateResponse;

OpenAI::fake([
    CreateResponse::fake([
        'choices' => [
            [
                'text' => 'awesome!',
            ],
        ],
    ]),
]);

$completion = OpenAI::completions()->create([
    'model' => 'gpt-3.5-turbo-instruct',
    'prompt' => 'PHP is ',
]);

expect($completion['choices'][0]['text'])->toBe('awesome!');

请求发送后，有多种方法可以确保发送了预期的请求

// assert completion create request was sent
OpenAI::assertSent(Completions::class, function (string $method, array $parameters): bool {
    return $method === 'create' &&
        $parameters['model'] === 'gpt-3.5-turbo-instruct' &&
        $parameters['prompt'] === 'PHP is ';
});

有关更多测试示例，请参阅openai-php/client存储库。

OpenAI PHP for Laravel 是一个开源软件，遵循 MIT 许可协议。