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

Art Deco-illustrasjon av en e-postmottaker som sorterer konvolutter og et vedlegg.

É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.

En IMAP-postkasse leverer meldinger via Devenia IMAP Intake til et WordPress-innstikk.

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.

Art Deco-illustrasjon av en e-postmottaker som sorterer konvolutter og et vedlegg.