Mengendalikan e -mel masuk dengan Sendgrid

sendgrid: alat yang berkuasa untuk menukar e -mel ke dalam aplikasi

SendGrid bukan sahaja perkhidmatan yang menghantar mel dalam kelompok, ia juga menyediakan ciri yang kurang dikenali: memproses mel yang diterima. Dengan konfigurasi mudah, anda boleh membiarkan SendGrid memproses semua e -mel di bawah nama domain yang ditentukan dan menghantar mesej e -mel ke pelayan anda. Artikel ini akan memperkenalkan cara membina fungsi "mel ke artikel" menggunakan SendGrid.

mata teras:

• fungsi resolusi mel masuk SendGrid boleh memproses semua mesej dari nama domain yang ditentukan dan menghantar maklumat mel kepada URI yang ditentukan dalam bentuk permintaan pos.
• Dengan menyediakan webhook, anda boleh menyesuaikan e -mel yang diterima.
• Fungsi resolusi e -mel masuk SendGrid digunakan secara meluas, seperti: peringatan ketibaan e -mel, muat naik lampiran ke penyimpanan awan, pemberitahuan forum balasan e -mel, memproses permintaan berhenti berlangganan, dll.
• Webhook resolusi masuk SendGrid menyokong penggunaan subdomain wildcard untuk memproses pelbagai alamat e -mel, menyokong penghantaran data selamat HTTPS, jumlah saiz lampiran adalah terhad kepada 20MB, dan menyediakan log aktiviti pemuka untuk debug mudah.

pemula:

Kod sampel dalam artikel ini didasarkan pada rangka kerangka Slim. Untuk debugging yang mudah, sila tambahkan kandungan berikut dalam bahagian composer.json: require

"slim/extras": "dev-develop"

Ubah suai kod instantiasi rangka kerja dalam

dan konfigurasikan logger: include/services.php

$app = new Slim(array(
    'view' => new Twig(),
    'templates.path' => $c['config']['path.templates'],
    'log.writer' => new \Slim\Extras\Log\DateTimeFileWriter(array(
        'path' => dirname($c['config']['path.logs']),
        'name_format' => 'Y-m-d',
        'message_format' => '%label% - %date% - %message%'
    ))
));

Salin fail konfigurasi sampel ke

dan tetapkan nilai konfigurasi anda (seperti maklumat sambungan pangkalan data). Tambahkan kod berikut untuk menentukan direktori di mana fail log dan muat naik imej: config/config.php

'path.logs'    => $basedir . 'logs/',
'path.uploads' => $basedir . 'public/uploads/'

Buat direktori ini dan pastikan pelayan web mempunyai kebenaran menulis.

Aplikasi kami akan menyediakan pengguna berdaftar dengan alias e -mel. Dengan memadankan bahagian sebelum simbol

di alamat e -mel penerima, kami dapat menentukan pengguna yang menyiarkannya. Dalam aplikasi praktikal, anda mungkin perlu menetapkan peraturan alias yang lebih kompleks dan menghadkan alamat penghantaran e -mel. Struktur pangkalan data mentakrifkan dua jadual untuk menyimpan pengguna dan artikel: @

CREATE TABLE users (
    id INTEGER NOT NULL AUTO_INCREMENT,
    name VARCHAR(128) NOT NULL ,
    alias VARCHAR(45) NOT NULL ,

    PRIMARY KEY (id) ,
   INDEX alias (alias ASC)
);

CREATE  TABLE posts (
    id INTEGER NOT NULL AUTO_INCREMENT,
    title VARCHAR(255) NOT NULL,
    body TEXT NOT NULL,
    image varchar(255),
    user_id INTEGER NOT NULL,

    PRIMARY KEY (id)
);

Anda memerlukan akaun SendGrid (akaun percuma cukup). Selepas mendaftar, pergi ke halaman pemaju dan klik "menganalisis e -mel masuk". Masukkan nama hos dan url panggilan balik anda.

Apabila menerima mesej dengan nama domain yang ditentukan, SendGrid akan menghantar permintaan pos ke URL anda, termasuk pengirim, penerima, badan e -mel dan maklumat lampiran. Akhirnya, anda perlu menambah rekod MX ke nama domain anda, menunjuk kepada

. Operasi khusus bergantung kepada penyedia hosting anda.

mx.sendgrid.net

Bina fungsi panggil balik:

permohonan anda perlu bertindak balas terhadap permintaan pos URL yang anda tentukan, contohnya:

"slim/extras": "dev-develop"

Jika ujian "ping" SendGrid mengembalikan ralat 4xx atau 5xx, ia beratur permintaan dan cuba lagi selama 3 hari. Oleh itu, ujian ping yang berjaya mesti mengembalikan kod status 200. Permintaan pos Sendgrid mengandungi pelbagai maklumat mengenai e -mel, sila rujuk dokumentasi API SendGrid untuk maklumat lanjut. Kami terutamanya memberi tumpuan kepada bidang berikut:

Kerana format medan

adalah pelbagai, kita memerlukan ungkapan biasa untuk menghuraikan pelbagai penerima: to

$app = new Slim(array(
    'view' => new Twig(),
    'templates.path' => $c['config']['path.templates'],
    'log.writer' => new \Slim\Extras\Log\DateTimeFileWriter(array(
        'path' => dirname($c['config']['path.logs']),
        'name_format' => 'Y-m-d',
        'message_format' => '%label% - %date% - %message%'
    ))
));

untuk setiap penerima, ekstrak bahagian alias dan cari pengguna yang sepadan:

'path.logs'    => $basedir . 'logs/',
'path.uploads' => $basedir . 'public/uploads/'

Buat artikel:

CREATE TABLE users (
    id INTEGER NOT NULL AUTO_INCREMENT,
    name VARCHAR(128) NOT NULL ,
    alias VARCHAR(45) NOT NULL ,

    PRIMARY KEY (id) ,
   INDEX alias (alias ASC)
);

CREATE  TABLE posts (
    id INTEGER NOT NULL AUTO_INCREMENT,
    title VARCHAR(255) NOT NULL,
    body TEXT NOT NULL,
    image varchar(255),
    user_id INTEGER NOT NULL,

    PRIMARY KEY (id)
);

Sekarang kita mempunyai fungsi asas "e -mel ke artikel"! Seterusnya, kami boleh menambah fungsi pemprosesan lampiran, membolehkan pengguna menambah imej melalui lampiran e -mel. Permintaan pos SendGrid mengandungi parameter

, menunjukkan bilangan lampiran. Lampiran disiarkan bersama -sama dengan permintaan, dan kaedah pemprosesan adalah sama dengan fail borang web yang dimuat naik. attachments

$app->post('/endpoints/email', function () use ($app, $c) {

Ringkasan:

Artikel ini memperkenalkan aplikasi mudah fungsi resolusi e -mel masuk SendGrid - fungsi "mel ke artikel", yang membolehkan pengguna membuat artikel dengan menghantar e -mel. Melalui fungsi panggil balik yang mudah, anda boleh melaksanakan pelbagai fungsi yang menarik, seperti: peringatan ketibaan e -mel, muat naik lampiran ke penyimpanan awan, pemberitahuan forum balasan e -mel, memproses permintaan berhenti berlangganan, dll.

(Kandungan seterusnya, iaitu bahagian FAQ, disyorkan untuk menanganinya secara berasingan kerana panjang artikel. Bahagian FAQ boleh dikemukakan secara berasingan sebagai soalan baru.)

Atas ialah kandungan terperinci Mengendalikan e -mel masuk dengan Sendgrid. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!