E-posta Kütüphanesi

E-posta gönderme işlevini yerine getiren sınıftır.

Kurulum

Bu bileşen KUT ile birlikte gelir; ayrıca kurulum gerektirmez.

↓ Paket KUT ile birlikte gelir.

Yöntemler

Yapılandırma

Settings

E-posta gönderim ayarları normalde Config/Services.php dosyası üzerinden yapılmaktadır. Ancak bazı durumlarda ayarları gönderim esnasında yapılandırmanız gerekirse bu yöntem kullanılır. Farklı bağlantılarla çoklu e-posta gönderimi gerekirse bu yöntem kullanılır.

Parmetreler

Kullanımı

Email::settings
     ([
         'smtpHost'     => 'mail.example.com', 
         'smtpUser'     => 'example@example.com', 
         'smtpPassword' => '1234'
     ])
     ->sender('bilgi@example.com', 'KUT')
     ->receiver('ornek@ornek.com')
     ->subject('Konu')
     ->message('Mesaj')
     ->send();

To / Receiver

E-posta alıcı bilgisi oluşturumak için kullanılırlar. Her iki yöntemin görevide aynıdır.

Parametreler

Kullanımı

Email::to('to@example.com', 'To Example');

Eğer çoklu alıcı bilgisi eklenecekse aşadağıdaki gibi kullanılabilir.

Email::to('to1@example.com', 'To 1')
     ->to('to2@example.com', 'To 2')
     ->to('to3@example.com', 'To 3')

Dizi olarak da çoklu alıcı belirtilebilir.

Email::to(['to1@example.com' => 'To1', 'to2@example.com' => 'To2']);

ReplyTo

E-posta gönderen kişiye gönderim için alıcı bilgisi oluşturur.

Parametreler

Kullanımı

Email::replyTo('to@example.com', 'To Example');

Eğer çoklu alıcı bilgisi eklenecekse aşağıdaki gibi kullanılabilir.

Email::replyTo('to1@example.com', 'To 1')
     ->replyTo('to2@example.com', 'To 2')
     ->replyTo('to3@example.com', 'To 3')

Dizi olarak da çoklu alıcı belirtilebilir.

Email::replyTo(['to1@example.com' => 'To1', 'to2@example.com' => 'To2']);

CC

Çoklu e-posta alıcısı oluşturmak için kullanılır.

Parametreler

Kullanımı

Email::cc('to@example.com', 'To Example');

Eğer çoklu alıcı bilgisi eklenecekse aşağıdaki gibi kullanılabilir.

Email::cc('to1@example.com', 'To 1')
     ->cc('to2@example.com', 'To 2')
     ->cc('to3@example.com', 'To 3')

Dizi olarak da çoklu alıcı belirtilebilir.

Email::cc(['to1@example.com' => 'To1', 'to2@example.com' => 'To2']);

BCC

Çoklu e-posta alıcısı oluşturmak için kullanılır. CC' den farkı e-posta adresleri alıcılar tarafından görülemez.

Parametreler

Kullanımı

Email::bcc('to@example.com', 'To Example');

Eğer çoklu alıcı bilgisi eklenecekse aşadağıdaki gibi kullanılabilir.

Email::bcc('to1@example.com', 'To 1')
     ->bcc('to2@example.com', 'To 2')
     ->bcc('to3@example.com', 'To 3')

Dizi olarak da çoklu alıcı belirtilebilir.

Email::bcc(['to1@example.com' => 'To1', 'to2@example.com' => 'To2']);

From / Sender

E - posta gönderici bilgisi oluşturmak için kullanılır.

Parametreler

Kullanımı

Email::from('from@example.com', 'Example', 'from2@example.com')
     ->to('to@example.com', 'To')
     ->content('Message')
     ->subject('Subject')
     ->send();

Subject

Gönderimi yapılacak e-posta adresinin konusu belirtmek için kullanılır.

Parametreler

Kullanımı

Email::subject('this E-posta is Examples');

Message / Content

Gönderimi yapılacak e-posta adresinin içeriğini belirtmek için kullanılır. Yukarıdaki her iki yönteminde görevi aynıdır.

