DEV Community: İstanbul PHP

Windows üzerinde geliştirme ortamı kurulumu

Pınar Suvaçoğlu — Mon, 20 Feb 2023 20:27:24 +0000

Windows Üzerinde Geliştirme Ortamı Kurulumu

Yeni yazılım öğrenmeye başlayan, ilk kurulumları nasıl yapacağını düşünenler için git, github'da proje oluşturma, ssh key ekleme, PHP için laragon kurulumu, composer kurulumu gibi konuları kısaca yazdım.

Windows üzerinde git kurulumu ve git bash ile unix command line kullanımı

https://gitforwindows.org/ sayfasından git için gerekli kurulum dosyasını indiriyoruz ve çalıştırıyoruz. Herhangi bir değişiklik yapmadan ilerleyerek kurulum yapabilirsiniz.
Terminal'de unix command line kullanımı için git bash kullanılabileceği gibi, ben windows üzerinde terminal olarak "Hyper Terminal" tercih ediyorum.
Hyper Terminal kurulumu için, Git bash kurulumundan sonra https://hyper.is 'den windows için kurulumu indirin, setup dosyasını çalıştırın.
Kurulum tamamlandığında hyper'a girin ve sol üstten edit > preference içerisine girin, içindekilerin hepsini silip bu linkteki repository'den ayarları kopyalayıp yapıştırın ve kayıt edin. Hyper terminali kapatıp açın, artık unix komutlarını hyper terminalde kullanabilirsiniz. 🎉
Hyper terminal , çokça teması olan, ekleyebileceğiniz bir sürü pluginler, bulunan, kendinize göre özelleştirebildiğiniz bir terminal.

Git ile local repository oluşturmak.

Terminalde projenizin ana dizininde iken > git init.

komutunu çalıştırarak projenize git versiyon kontrol sistemini eklemiş oluyorsunuz.

git add .

komutu ile projenizin içerisindeki tüm dosyaları staging area(Git klasörünüzde bulunan ve bir sonraki kayıt işlemine dahil olacak olan kodları tutan dosya). Eğer spesifik bir dosyayı eklemek istiyorsak ilgili dosyanın adını uzantısı ile birlikte yazarak ekleyebiliriz

git add deneme.txt

staging area'daki kaydedilen kodları bu komutun yazıldığı andaki hali ile kayıt etmek için aşağıdaki komutu çalıştırıyoruz ve yaptığımız değişiklikler local repository'mize kayıt edilmiş oluyor.

git commit -m "initial commit"

Github ile remote repository oluşturmak.

- Github 'ın ana sayfasından eğer üyeliğimiz yok ise "signup" ile kayıt oluyoruz. Kayıt formunu doldurup hızlıca üye olabilirsiniz.

Github'a üye olduktan sonra, sağ üstte + simgesine basarak "new repository" ye giriyoruz.
Açılan sayfadan, projemizin ismini ve açıklamalarını giriyoruz. Hali hazırda olan bir projenizi ekleyecekseniz zaten içerisinde mevcut readme ve gitignore dosyaları olacağı için burada oluşturmak zorunda değilsiniz. Projeniz ile birlikte de oluşturabilirsiniz.
Yukarıda oluşturduğumuz local repository'i şimdi buradaki komutlar ile remote repository'e göndereceğiz.

Görselde ikinci kısımdaki > git remote add origin https://github.com/Katjulidis/my-laravel-project.git

komut satırını çalıştırıyoruz. Böylece localde commitlediğimiz repository'i remote olarak stage'e eklemiş oluyoruz.

git branch -M main

burada main yerine başka bir isim de verebilirsiniz. Ancak genel olarak ana branch için "main" ya da "master" isimlendirilmeleri yapılır.

git push -u origin main

komutu ile local repository, remote repository'e kopyalanmış olur.

Github hesabına ssh key eklenmesi

SSH key, güvenli parola doğrulanmasını sağlamak için kullanılan anahtardır.*ssh key nedir?

