aqt-im / laravel

dev-master 2026-10-23 13:48 UTC

Requires

• php: ^8.5
• illuminate/database: ^13.0
• illuminate/queue: ^13.0
• illuminate/support: ^13.0
• spatie/laravel-webhook-server: ^3.10

Requires (Dev)

• orchestra/testbench: ^11.0
• phpunit/phpunit: ^12.0

proprietary

• X-Adam

Published on Packagist.org on 2026-10-23 13:48 UTC

README

Laravel uygulamasındaki bilet olaylarını imzalı webhook ile aqt.im'e gönderir. Paket aqt.im'e özeldir, açık lisanslı değildir.

Kurulum

composer require aqt-im/laravel

Ortam değişkenleri:

Değişken	Anlamı
AQTIM_MODE	production, test veya local; tanımlı değilse uygulamanın ortamından türetilir
AQTIM_WEBHOOK_SECRET	İmza anahtarı; aqt.im'deki AQTIVITE_WEBHOOK_SECRET ile aynı olmalıdır. local modda gerekmez

Modlar

Adresler moddan gelir:

Mod	Webhook	Bilet sayfası	Kısa bağlantı	Gönderim
production	https://webhook.aqt.im	https://ticket.aqt.im	https://aqt.im	Gönderir
test	https://webhook.test.aqt.im	https://ticket.test.aqt.im	https://test.aqt.im	Gönderir
local	https://webhook.local.aqt.im	https://ticket.local.aqt.im	https://local.aqt.im	Göndermez

local modda olay yine kuyruğa girer ve payload kurulur; HTTP isteği atılmaz, gidecek istek debug seviyesinde log'a yazılır.

Bir modun adresini ezmek için config yayınlanır ve webhook.url, ticket.url veya short.url doğrudan yazılır:

php artisan vendor:publish --tag=aqtim-config

AQTIM_MODE tanımlı değilse mod APP_ENV'den gelir: production ortamı production, test ortamı test modunu, geri kalan her ortam (local, testing, staging …) local modunu seçer.

AQTIM_MODE tanımlıysa ortama bakılmaz. Tanınmayan bir değer uygulama açılırken InvalidArgumentException fırlatır.

Kuyruk

Olay job'ı, spatie/laravel-webhook-server'ın webhook-server.queue kuyruğunda çalışır; payload'ın kurulması ve HTTP isteği aynı kuyruktan geçer. Ayrı bir kuyruk için config'teki webhook.queue yazılır.

Kullanım

Bilet modeli AqtIm\Laravel\Contracts\Ticket sözleşmesini uygular ve SendsTicketEvents trait'ini kullanır:

class Ticket extends Model implements \AqtIm\Laravel\Contracts\Ticket
{
    use \AqtIm\Laravel\Concerns\SendsTicketEvents;

    public function aqtimPnrCode(): string
    {
        return $this->pnr_code;
    }

    public function aqtimPayload(): array
    {
        return $this->load([/* ... */])->toArray();
    }
}

Trait created, updated, deleted, restored ve varsa approvalChanged olaylarını dinler. Her olay transaction commit edildikten sonra kuyruğa girer; payload job çalıştığında modelin güncel halinden üretilir.

Bilet sayfasının adresi aqtim()->ticketUrl($pnrCode) ile alınır.

Kısa Bağlantılar

aqt.im kökündeki kısa yollar ziyaretçiyi aqtivite.com.tr'deki sayfaya yönlendirir. Adresler aqtim()->shortLink() ile üretilir:

Metot	Adres
user($username)	https://aqt.im/u/{username}
artist($slug)	https://aqt.im/a/{slug}
organizer($slug)	https://aqt.im/o/{slug}
event($slug)	https://aqt.im/e/{slug}
venue($slug)	https://aqt.im/v/{slug}

QR koduna basılacak adres aqtim()->shortLink(qr: true) ile alınır; adresin sonuna ?qr eklenir. aqt.im bu işareti yönlendirmede utm_source=qr&utm_medium=print parametrelerine çevirir, QR kodu kısa kalır.

Test

docker compose run --rm php85