Devenia IMAP Intake
Hent e-post fra en IMAP-postkasse til WordPress-innstikket ditt
Les meldinger og vedlegg fra en eksisterende IMAP-postkasse gjennom et PHP-grensesnitt. Innstikket ditt bestemmer når det skal lese, og hva som skal skje med innholdet.
Versjon 1.0.1 · GPL-2.0-or-later
Én postkasse, en tydelig ansvarsdeling
Innstikket ditt oppgir server, port, mappe og innloggingsopplysninger. Devenia IMAP Intake åpner mappen i skrivebeskyttet modus over en TLS-forbindelse med sertifikatkontroll og returnerer meldingshoder, avsenderadresser og dekodede vedlegg. Meldingen blir liggende i mappen, og lesestatusen endres ikke.
Innstikket ditt bestemmer når forbindelsen skal opprettes, og håndterer tilgang, nye forsøk, duplikater og lagring. Det angir også maksimal størrelse på hele meldingen ved hver henting.
Les meldingen. La innstikket ditt ta over.
Meldingen blir liggende i postkassen. Mottakeren leser den og dekoder vedleggene. Deretter bruker innstikket ditt sine egne regler og bestemmer hva som skal skje.
Mottakeren kobler postkassen til koden din. Innstikket ditt bestemmer hvordan meldingen behandles.
Eksempel: Behandle en felles innboks
Tenk deg et WordPress-innstikk som behandler meldinger sendt til [email protected]. Utvikleren kobler det til den eksisterende IMAP-postkassen og setter en grense for meldingsstørrelse. Mottakeren returnerer meldinger og vedlegg. Innstikket sjekker hva det allerede har behandlet, og avgjør hvordan hvert element skal lagres eller brukes.
Eksemplet er oppdiktet. Mottakeren er et lesegrensesnitt for utviklere. Den er ikke en nettpostklient og sender ikke e-post via SMTP.
Bruk meldings-ID-er i riktig sammenheng
En UID identifiserer en melding innenfor en bestemt konto, mappe og UIDVALIDITY. Sammenlign gjeldende UIDVALIDITY med den lagrede verdien før du bruker en lagret posisjon på nytt.
UIDVALIDITY
Identifiserer den gjeldende UID-serien for den valgte mappen.
UID
Identifiserer en melding innenfor den aktuelle kontoen, mappen og UID-serien.
Dette trenger du
Du trenger WordPress 6.9 eller nyere, PHP 8.1 eller nyere med OpenSSL og mbstring, betrodde CA-sertifikater og en IMAP-server med gyldig TLS-sertifikat. Forbindelsen støtter både direkte TLS og STARTTLS.
Last ned ZIP-filen ovenfor, og test integrasjonen på en testkopi før du bruker den med en aktiv postkasse.
Last opp ZIP-filen fra utvidelsessiden i WordPress, installer den og aktiver Devenia IMAP Intake. Kall grensesnittet fra ditt eget innstikk etter at de aktive innstikkene er lastet. Oppbevar innloggingsopplysningene i applikasjonens beskyttede konfigurasjon.
Åpne en mappe og les en melding
Eksemplet bruker et reservert domenenavn. Hent $password fra beskyttet konfigurasjon og $saved_uid_validity fra din egen applikasjon. Ved første gangs bruk må du fastslå mappens UIDVALIDITY før du lagrer en posisjon. fetch() bruker bytegrensen på hele meldingen før dekoding.
use Devenia\ImapIntake\Mailbox;
$mailbox = Mailbox::open( array(
'host' => 'imap.example.com',
'port' => 993,
'username' => '[email protected]',
'password' => $password,
'folder' => 'INBOX',
'encryption' => 'ssl',
'timeout' => 15,
) );
if ( is_wp_error( $mailbox ) ) {
return $mailbox;
}
try {
$validity = $mailbox->uid_validity();
$uids = $mailbox->uids();
if ( is_wp_error( $uids ) ) {
return $uids;
}
if ( $validity !== $saved_uid_validity ) {
return new WP_Error( 'mailbox_changed', 'Kontroller lagret posisjon før du fortsetter.' );
}
if ( $uids ) {
$message = $mailbox->fetch( $uids[0], wp_max_upload_size() );
if ( is_wp_error( $message ) ) {
return $message;
}
}
} finally {
$mailbox->close();
}
Grensesnittet tilbyr Mailbox::open(), uid_validity(), uids(), fetch() og close(). En hentet melding inneholder meldingshoder, avsenderadresser og vedlegg med dekodet innhold.
I en produksjonsløsning må du håndtere feil, velge UID ut fra din egen lagrede posisjon og kontrollere avsendere etter dine regler. Registrer meldingen som behandlet først når den videre behandlingen har lykkes. Åpne en ny økt hvis en IMAP-lesing feiler.
Hvis forbindelsen feiler, kontroller servernavn, port, TLS-modus, innlogging og den betrodde sertifikatkjeden. Hvis en melding overstiger bytegrensen, må applikasjonen avgjøre hvordan den skal håndteres før du prøver igjen.
Les meldinger med ditt eget WordPress-innstikk
Last ned innstikket, sjekk kravene og test forbindelsen fra applikasjonen din.