Parametreler

Kullanımı

Email::subject('this Mail is Examples')
     ->message('Hi, this mail is examples.');

Template

Bu yöntem e-posta içeriğini belli bir şablon formunda göndermek için kullanılır. Bu yöntem kullanıldığı zaman message() veya content() yöntemi kullanılmaz. Biçimli içerikler göndermek için oldukça kullanışlıdır. Bir kaç formda kullanımı vardır. İsterseniz veritabanına kaydettiğiniz ya da Resources/Templates/ dizinlerindeki şablonları gönderim için kullanabilirsiniz.

Veritabanı Şablonları ile Kullanım

Bu kullanım veritabanında kayıtlı e-posta şablonlarınız içindir. Şablonlarınızı biçimlendirmek için kullanacağınız anahtar ifadeler {|key|} formunda kullanılmalıdır.

Parametreler

Kullanımlar

Bu kullanım şablonu doğrudan veritabanından çekmek için kullanılır.

Email::sender('robot@kutframework')
     ->receiver('example@kutframework.com')
     ->subject('Example')
     ->template('email_templates:content', 'name:example', 
     [
         'name'  => 'KUT'
     ])
     ->send();

Dizin Şablonları ile Kullanım

Common/Resources/Templates/ veya Project/Resources/Templates/ dizinleri içine kaydedilen şablon dosyaları kullanılır.

Parametreler

Kullanımlar

Name {|$name|}

Email::subject('Example')->template('example', ['name' => 'KUT'])->send();

TemplateMatch

Email::template() yönteminin harici olarak kullanımıdır. Gelen e-posta şablonunu parse eder. 

Parametreler

Kullanımı

echo Email::templateMatch('Hello {|user|}', ['user' => 'KUT']);

Attachment

E-posta gönderimi sırasında e-postaya ek eklemek için kullanılır. Bu ekler dosya, resim vb... olabilir.

Parametreler

$disposition = 'attachment'

Kullanımı

Email::attachment('image.jpg');
     ->attachment('text.txt', 'inline', 'content.txt', 'text/plain');

Email::attachment('example/files/word.pdf', 'attachment', 'word.pdf', 'pdf');

AddHeader

E-postaya üst bilgi eklemek için kullanılabilir.

Parametreler

Kullanımı

Email::attachment('image.jpg')
     ->to('to@example.com')
     ->from('from@example.com')
     ->addHeader('Header-Example', 'Header Example')
     ->addHeader('Data', 'Example Data')
     ->send();

Send

E-posta gönderimini sağlayan nihai yöntemdir. Her e-posta gönderimi bu yöntemle bitmelidir.

Parametreler

Kullanımı

Email::from('from@example.com')
     ->to('to@example.com')
     ->send('this is Subject', 'this is message.');

Error

E-posta gönderimi esnasında herhangi bir sorun oluştuğunda sorunun ne olduğu hakkında bilgi veren yöntemdir.

Parametreler

Kullanımı

Email::from('from@example.com')
     ->to('to@example.com')
     ->send('this is Subject', 'this is message.');

output(Email::error());

# LF KUT 1.0’da desteklenir

E-posta'nın yapısını oluşturan parametreleri ayırmak için varsayılan olarak \n kullanılır. Bazı sistemlerde bu değerin \r\n olması gerekebilir. Bu yapılandırma geneli kapsayacaksa Config/Services.php:email dizisinden yapılandırılabilir.

Parametreler

Kullanımı

Email::lf("\r\n")
     ->to('to@example.com')
     ->send('this is Subject', 'this is message.');

# CR KUT 1.0’da desteklenir

SMTP gönderiminde komutlara ayraç eklemek için varsayılan olarak \n kullanılır. Bazı sistemlerde bu değerin \r\n olması gerekebilir. Bu yapılandırma geneli kapsayacaksa Config/Services.php:email dizisinden yapılandırılabilir.

Parametreler

Kullanımı

Email::cr("\r\n")
     ->to('to@example.com')
     ->send('this is Subject', 'this is message.');