ورود با موبایل php؛ لاگین با شماره و کد یکبارمصرف، امن و کوتاه

ورود با موبایل php یعنی کاربر شماره‌اش را می‌دهد، کدی کوتاه با پیامک می‌گیرد و با آن وارد می‌شود. نوشتنش سخت نیست، ولی چند جزئیات امنیتی دارد که اگر جا بیفتند، حساب‌ها قابل حدس‌زدن می‌شوند: ساخت کد با مولد امن، ذخیره‌ی چکیده‌ی کد به‌جای خود کد، انقضا، شمارنده‌ی تلاش، سقف درخواست و مقایسه‌ی بدون نشت زمان. این صفحه همه‌ی آنها را در یک نمونه‌ی کوتاه و فقط با امکانات خود PHP نشان می‌دهد. آخر صفحه هم می‌بینید این کل ماجرا با ورود فینگت چقدر کوتاه می‌شود.

بروزرسانی: زمان مطالعه حدود ۱۱ دقیقه نوشته‌ی تیم فنی فینگت

ورود با موبایل php از چه قطعه‌هایی ساخته می‌شود؟

لاگین با شماره موبایل در php از سه قطعه تشکیل می‌شود: یک مرحله‌ی «درخواست کد»، یک مرحله‌ی «بررسی کد» و ساخت نشست بعد از موفقیت. بقیه‌ی کار، یعنی فرم و ظاهر صفحه، به سلیقه‌ی شما بستگی دارد.

در مرحله‌ی اول سرور شماره را می‌گیرد، کد تصادفی می‌سازد، چکیده‌ی آن را ذخیره می‌کند و کد را با پیامک می‌فرستد. در مرحله‌ی دوم کاربر کد را وارد می‌کند و سرور چند شرط را می‌سنجد. اگر همه درست بود، کاربر وارد شده و کد برای همیشه باطل می‌شود.

مفهوم پایه را مرور کنید

اگر تازه با ایده‌ی کد یکبارمصرف آشنا شده‌اید، پیش‌تر رمز یکبار مصرف otp را بخوانید. این صفحه فرض می‌کند می‌دانید کد پیامکی چیست و فقط می‌خواهد چگونه ساختنش را نشان دهد.

مسئولیت سایت شما از ساخت کد شروع می‌شود و با باطل کردن کد تمام می‌شود. رساندن پیامک به گوشی در دست شرکت پیامکی و اپراتور است.

پیش از نوشتن کد چهار قاعده را قبول کنید

همه‌ی نمونه‌کدهای ضعیف از یک جا شروع می‌شوند: کد را با تابع‌های معمولی ساخته‌اند و هر چیزی را قابل‌اعتماد دانسته‌اند. این چهار قاعده جلوی بیشترشان را می‌گیرد.

  • کد را با مولد امنیتی بسازید در PHP تابع random_int از منبع تصادفی امن سیستم‌عامل می‌خواند. توابعی مثل rand و mt_rand برای بازی و آزمایش‌اند و خروجی‌شان از روی چند نمونه قابل پیش‌بینی است.
  • فقط چکیده را ذخیره کنید اگر پایگاه‌داده لو برود، کدهای ذخیره‌شده نباید قابل استفاده باشند. چون کد شش رقمی فقط یک میلیون حالت دارد، چکیده‌ی ساده‌ی آن را در چند ثانیه می‌شود شکست. پس از چکیده‌ی کلیددار با یک کلید مخفی سرور استفاده می‌کنیم.
  • هر کد سه حد داشته باشد زمان انقضا (در نمونه‌ی ما سه دقیقه)، سقف تلاش اشتباه (پنج بار) و باطل شدن بعد از اولین موفقیت.
  • درخواست‌ها را سقف‌دار کنید فاصله‌ی حداقل بین دو ارسال برای یک شماره و سقف ساعتی. بدون آن، دکمه‌ی ارسال کد پیامک شما را به ابزار حمله تبدیل می‌کند؛ بخشی از جزئیات در جلوگیری از sms bombing آمده است.

ساخت لاگین پیامکی با php؛ جدول و تابع درخواست کد

