Instalimi
Një paketë Composer, PHP 8.2 e më lart, me zgjerimet curl dhe json.
Instalimi
Lëshimi aktual është 0.0.1. Ka një metodë për çdo metodë të TypeScript SDK-së, nën të njëjtin emër, dhe kontrolli i përputhshmërisë i paketës e dështon build-in kur njëra mungon ose dërgon një kërkesë të ndryshme.
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() e lexon çelësin nga OPENEMAIL_API_KEY, kështu që kodi nuk mban asnjë kredencial. Jepni apiKey: kur konfigurimi juaj ndodhet diku tjetër. Për të arritur te i njëjti klient nga kudo, konfigurojeni një herë me OpenEmail::init() dhe merreni me OpenEmail::getClient().
Një përgjigje është JSON-i i dekoduar si një array asociativ, ndaj $email['id'] lexon id-në. Çelësat ruajnë emrat e API-së, ashtu si edhe metodat dhe argumentet e tyre me emër; prandaj scheduledAt dhe idempotencyKey: shkruhen këtu njësoj si në referencën e API-së.
Kthimi i send nuk do të thotë se mesazhi ka ikur. Një dërgim i planifikuar ose i anulueshëm kthehet si queued ose scheduled dhe përfundon më vonë. Lexoni status, jo faktin që thirrja u kthye.
Ku funksionon
PHP 8.2 e më lart, me zgjerimet curl dhe json që i ka pothuajse çdo build, dhe pa asnjë varësi tjetër. Kërkesat kalojnë përmes një handle-i cURL për çdo klient, ndaj një kërkesë e dytë drejt API-së ripërdor lidhjen që hapi e para, dhe cURL e dekompreson vetë një përgjigje të ngjeshur.
Funksionon nën PHP-FPM, Apache, në rreshtin e komandave dhe në worker-a që punojnë gjatë, si një worker radhe, RoadRunner ose FrankenPHP. Nën PHP-FPM çdo kërkesë nis nga e para, ndaj ndërtojeni klientin një herë për çdo kërkesë. Në një proces që punon gjatë, mbani një të vetëm gjatë gjithë jetës së procesit. Pas pcntl_fork, procesi bir hap një lidhje të vetën në vend që të ripërdorë atë të prindit.
Klienti mban një çelës API të hapësirës së punës që mund të dërgojë postë dhe të lexojë kutinë postare, prandaj vendi i tij është në një server, në një punë në sfond ose në një mjet që ekzekutohet në makinën tuaj. Mbajeni çelësin në një variabël mjedisi ose te sekretet e framework-ut tuaj, kurrë në kod.