Devenia IMAP Intake
Verbind een IMAP-postvak met je WordPress-plugin
Lees berichten en bijlagen uit een bestaand IMAP-postvak via een PHP-interface. Je plugin bepaalt wanneer hij leest en wat er met het resultaat gebeurt.
Versie 1.0.1 · GPL-2.0-or-later
Eén postvak, een heldere overdracht
Je plugin geeft de server, poort, map en inloggegevens door. Devenia IMAP Intake opent de map alleen-lezen via een geverifieerde TLS-verbinding en geeft berichtheaders, afzenderadressen en gedecodeerde bytes van bijlagen terug. Het oorspronkelijke bericht blijft in de map en de leesstatus blijft behouden.
Je plugin bepaalt wanneer de verbinding wordt gemaakt en is verantwoordelijk voor toegangscontrole, nieuwe pogingen, ontdubbeling en opslag. De plugin stelt ook de maximale grootte van het volledige bericht per ophaalverzoek in.
Lees het bericht. Je plugin neemt het over.
Het bericht blijft in het postvak. De ontvanger leest het en decodeert de bijlagen; je plugin past zijn eigen regels toe en bepaalt wat er verder gebeurt.
De ontvanger verbindt het postvak met je code; hij bepaalt niet hoe het bericht wordt verwerkt.
Voorbeeld: een gedeeld postvak verwerken
Stel je een WordPress-plugin voor die berichten aan [email protected] verwerkt. De ontwikkelaar verbindt de plugin met het bestaande IMAP-postvak en stelt een maximale berichtgrootte in. De ontvanger geeft berichten en bijlagen terug; de aanroepende plugin controleert wat al is verwerkt en bepaalt hoe elk onderdeel wordt opgeslagen of verwerkt.
Dit voorbeeld dient ter illustratie. De ontvanger is een leesinterface voor ontwikkelaars; hij is geen webmail en verstuurt geen e-mail via SMTP.
Gebruik bericht-ID’s in de juiste context
UID’s identificeren berichten alleen binnen een bepaald account, een bepaalde map en UIDVALIDITY-waarde. Vergelijk de huidige UIDVALIDITY met de opgeslagen waarde voordat je een cursor opnieuw gebruikt.
UIDVALIDITY
Identificeert de huidige UID-reeks van de geselecteerde map.
UID
Identificeert een bericht binnen dat account, die map en die UID-reeks.
Vereisten en beschikbaarheid
Je hebt WordPress 6.9 of hoger, PHP 8.1 of hoger met OpenSSL en mbstring, vertrouwde CA-certificaten en een IMAP-server met een geldig TLS-certificaat nodig. De verbinding ondersteunt impliciete TLS of STARTTLS.
Download het ZIP-bestand hierboven en test de integratie op een testkopie voordat je een actief postvak gebruikt.
Open in WordPress Plugins → Nieuwe plugin toevoegen → Plugin uploaden, kies het ZIP-bestand, installeer en activeer Devenia IMAP Intake. Roep de interface vanuit je eigen plugin aan nadat de actieve plugins zijn geladen. Bewaar de inloggegevens van het postvak in de beveiligde configuratie van je toepassing.
Een map openen en een bericht lezen
Dit voorbeeld gebruikt een gereserveerd domein. Haal $password uit beveiligde configuratie en $saved_uid_validity uit je eigen toepassing. Bepaal bij het eerste gebruik de UIDVALIDITY van de map voordat je een cursor opslaat. fetch() past de bytelimiet vóór het decoderen toe op het volledige bericht.
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', 'Controleer de opgeslagen cursor voordat je verdergaat.' );
}
if ( $uids ) {
$message = $mailbox->fetch( $uids[0], wp_max_upload_size() );
if ( is_wp_error( $message ) ) {
return $message;
}
}
} finally {
$mailbox->close();
}
De interface biedt Mailbox::open(), uid_validity(), uids(), fetch() en close(). Een opgehaald bericht bevat headers, afzenderadressen en bijlagen met hun gedecodeerde bytes.
Vang in een productieproces fouten af, selecteer de UID met je eigen cursor en controleer afzenders volgens je eigen regels. Registreer de verwerking pas als voltooid wanneer de daaropvolgende stappen zijn geslaagd. Open een nieuwe sessie na een mislukte IMAP-leesactie.
Controleer bij een mislukte verbinding de servernaam, poort, TLS-modus, inloggegevens en vertrouwde certificaatketen. Bepaal bij een bericht boven je bytelimiet hoe je toepassing daarmee moet omgaan voordat je het opnieuw probeert.
Lees berichten met je eigen WordPress-plugin
Download de plugin, controleer de vereisten en test de verbinding met je toepassing.
