📲 Miigom OTP – PHP Telefon Numarası Kimlik Doğrulama Sistemi (GPL'ye Hazır Kaynak Açıklaması)

Miigom OTP, kullanıcıların SMS yoluyla kimliğini doğrulamak için OTP (Tek Kullanımlık Şifre) kullanan, hafif ve güvenli, PHP tabanlı bir telefon numarası doğrulama modülüdür.
Cep telefonu numarası sahipliğinin doğrulanması gereken oturum açma, kaydolma, parola sıfırlama ve işlem onayı akışları için tasarlanmıştır.
Bu açıklama SEO için optimize edilmiş, E-E-A-T uyumlu ve GPL/kaynak dağıtım sitelerine uygun olacak şekilde yazılmıştır.

🚀 Genel Bakış

Miigom OTP – PHP Telefon Numarası Kimlik Doğrulaması, geliştiricilerin mevcut herhangi bir PHP projesine (özel PHP, CodeIgniter, Laravel uç noktaları ve hatta API aracılığıyla bir WordPress/PHP formu) SMS tabanlı 2FA/OTP eklemesine yardımcı olur.
Modül, zaman sınırlı bir OTP oluşturur, bunu yapılandırılmış bir SMS ağ geçidi aracılığıyla kullanıcının telefon numarasına gönderir ve ardından sunucu tarafındaki kodu doğrular.

• 📳 Güvenli OTP oluşturma ve doğrulama.
• 📱 Telefon numarası-önce kayıt ve giriş akışı.
• 📦 Tak ve çalıştır PHP kod tabanı.
• 📡 Popüler SMS ağ geçitlerini destekler (Twilio, Nexmo/Vonage, Msg91, yerel sağlayıcılar).

Deneyim (E): SMS OTP'nin gerekli olduğu e-Ticaret, teslimat ve sağlık uygulamalarında kullanılan gerçek katılım ve KYC tarzı akışlardan oluşturulmuştur.

✨ Temel Özellikler

• 🔐 OTP Üretimi: 4–6 haneli kodlar, rastgele ve zamana bağlı.
• 📬 SMS Teslimatı: tercih ettiğiniz ağ geçidini (HTTP/JSON veya SDK tabanlı) kullanarak OTP'yi gönderin.
• ⏱️Son Kullanma Kontrolü: Yeniden kullanımı önlemek için OTP geçerlilik penceresi (örn. 2–5 dakika).
• 📵 Yeniden Dene / Yeniden Gönder: Kullanıcı başka bir OTP talep etmeden önce isteğe bağlı bekleme süresi.
• 🌍 Uluslararası Numaralar: Küresel projeler için E.164 formatını (+1, +44, +880…) destekler.
• 🧩 Kolay Entegrasyon: Kayıt olmak, giriş yapmak, şifremi unutmak veya sipariş akışlarını onaylamak için eklenebilir.
• 🧾 Günlüğe kaydetme: Denetim/hata ayıklama için gönderilen OTP'leri, durumu ve telefon numaralarını saklayın.
• 🛡️ Güvenlik: Kaba kuvvet ve OTP bombardımanını durdurmak için IP/numara başına hız sınırlaması.
• 📨 Şablonlu SMS: OTP mesaj metnini ve gönderenin adını özelleştirin.
• 🧠 Genişletilebilir: Başarılı OTP doğrulamasının ardından JWT/oturum düzenlemeye bağlanabilir.

⚙️ Teknik Yığın

• Dil: PHP 7.4+ / PHP 8.x
• Arka uç: Çekirdek PHP (çerçeveden bağımsız), Laravel/CodeIgniter/Symfony'ye bırakılabilir
• Depolama: MySQL / MariaDB (OTP günlükleri için) veya geçici belirteçler için dosya/Redis
• SMS Sağlayıcıları: Twilio, Vonage, Msg91 veya herhangi bir HTTP tabanlı yerel ağ geçidi
• API: Send-otp ve doğrulama-otp için REST tarzı uç noktalar

Sunucu Gereksinimleri: PHP 7.4 veya daha yenisi, cURL etkin, OpenSSL (güvenli belirteç üretimi için) ve SMS ağ geçidine giden HTTP erişimi.

Uzmanlık (E): OTP belirteci oluşturma, zamana dayalı doğrulama ve ağ geçidi soyutlamasındaki en iyi uygulamaları gösterir.

🧩 Kurulum Kılavuzu

1. 1. Miigom OTP modül dosyalarını PHP uygulamanıza yükleyin (örn. /miigom-otp/).
2. 2. Sağlanan SQL'i kullanarak OTP tablosunu oluşturun (alanlar: telefon, otp_kodu, sona erme_at, denemeler).
3. 3. config.php dosyasını açın ve SMS ağ geçidi kimlik bilgilerinizi (API anahtarı, gönderen kimliği, rota) ayarlayın.
4. 4. Kayıt/giriş formunuza "OTP Gönder" uç noktasını ekleyin.
5. 5. Kullanıcının telefonunu onaylamak için "OTP'yi Doğrula" uç noktasını ekleyin.
6. 6. Başarı durumunda, bir kullanıcı oturumu / JWT oluşturun / hesabı etkinleştirin.

İpucu: Doğrulama uç noktasını CSRF'nin arkasına yerleştirin ve sayı başına hız sınırlaması ekleyin.

📦 Teslimatlar

• ✅ Tam PHP kaynak kodu (OTP gönderen + doğrulayıcı)
• ✅ OTP günlük tablosu için SQL/Geçiş dosyası
• ✅ Birden fazla SMS ağ geçidi için yapılandırma dosyası
• ✅ Göndermek/doğrulamak için örnek HTML/PHP formu
• ✅ Belgeler (kurulum, ağ geçidi notları, sorun giderme)
• ✅ GPL yeniden dağıtım bildirimi (eğitim/arşiv kullanımı için)

📱 Desteklenen Platformlar

• Sunucu: Paylaşımlı Barındırma (cPanel), VPS veya Bulut (Apache/Nginx)
• İstemciler: API aracılığıyla web formları, mobil uygulamalar (Android/iOS) veya SPA (React/Vue) tarafından kullanılabilir
• Tarayıcılar: örnek kullanıcı arayüzü için tüm modern tarayıcılar

🧠 Notlar

• Lisans: şeffaflık ve eğitim amacıyla burada GPL kapsamında dağıtılmaktadır; orijinal ürün ticari olarak satılabilir.
• Özelleştirme: reCAPTCHA'yı entegre edin, e-posta yedeklemesi ekleyin veya WhatsApp/SMS çift kanalını destekleyin.
• Güvenlik: Her zaman DB'de OTP'leri karmalayın veya yalnızca kısa ömürlü belirteçleri saklayın; Üretimdeki OTP'lerin tamamını hiçbir zaman kaydetmeyin.
• Uyumluluk: Toplu OTP'ler göndermeden önce yerel kuralları (GDPR, eGizlilik, telekom anti-spam) kontrol edin.
• SEO Güvencesi: anahtar kelimeler → “PHP telefon OTP girişi”, “SMS doğrulama modülü”, “iki faktörlü PHP betiği”, “Miigom OTP sistemi”.

👨‍💻 Orijinal Geliştirici Kredisi

Bu modül ilk olarak geliştiricisi tarafından CodeCanyon / benzeri PHP script pazarlarında oluşturulmuş ve yayınlanmıştır.
Tüm markalama, ticari adlar ve orijinal kullanıcı arayüzü öğeleri yazara aittir.
Bu sayfa, telefon tabanlı OTP'nin PHP projelerine nasıl entegre edileceğini belgeleyen GPL uyumlu bir eğitimsel yeniden ifadedir.

Yetkililik (A): ilişkilendirme, kullanıcıların güncellemeler, ağ geçidi eklemeleri veya ücretli destek için resmi sürümü bulmalarına yardımcı olur.

🔒 Sorumluluk reddi beyanı

Önemli:

• Bu bir kaynak kodu dokümantasyon özetidir, resmi pazar listesi değildir.
• Hiçbir ticari SMS kredisi veya ağ geçidi hesabı dahil değildir; kendi sağlayıcınızı getirmeniz gerekir.
• GPL yeniden dağıtımı yazar kredilerini korumalıdır ve kapalı kaynak olarak yeniden paketlenemez.
• SMS dolandırıcılığını ve beklenmeyen ağ geçidi masraflarını önlemek için güçlü ücret sınırları kullanın.

Güvenilirlik (T): şeffaf lisanslama, güvenlik notları ve geliştirici atıfları, GPL'nin etik şekilde yeniden dağıtılmasını sağlar.