نمونه‌ی زیر با PDO و SQLite نوشته شده تا بدون نصب چیزی اجرا شود؛ در پروژه‌ی واقعی همان کد با MySQL هم کار می‌کند، فقط دستور ساخت جدول و عبارت ذخیره‌ی «یا به‌روزرسانی» کمی فرق دارد. تابع sendSms یک جانشین است و عمداً هیچ سرویس‌دهنده‌ی واقعی را نشان نمی‌دهد.

ارسال کد با php بسته به سرویس‌دهنده‌ی شما فرق می‌کند و روش درستش فقط در مستندات خود آن شرکت آمده است. نمونه‌ی کلی آن در صفحه‌ی وب سرویس پیامک توضیح داده شده است.

otp.php؛ اتصال، جدول و درخواست کد
<?php
declare(strict_types=1);

// کلید مخفی سرور برای چکیده‌ی کد؛ از متغیر محیطی بخوانید و در مخزن کد نگذارید
const OTP_SECRET = 'CHANGE_ME_LONG_RANDOM_STRING';
const CODE_TTL = 180;          // اعتبار کد: سه دقیقه
const MAX_ATTEMPTS = 5;        // حداکثر تلاش اشتباه برای هر کد
const RESEND_COOLDOWN = 60;    // حداقل فاصله‌ی دو ارسال برای یک شماره (ثانیه)
const MAX_PER_HOUR = 5;        // سقف ارسال در ساعت برای یک شماره

function db(): PDO
{
    $pdo = new PDO('sqlite:' . __DIR__ . '/app.sqlite');
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    $pdo->exec('CREATE TABLE IF NOT EXISTS otp_codes (
        phone TEXT PRIMARY KEY, code_hash TEXT NOT NULL, expires_at INTEGER NOT NULL,
        attempts INTEGER NOT NULL DEFAULT 0, last_sent INTEGER NOT NULL,
        window_start INTEGER NOT NULL, send_count INTEGER NOT NULL)');
    $pdo->exec('CREATE TABLE IF NOT EXISTS users (
        id INTEGER PRIMARY KEY AUTOINCREMENT, phone TEXT UNIQUE NOT NULL)');
    return $pdo;
}

// جانشین: ارسال پیامک واقعی را طبق مستندات سرویس‌دهنده‌ی خودتان بنویسید
function sendSms(string $phone, string $text): void
{
    error_log("[DEV] SMS to $phone: $text");   // فقط برای آزمایش؛ در تولید حذفش کنید
}

// شماره را به قالب 09xxxxxxxxx برمی‌گرداند؛ در غیر این صورت null
function normalizePhone(string $raw): ?string
{
    $raw = strtr($raw, ['۰'=>'0','۱'=>'1','۲'=>'2','۳'=>'3','۴'=>'4','۵'=>'5','۶'=>'6','۷'=>'7','۸'=>'8','۹'=>'9']);
    $digits = preg_replace('/\D+/', '', $raw);
    if (str_starts_with($digits, '98')) { $digits = '0' . substr($digits, 2); }
    return preg_match('/^09\d{9}$/', $digits) ? $digits : null;
}

function hashCode(string $phone, string $code): string
{
    return hash_hmac('sha256', $phone . ':' . $code, OTP_SECRET);   // شماره هم وارد چکیده می‌شود
}