İlk başta kurulumunu yaptığımız Hyper terminal ile git bash komutlarına ulaşabiliriz
Anahtar oluşturmaya başlamak için, aşağıdaki koda kendi github hesabınıza ait mail adresini ekleyerek terminale yazıyoruz. > ssh-keygen -t ed25519 -C "your_email@example.com"
"Enter a file in which to save the key" kısmını direk enter tuşuna basarak geçebilirsiniz, key'İ default olarak belirlediği directory'e kaydedicektir.
"Enter passphrase" kısmında, SSH anahtarlarınızı her kullandığınızda parolanızı yeniden girmek zorunda kalmamak için bir kimlik doğrulama aracısı yapılandırabilirsiniz. (passphrase yazarken terminalde yazdığınız harfler/rakamlar gözükmeyecektir, phassphrase'inizi iki kere girmenizi isteyeceği için tek seferde yazıp enter ile ilerleyerek sorunsuz geçebilirsiniz bu kısmı) Daha detaylı bilgi için
işlem tamamlandığında yukarıdaki gibi bir ekranla karşılaşmanız gerekiyor.
Github'da SSH key sekmesine aşağıdaki gibi ulaşabilirsiniz.
New SSH Key'e girdiğinizde aşağıdaki gibi bir ekran gelecek. En soldaki gibi .ssh klasörünün içerisindeki, sonu .pub ile biten dosyayı notepad ile açıp, içeriğini kopyalayın ve github'daki ilgili alana yapıştırıp "Add SSH key" ile keyinizi kayıt edin 🎉

Laragon Kurulumu

Laragon aynı xampp ve wamp gibi, localhost geliştirme ortamını sağlayan programdır.
git, phpmyadmin, Node.js/MongoDB, Python/Django/Flask/Postgres, Ruby, Java, Go için geliştirme ortamlarını destekler.

-Kurulum yaptıktan sonra sol alttaki start all ile mevcut yüklü programları çalıştırır.

İster laragon üzerinde her hangi bir yere sağ tıklayıp, ister windows simgelerinin olduğu yerden logosuna sağ tıklayarak, Tool > Quick Add ile kolayca istediğiniz ortamı ekleyebilirsiniz.
Geliştirme yapacağınız klasörleri Laragon > www klasörünün içine eklemelisiniz.
Laragon'u start ile başlattığınızdan emin olduktan sonra adres satırına localhost/proje-klasör-adı yazdığınızda çalışıyor olacaktır.
Henüz bir proje eklemediyseniz, laragonun test için eklediği index.php dosyası mevcut, adres satırına localhost yazdığınızda çalışıyor olduğunu göreceksiniz.

Composer Kurulumu

PHP'nin bağımlılık ve paket yöneticisi olan Composer kurulumu için buradan Composer-Setup.exe. 'yi indirip hızlıca kurulum yapabilirsiniz.
Laragonun terminalini açıp composer --version ile composer sürümünüzü kontrol edebilirsiniz.
Bağımlılıkları yüklemek için

composer require paket_adi
Paket kurulumu yapıldıktan sonra vendor klasörü içerisinde composer.json isimli dosyada kurduğunuz paketleri görebilirsiniz.
Hali hazırda mevcut composer.json dosyanız varsa, içerisindeki paketlerin kurulması için terminale aşağıdaki komutu girmeniz gerekiyor.

composer install
mevcut paketleri güncellemek için

composer update

Önemli Not: Windows üzerinde composer indirilirken, kurulum yapıldıktan sonra terminale aşağıdaki komut girilerek, windowsta olmayan php paketleri görmezden gelmesini sağlayarak, çıkacak hataların önüne geçmiş olursunuz.

composer install --ignore-platform-reqs

Npm Kurulumu

Npm uygulamanızda size kolaylık sağlayacak 3.parti yazılımları yüklemeyi ve bağımlılıkları yönetmeyi sağlayan paket yöneticisidir.
Npm package.json dosyası ile projede kullanılan tüm paket ve bağımlılıkları barındırır.
Npm kurulumu için Node.js kurulması gerekiyor, node.js'in sitesinden indirme işlemini yaptığınızda npm'de onunla birlikte kurulmuş olacak. Yüklemeden sonra terminale node -v yazdığınızda aşağıdaki gibi bir çıktı almanız gerekiyor. Tabii ki versiyonu yüklediğiniz güne göre değişiklik gösterebilir. Npm'i de aynı şekilde npm -v ile yüklendiğini kontrol edebilirsiniz.

package.json dosyasını oluşturmak için projenizin ana dizininde npm init komunu çalıştırmanız gerekiyor. Bu kısmı atlayıp daha sonra package.json üzerinden bu değişiklikleri yapmak istiyorsanız npm init -y ile bu kısmı geçebilirsiniz.
İçerisinde bağımlılıkları ve paketleri olan package.json dosyası aşağıdaki gibi görünecektir
Bu sayede projelerimizi github'a gönderirken .gitignore 'a node_modules klasörünü ekleriz ve büyük boyutlu bu paket dosyalarını göndermemiş oluruz. Projeyi bir başkası indirdiğinde ve ya bir başkasının projesini local'de çalıştırmak istediğinizde npm init komutu ile tüm tanımlı bağımlılıkları yükleyebilirsiniz.
Bir paket global olarak yüklenmek istendiğinde npm install <paket adı> -g --save-dev komutu kullanılır.
- Projeye özel olarak yüklenmekk istendiğinde sadece npm install <paket adı> --save-dev yazılması yeterlidir

Laravel Incoming Emails

Ahmet Korkmaz — Mon, 20 Dec 2021 11:36:22 +0000

Herkese merhaba! Bu yazı da laravel içerisinde gelen emailleriniz nasıl handle edebileceğiniz inceleyeceğiz. Bunu için laravel'de BeyondCode tarafından açık kaynak olarak geliştirilmiş laravel-mailbox paketini kullanacağız.

Not: laravel-mailbox paketini kullanmadan önce bilmelisiniz ki paketin desteklediği servisler mailgun, postmark ve sendgrid servisleridir.

laravel-mailbox paketini laravel projenize eklemek için aşağıdaki komutu kullanabilirsiniz.

composer required beyondcode/laravel-mailbox

laravel-mailbox paketinin kullanımı ve konfigürsayon işlemleri için publish işlemi yapılması gerekiyor.

php artisan vendor:publish --provider="BeyondCode\Mailbox\MailboxServiceProvider" --tag="migrations"

php artisan vendor:publish --provider="BeyondCode\Mailbox\MailboxServiceProvider" --tag="config"

Ardından paket için gerekli tablonun oluşturulması için migration dosyasını çalıştırmanız gerekmektedir.

php artisan migrate

Paketin kurulumu bittikten sonra temel kullanımı inceleyelim.
Paket kullanımı için AppServiceProvider içerisine hangi email adresini hangi sınıf ile handle edeceğinizi belirtmeniz gerekmektedir.
Örnek:

use BeyondCode\Mailbox\InboundEmail;
use BeyondCode\Mailbox\Facades\Mailbox;

class AppServiceProvider extends ServiceProvider
{
    /**
     * Bootstrap any application services.
     *
     * @return  void
     */
    public function boot()
    {
        // when send email someone to sender@domain.com, InboundEmailHandler class will working
        // InboundEmailHandler is a Invokable Class
        Mailbox::to('sender@domain.com', InboundEmailHandler::class);

            // You can use like this.
        Mailbox::to('sender@domain.com' function (InboundEmail $email) {
                // InboundEmail some available methods
                $id = $email->id();
                $date = $email->date();
                $html = $email->html();
                $text = $email->text();
                $subject = $email->subject();
                $from = $email->from();
                // Handle incoming email
        });
    }
}

laravel-mailbox paketini gerçek bir kullanımda inceleyelim.
Örneğin kullanıcı özelinde gelen emailler ile görev oluşturmak istiyor olalım.
Bunun için kullanıcıların her biri için ayrı email adresi olması gerekmektedir. Kullanıcılar için bunun isim - soyisim - rastgele bir değer (ahmet-korkmaz-adas76fa87dfa) olarak düşünelim. Bunun için users tablonuza yeni bir sütun oluşturmanız gerekmektedir. Bu durumun hazır olduğunu düşünerek mailbox ile ilgili kodlarımızı yazmaya başlayalım.

// AppServiceProvider.php

use BeyondCode\Mailbox\Facades\Mailbox;

class AppServiceProvider extends ServiceProvider
{
    /**
     * Bootstrap any application services.
     *
     * @return  void
     */
    public function boot()
    {
        // You can use userEmail as a variable in CreateTaskHandler invoke method.
        Mailbox::from('{userEmail}@domain.com', CreateTaskHandler::class);
    }
}

// app/InboundEmails/CreateTaskHandler.php

namespace App\InboundEmails;

use BeyondCode\Mailbox\InboundEmail;

class CreateTaskHandler {
        public function __invoke(InboundEmail $email, $userEmail)
        {
            $user = User::where('inbound_email', $userEmail)->first();

            if ($user) {
                $task = $user->tasks()->create([
                    'title' => $email->subject(),
                    'description' => $email->text(),
                ]);

                // $email->cc() return array and you can attach cc users to task users
                $task->users()->attach($email->cc());
            }
        }
}

Sonuç olarak, laravel-mailbox paketini kullanarak gelen emailleri handle etmek çok kolay. Buna ek olarak task oluşturduktan sonra kullanıcıya success maili reply edebilirsiniz.