インストール

composer require openemail/sdk

<?php use OpenEmail\OpenEmail; require __DIR__ . '/vendor/autoload.php'; $client = new OpenEmail(); $email = $client->emails->send([    'from' => 'Acme Billing <[email protected]>',    'to' => '[email protected]',    'subject' => 'Your September invoice',    'html' => '<p>Invoice attached.</p>',]); echo $email['id'], ' ', $email['status'], PHP_EOL;

new OpenEmail() はキーを OPENEMAIL_API_KEY から読むため、コードには資格情報が残りません。設定を別の場所で管理している場合は apiKey: を渡してください。どこからでも 1 つのクライアントを使うには、OpenEmail::init() で一度だけ設定し、OpenEmail::getClient() で取得します。

レスポンスはデコード済みの JSON で、連想配列です。そのため $email['id'] で id を読めます。キーは API の名前をそのまま使い、メソッドとその名前付き引数も同様です。だから scheduledAt や idempotencyKey: は、ここでも API リファレンスと同じ書き方になります。

PHP 8.2 以降で、ほぼすべてのビルドに含まれる curl と json の拡張以外に依存関係はありません。リクエストはクライアントごとに 1 つの cURL ハンドルを通るため、API への 2 回目のリクエストは 1 回目が開いた接続を再利用し、圧縮されたレスポンスは cURL が展開します。

PHP-FPM、Apache、コマンドライン、そしてキューワーカー、RoadRunner、FrankenPHP のような常駐ワーカーで動きます。PHP-FPM では各リクエストがまっさらな状態から始まるため、クライアントはリクエストごとに 1 回作ります。常駐プロセスでは、プロセスの存続期間中 1 つを使い続けてください。pcntl_fork の後は、子プロセスは親の接続を再利用せず、自分の接続を開きます。