// خروجی: 'sent' | 'invalid' | 'wait' | 'limit'
function requestCode(string $rawPhone): string
{
    $phone = normalizePhone($rawPhone);
    if ($phone === null) { return 'invalid'; }

    $pdo = db();
    $now = time();
    $st = $pdo->prepare('SELECT * FROM otp_codes WHERE phone = ?');
    $st->execute([$phone]);
    $row = $st->fetch(PDO::FETCH_ASSOC);

    $count = 1;
    $windowStart = $now;
    if ($row) {
        if ($now - (int)$row['last_sent'] < RESEND_COOLDOWN) { return 'wait'; }   // فاصله‌ی ارسال دوباره
        if ($now - (int)$row['window_start'] < 3600) {
            if ((int)$row['send_count'] >= MAX_PER_HOUR) { return 'limit'; }       // سقف ساعتی
            $count = (int)$row['send_count'] + 1;
            $windowStart = (int)$row['window_start'];
        }
    }

    // شش رقم با مولد امن؛ صفرهای ابتدایی حفظ می‌شوند
    $code = str_pad((string)random_int(0, 999999), 6, '0', STR_PAD_LEFT);

    // ذخیره‌ی چکیده؛ کد قبلی همین شماره خودکار باطل می‌شود و شمارنده‌ی تلاش صفر می‌شود
    $pdo->prepare('INSERT INTO otp_codes (phone, code_hash, expires_at, attempts, last_sent, window_start, send_count)
                   VALUES (?, ?, ?, 0, ?, ?, ?)
                   ON CONFLICT(phone) DO UPDATE SET code_hash = excluded.code_hash,
                   expires_at = excluded.expires_at, attempts = 0, last_sent = excluded.last_sent,
                   window_start = excluded.window_start, send_count = excluded.send_count')
        ->execute([$phone, hashCode($phone, $code), $now + CODE_TTL, $now, $windowStart, $count]);

    sendSms($phone, "کد ورود: $code\nاین کد را به هیچ‌کس ندهید.");
    return 'sent';
}

دو نکته را در این بخش از نمونه به یاد بسپارید. اول این‌که کد شش‌رقمی با random_int ساخته می‌شود، نه با rand. دوم این‌که چکیده‌ی کلیددار ذخیره می‌شود: حتی کسی که کل جدول را بردارد، بدون کلید سرور نمی‌تواند کدها را از روی چکیده پیدا کند.

بررسی کد، ساخت نشست و کد otp در php

حالا نیمه‌ی دوم: بررسی کدی که کاربر وارد کرده است. ترتیب شرط‌ها مهم است. اول انقضا و سقف تلاش، بعد مقایسه، و فقط در صورت درستی ورود و حذف کد.

شمارنده‌ی تلاش را پیش از مقایسه بالا می‌بریم، نه بعد از آن. اگر ربات چند درخواست را هم‌زمان بفرستد، هر درخواست یک تلاش را مصرف می‌کند و نمی‌تواند از فاصله‌ی بین خواندن و نوشتن سوءاستفاده کند.

otp.php؛ ادامه: بررسی کد و ورود
// خروجی: 'ok' | 'invalid' | 'expired' | 'locked'
function verifyCode(string $rawPhone, string $input): string
{
    $phone = normalizePhone($rawPhone);
    if ($phone === null || !preg_match('/^\d{6}$/', $input)) { return 'invalid'; }

    $pdo = db();
    $now = time();

    // ابتدا تلاش را ثبت می‌کنیم تا درخواست‌های هم‌زمان هم شمرده شوند
    $pdo->prepare('UPDATE otp_codes SET attempts = attempts + 1 WHERE phone = ?')->execute([$phone]);
    $st = $pdo->prepare('SELECT * FROM otp_codes WHERE phone = ?');
    $st->execute([$phone]);
    $row = $st->fetch(PDO::FETCH_ASSOC);

    if (!$row || (int)$row['expires_at'] < $now) { return 'expired'; }
    if ((int)$row['attempts'] > MAX_ATTEMPTS) {                      // بیش از سقف: کد سوخته است
        $pdo->prepare('DELETE FROM otp_codes WHERE phone = ?')->execute([$phone]);
        return 'locked';
    }

    // مقایسه‌ی بدون نشت زمان؛ با == یا === مقایسه نکنید
    if (!hash_equals($row['code_hash'], hashCode($phone, $input))) { return 'invalid'; }

    $pdo->prepare('DELETE FROM otp_codes WHERE phone = ?')->execute([$phone]);   // یک‌بارمصرف

    // کاربر را پیدا کن یا بساز
    $pdo->prepare('INSERT OR IGNORE INTO users (phone) VALUES (?)')->execute([$phone]);
    $uid = (int)$pdo->query('SELECT id FROM users WHERE phone = ' . $pdo->quote($phone))->fetchColumn();

    session_start();
    session_regenerate_id(true);   // شناسه‌ی نشست تازه؛ جلوی تثبیت نشست را می‌گیرد
    $_SESSION['user_id'] = $uid;
    return 'ok';
}

برای ثبت نشست، پیش از session_start تنظیم‌های کوکی را هم درست کنید: HttpOnly، Secure برای سایت‌های HTTPS و SameSite. این تنظیم‌ها با session_set_cookie_params انجام می‌شوند و نمونه‌ی بالا را از حالت آزمایشی به حالت واقعی نزدیک می‌کنند.

دو نقطه‌ی ورودی ساده برای فرم ورود

تابع‌ها آماده‌اند. فرم شما فقط باید دو آدرس را صدا بزند. نمونه‌ی زیر پاسخ را به‌شکل JSON می‌دهد تا هر فرمی، از ساده تا Vue، بتواند به آن وصل شود.

api.php؛ دو عملیات
<?php
require __DIR__ . '/otp.php';
header('Content-Type: application/json; charset=utf-8');

$action = $_POST['action'] ?? '';
$phone  = (string)($_POST['phone'] ?? '');

if ($action === 'request') {
    // پیام ثابت می‌دهیم تا ربات نفهمد کدام شماره در سایت ثبت‌نام کرده
    $r = requestCode($phone);
    $msg = ['sent' => 'کد ارسال شد.', 'wait' => 'کمی صبر کنید و دوباره امتحان کنید.',
            'limit' => 'سقف ارسال پر شده؛ بعداً تلاش کنید.', 'invalid' => 'شماره درست نیست.'];
    echo json_encode(['status' => $r, 'message' => $msg[$r]], JSON_UNESCAPED_UNICODE);
} elseif ($action === 'verify') {
    $r = verifyCode($phone, (string)($_POST['code'] ?? ''));
    echo json_encode(['status' => $r], JSON_UNESCAPED_UNICODE);
} else {
    http_response_code(400);
    echo json_encode(['status' => 'bad_request']);
}

اگر فرم را از یک دامنه‌ی دیگر صدا می‌زنید، به CSRF و CORS هم فکر کنید. پیش از انتشار، سقف درخواست بر پایه‌ی IP را هم کنار سقف شماره بگذارید، چون مهاجم می‌تواند شماره‌ها را عوض کند ولی IP یا الگوی رفتارش معمولاً تکرار می‌شود.

عددهای سقف را چطور انتخاب کنیم؟

پنج تلاش، سه دقیقه و شصت ثانیه عددهای مقدس نیستند؛ نقطه‌ی شروع‌اند. هر کدام را باید با رفتار کاربران خودتان تنظیم کنید. این راهنما کمک می‌کند بدانید کدام را کی کم یا زیاد کنید.

اعتبار کد (سه دقیقه)

اگر شکایت «کد رسید ولی منقضی شده بود» زیاد شنیدید، آن را به پنج دقیقه ببرید. بیشتر از این نه، چون هر دقیقه‌ی بیشتر یعنی فرصت بیشتر برای کدی که کسی دیده.

تلاش اشتباه (پنج بار)

کاربر واقعی معمولاً یکی دو بار اشتباه تایپ می‌کند. پنج بار برایش کافی است و برای ربات، شانس حدس درست را به چند در یک میلیون می‌رساند. کمتر از سه بار کاربران عجول را بی‌دلیل قفل می‌کند.

فاصله‌ی ارسال مجدد (شصت ثانیه)

پیامک گاهی تا نیم دقیقه دیر می‌رسد. اگر فاصله کوتاه‌تر باشد، کاربرانی که منتظر نمی‌مانند چند پیامک می‌گیرند و هزینه‌ی شما بالا می‌رود.

سقف ساعتی (پنج پیامک)

برای کاربر عادی فراوان است. اگر شماره‌ای بیش از این می‌خواهد، یا اشتباهی در شماره هست یا حمله. بعد از رسیدن به سقف پیام «بعداً تلاش کنید» کافی است.

سقف بر پایه‌ی IP

یک IP که در ساعت ده‌ها شماره‌ی مختلف را امتحان می‌کند، مشکوک است. ولی مراقب شبکه‌های مشترک مثل دانشگاه و اداره باشید و سقف را سخت‌گیرانه نبندید.

قفل بلندمدت

اگر یک شماره بارها به سقف رسید، می‌توانید برای ساعتی آن را کنار بگذارید و به‌جای آن مسیر دیگری مثل پشتیبانی پیشنهاد کنید.

از نمونه‌ی آزمایشی تا سایت واقعی؛ چه چیزهایی عوض می‌شود؟

کد بالا برای فهمیدن منطق عالی است، ولی پیش از تحویل به کاربران واقعی چند کار باقی می‌ماند. این ترتیب را برای انتشار امن پیشنهاد می‌کنیم.

  1. ۱

    ذخیره‌سازی

    پایگاه‌داده‌ی اصلی پروژه‌ی خودتان را به جای SQLite نمونه بگذارید. در MySQL جدول را با کلید یکتا روی شماره بسازید و عبارت ذخیره را به ON DUPLICATE KEY UPDATE تبدیل کنید.

  2. ۲

    HTTPS و کوکی

    سایت باید روی HTTPS باشد. قبل از session_start، کوکی را با HttpOnly، Secure و SameSite تنظیم کنید.

  3. ۳

    اتصال پیامک واقعی

    محتوای sendSms را طبق مستندات سرویس‌دهنده بنویسید و آن را با زمان‌سنج و ثبت خطا امن کنید. کلید را در متغیر محیطی بگذارید.

  4. ۴

    سقف IP و پایش

    سقف بر پایه‌ی IP اضافه کنید و هر چند روز یک بار گزارش مصرف پنل را ببینید. افزایش ناگهانی نشانه‌ی سوءاستفاده است.

  5. ۵

    پاک‌سازی

    ردیف‌های منقضی را با یک کار زمان‌بندی‌شده حذف کنید تا جدول بی‌دلیل بزرگ نشود.

  6. ۶

    راه جایگزین

    برای کاربری که پیامک نمی‌گیرد، یک راه دیگر مثل ورود با فینگت یا پشتیبانی بگذارید؛ در غیر این صورت او کاملاً بیرون می‌ماند.

اگر سایت شما وردپرسی است و نمی‌خواهید کد بنویسید، افزونه‌های آماده همین مراحل را در خود دارند. گزینه‌های آن در ورود با شماره موبایل وردپرس و راهنمای نصب در افزودن ورود با پیامک به سایت آمده است.

کی php otp را خودتان بنویسید و کی نه؟

نوشتن ورود با موبایل php کار سختی نیست، ولی نگه داشتنش هزینه دارد. پیش از شروع، صادقانه ببینید کدام طرف شما هستید.

نوشتن خودتان وقتی منطقی است که

  • منطق ورود شما خاص است، مثلاً چند نوع کاربر یا ادغام با یک سیستم داخلی.
  • تیمی دارید که امنیت و پایش را در بلندمدت نگه می‌دارد.
  • می‌خواهید همه‌ی کاربران، حتی بدون اپ، با پیامک وارد شوند.

نوشتن خودتان وقتی لازم نیست که

  • فقط می‌خواهید کاربر بدون رمز وارد شود و شماره‌ی تأییدشده‌اش را بگیرید.
  • نمی‌خواهید هزینه‌ی پیامک هر ورود و پشتیبانی کدهای نرسیده را بپردازید.
  • سایت وردپرسی یا ووکامرسی است و افزونه‌ی آماده همان کار را می‌کند.

مسیر میانی هم وجود دارد: ورود پیامکی خودتان را نگه دارید و دکمه‌ی فینگت را کنارش بگذارید. کاربرانی که اپ را دارند سریع‌تر وارد می‌شوند و بار پیامکی شما کم می‌شود. اگر دغدغه‌تان هزینه است، کاهش هزینه otp چند راه دیگر هم نشان می‌دهد.

اشتباه‌های رایج در ارسال کد تأیید با php

بیشتر ضعف‌های ورود با موبایل php در جزئیاتی دیده می‌شود که در نمونه‌های آموزشی ساده‌شده‌اند. این‌ها را پیش از انتشار با کد خودتان مقایسه کنید.

ذخیره‌ی خود کد

اگر کد خام در جدول باشد، هر خطای SQL یا دسترسی به پشتیبان پایگاه‌داده، همه‌ی کدهای زنده را می‌دهد. چکیده‌ی کلیددار این خطر را کم می‌کند.

مقایسه با ===

مقایسه‌ی عادی رشته‌ها با اولین حرف نابرابر متوقف می‌شود و زمان پاسخ را کمی تغییر می‌دهد. hash_equals این نشت را ندارد و همان‌قدر ساده است.

باطل نکردن کد

اگر کد بعد از موفقیت حذف نشود، کسی که آن را دیده تا لحظه‌ی انقضا می‌تواند دوباره از آن استفاده کند.

نبودن سقف تلاش

شش رقم یک میلیون حالت است. بدون سقف، ربات در مدتی کوتاه کد را حدس می‌زند. با پنج تلاش، شانس حدس درست بسیار کم می‌شود.

پیام‌های متفاوت برای شماره‌ی ثبت‌نام‌شده و نشده

اگر سایت بگوید «این شماره عضو نیست»، ربات می‌تواند فهرست مشتریان شما را بیرون بکشد. در پاسخ درخواست کد، یک پیام ثابت بدهید.

نساختن نشست تازه

بدون session_regenerate_id، اگر مهاجم شناسه‌ی نشست را از پیش به کاربر داده باشد، بعد از ورود همان شناسه معتبر می‌شود.

ثبت کد در لاگ

خط error_log نمونه فقط برای آزمایش است. در تولید، کد و شماره را کامل در لاگ ننویسید.

قبل از انتشار؛ چند آزمون ساده

برای هر ورود با موبایل php چند آزمون دستی کافی است؛ با آنها می‌توانید درستی منطق را ببینید. هر مورد را در یک پنجره‌ی ناشناس و با شماره‌ی خودتان امتحان کنید.

  • کد درست ورود انجام شود و بار دوم با همان کد رد شود.
  • کد اشتباه شش بار بار ششم باید قفل و کد سوخته شود و کاربر کد تازه بخواهد.
  • صبر سه دقیقه کد درست بعد از انقضا باید پذیرفته نشود.
  • دو ارسال پشت‌سرهم دومی باید پیام «صبر کنید» بدهد و پیامکی نفرستد.
  • شماره با رقم فارسی شماره‌ای مثل ۰۹۱۲… باید بدون خطا نرمال شود.
  • درخواست دوم، کد اول بعد از درخواست کد تازه، کد قبلی نباید کار کند.
  • رسیدن پیامک در محیط واقعی بسنجید پیامک چند ثانیه طول می‌کشد. اگر دیر رسید، کد تایید نمیاد را ببینید.

همین کار با فینگت چقدر کوتاه می‌شود؟

کدی که تا اینجا نوشتیم باید نگهداری شود: جدول، سقف‌ها، هزینه‌ی هر پیامک و تماس‌های پشتیبانی برای کدی که نرسید. در ورود با فینگت سایت شما هیچ‌کدام از اینها را ندارد.

روش کار شبیه ورود با گوگل است. سایت شما کاربر را به یک لینک می‌فرستد، کاربر در اپ فینگت تأیید می‌کند و مرورگر او با یک کد کوتاه‌عمر (حدود دو دقیقه) به آدرس بازگشت سایت برمی‌گردد. سرور شما آن کد را با یک درخواست POST به finget.ir تبدیل به اطلاعات کاربر می‌کند. اطلاعات شامل نام، شماره‌ی موبایل تأییدشده و شناسه‌ی ثابت کاربر برای همین سایت است.

نمونه‌ی ورود با فینگت در PHP

دو فایل کافی است: یکی لینک ورود را می‌سازد و دیگری آدرس بازگشت است. SITE_ID و کلید API را از پنل سرویس‌دهندگان فینگت می‌گیرید و آدرس بازگشت را هم در همان پنل ثبت می‌کنید.

login.php؛ ساخت لینک ورود
<?php
session_start();
$_SESSION['fg_state'] = bin2hex(random_bytes(16));   // مقدار تصادفی برای جلوگیری از درخواست جعلی
$url = 'https://finget.ir/auth?client_id=SITE_ID&state=' . $_SESSION['fg_state'];
echo '<a href="' . htmlspecialchars($url) . '">ورود با فینگت</a>';
callback.php؛ آدرس بازگشت و گرفتن اطلاعات کاربر
<?php
session_start();
// state همان مقداری باشد که خودمان فرستادیم
if (!hash_equals($_SESSION['fg_state'] ?? '', (string)($_GET['state'] ?? ''))) { http_response_code(400); exit; }
unset($_SESSION['fg_state']);

$ctx = stream_context_create(['http' => [
    'method'  => 'POST',
    'header'  => "Content-Type: application/json\r\nAuthorization: Bearer " . getenv('FINGET_API_KEY') . "\r\n",
    'content' => json_encode(['code' => (string)($_GET['code'] ?? '')]),
    'timeout' => 8,
    'ignore_errors' => true,
]]);
$res  = file_get_contents('https://finget.ir/api/v1/auth/token', false, $ctx);
$data = json_decode((string)$res, true);
if (!isset($data['user']['id'])) { http_response_code(401); exit; }

// $data['user'] شامل id (مثل fgu_...)، name و phone است؛ $data['isNew'] می‌گوید کاربر تازه است
session_regenerate_id(true);
$_SESSION['finget_id'] = $data['user']['id'];   // با این شناسه‌ی ثابت کاربر را پیدا یا بسازید
header('Location: /');

کد بالا نه تابع sendSms دارد، نه جدول کد، نه شمارنده‌ی تلاش. شناسه‌ی fgu برای هر کاربر در سایت شما ثابت می‌ماند و شماره‌ی تأییدشده‌اش را هم می‌گیرید. این روش را کنار فرم فعلی بگذارید و کاربران اپ را سریع‌تر وارد کنید. مفهوم کلی‌تر آن در ورود بدون رمز عبور آمده و برای پیاده‌سازی در یک سایت وردپرسی، ورود با شماره موبایل وردپرس مسیر آماده‌ای دارد.

اپ فینگت فعلاً برای اندروید است؛ پس فرم پیامکی خودتان را برای بقیه‌ی کاربران نگه دارید. ثبت‌نام در پنل و اتصال رایگان است و برای هر ورود پیامکی نمی‌فرستد. می‌توانید از صفحه‌ی دانلود اپ را ببینید.

پرسش‌های متداول درباره ورود با موبایل php

برای ورود با موبایل php حتماً به پایگاه‌داده نیاز دارم؟

برای ذخیره‌ی چکیده‌ی کد و شمارنده‌ها به یک ذخیره‌ی مشترک بین درخواست‌ها نیاز دارید. می‌تواند MySQL، SQLite یا یک حافظه‌ی موقت مثل Redis باشد. ذخیره در فایل یا نشست کاربر امن نیست، چون مهاجم می‌تواند نشست تازه بسازد و شمارنده را صفر کند.

چرا کد را با rand نسازیم؟

خروجی rand و mt_rand از روی چند مقدار قبلی قابل پیش‌بینی است. random_int از منبع تصادفی امن سیستم‌عامل می‌خواند و برای کدهایی که امنیت به آن‌ها تکیه دارد مناسب است.

تابع sendSms در نمونه واقعی نیست؟

درست است. عمداً هیچ سرویس‌دهنده‌ای را نشان نمی‌دهد. آدرس، نام فیلدها و کدهای خطای واقعی را فقط مستندات شرکت پیامکی شما تعیین می‌کند.

چرا شماره هم در چکیده‌ی کد وارد شده است؟

تا یک کد و چکیده‌ی یکسان برای دو شماره‌ی مختلف تولید نشود و چکیده‌ی یک شماره روی شماره‌ی دیگر قابل استفاده نباشد. هزینه‌ای هم ندارد.

زمان انقضای مناسب برای کد چقدر است؟

سه تا پنج دقیقه رایج است. کمتر از آن ممکن است پیامک دیررسیده را از کار بیندازد و بیشتر از آن، فرصت سوءاستفاده از کدی که کسی دیده را زیاد می‌کند.

ورود با فینگت جای این کد را کامل می‌گیرد؟

برای کاربرانی که اپ فینگت دارند بله؛ دیگر نه کدی ساخته می‌شود و نه پیامکی می‌رود. چون اپ فعلاً اندروید است، معمولاً بهتر است دکمه‌ی فینگت کنار ورود پیامکی بماند، نه جای آن.

آدرس بازگشت و کلید فینگت را از کجا بگیرم؟

در پنل سرویس‌دهندگان فینگت: سایت را اضافه می‌کنید، مالکیت دامنه را ثابت می‌کنید، آدرس بازگشت را ثبت می‌کنید و کلید API را برمی‌دارید. کلید را فقط سمت سرور نگه دارید.