آموزش اعتبار‌سنجی (Validation) شماره موبایل و کد ملی با Regex

سلام رفیق برنامه‌نویس! اگه سر و کارت با فرم‌ها و اطلاعات کاربراست، حتماً بارها با چالش اعتبار‌سنجی (Validation) روبه‌رو شدی. اینکه چطور مطمئن بشی شماره موبایلی که کاربر وارد کرده واقعیه یا کد ملیش درست و معتبره، یه دغدغه همیشگیه. فکرش رو بکن، اگه یه دیتابیس پر از اطلاعات غلط و ناقص داشته باشی، چه بلایی سر پروژه‌ت میاد؟ از خطا تو فرایند ثبت‌نام گرفته تا مشکلات امنیتی و حتی از دست دادن مشتری! دقیقاً همینجاست که رگولار اکسپرشن (Regex) مثل یک قهرمان وارد میشه و کار رو برات حسابی راحت می‌کنه. تو این مقاله قراره گام به گام بریم سراغ اعتبار‌سنجی دو تا از مهم‌ترین فیلدهای اطلاعاتی تو ایران: شماره موبایل و کد ملی. پس اگه دنبال یه راه حل قوی و مطمئنی تا اطلاعاتت رو حسابی فیلتر کنی و دیتای تمیز داشته باشی، جای درستی اومدی.
برای اینکه کارت حسابی راه بیفته و ابزارهای مورد نیازت همیشه دم دستت باشه، یه سر به فروشگاه ابزارها بزن، کلی چیزای خفن و کاربردی پیدا می‌کنی!
اگه هم سوالی داشتی یا نیاز به راهنمایی بیشتر بود، همیشه می‌تونی با این شماره تماس بگیری: 09202232789

فهرست مطالب

• چرا اعتبار‌سنجی لازمه؟
• رگولار اکسپرشن (Regex) چیست؟
• اعتبار‌سنجی شماره موبایل ایرانی
  • ساختار شماره موبایل در ایران
  • الگوهای Regex برای شماره موبایل
• اعتبار‌سنجی کد ملی ایرانی
  • ساختار کد ملی و الگوریتم کنترل صحت
  • Regex اولیه برای کد ملی
  • الگوریتم اعتبار‌سنجی پیشرفته
• جزئیات و ترفندهای Regex
• اشتباهات رایج در اعتبار‌سنجی با Regex
• عیب‌یابی سریع: مشکلات رایج و راه‌حل‌ها
• جمع‌بندی
• سوالات متداول (FAQ Schema)

چرا اعتبار‌سنجی لازمه؟

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

• یکپارچگی داده (Data Integrity): اگه داده‌ها معتبر نباشن، دیتابیس شما پر از آشغال میشه. شماره موبایل‌های ناقص، کد ملی‌های الکی، ایمیل‌های ساختگی… اینا باعث میشن گزارش‌هات غلط از آب دربیاد، نتونی با کاربرا ارتباط برقرار کنی و کلاً سیستم‌ت غیرقابل اعتماد بشه.
• تجربه کاربری بهتر (Better UX): هیچ‌کس دوست نداره فرمی رو پر کنه و بعد از سابمیت کردن، با یه عالمه خطای بی‌معنی روبه‌رو بشه. اعتبار‌سنجی بلادرنگ (real-time validation) و پیام‌های خطای واضح، به کاربر کمک می‌کنه تا همون لحظه اشتباهش رو بفهمه و تصحیحش کنه. این یعنی کاربر از سیستم شما تجربه‌ی بهتری خواهد داشت.
• امنیت (Security): داده‌های نامعتبر می‌تونن راه رو برای حملات امنیتی مثل SQL Injection یا Cross-Site Scripting (XSS) باز کنن. اعتبار‌سنجی دقیق، به خصوص برای فیلدهایی مثل کد ملی یا شماره موبایل، یه لایه امنیتی اولیه و ضروریه.
• فرایندهای تجاری صحیح: خیلی از فرایندهای تجاری، مثل ارسال پیامک تأیید، احراز هویت، یا حتی فاکتورینگ، به صحت اطلاعات ورودی وابسته هستن. اگه شماره موبایل یا کد ملی معتبر نباشه، کل این فرایندها مختل میشن و هزینه‌های اضافی بهت تحمیل میشه.

رگولار اکسپرشن (Regex) چیست؟

رگولار اکسپرشن، یا همون Regex، یه توالی از کاراکترهاست که برای تعریف یک الگوی جستجو تو متن استفاده میشه. فکر کن می‌خوای تو یه سند بزرگ دنبال همه شماره تلفن‌ها یا آدرس ایمیل‌ها بگردی؛ تایپ کردن هر فرمت ممکن خیلی سخته. Regex بهت این امکان رو میده که یه الگو (Pattern) کلی تعریف کنی و به کامپیوتر بگی هر چیزی که این الگو رو داشت، پیدا کن. این الگوها شامل کاراکترهای معمولی (مثل حروف و اعداد) و فراداده‌ها (Metacharacters) هستن که معنی خاصی دارن. مثلاً `d` یعنی “هر رقمی” و `+` یعنی “یک یا بیشتر از عنصر قبلی”.

Regex یه ابزار فوق‌العاده قدرتمنده برای پیدا کردن، جایگزین کردن و اعتبار‌سنجی رشته‌ها. یادگیریش شاید اولش کمی گیج‌کننده به نظر بیاد، ولی اگه مفاهیم پایه رو درک کنی، دیگه ازش جدا نمیشی. اگه میخوای اطلاعات بیشتری در مورد Regex و کاربردهاش به دست بیاری، حتماً یه سر به صفحه اصلی fa-tools بزن. اونجا کلی منابع مفید پیدا می‌کنی که بهت کمک می‌کنه تا مهارت‌هات رو ارتقا بدی.

چند تا از فراداده‌های مهم در Regex:

• `.` (نقطه): هر کاراکتری به جز خط جدید.
• `d`: هر رقم (0-9). معادل `[0-9]`.
• `w`: هر حرف، رقم یا آندرلاین. معادل `[a-zA-Z0-9_]`.
• `s`: هر کاراکتر فاصله (مثل اسپیس، تب، خط جدید).
• `*`: صفر یا بیشتر از عنصر قبلی.
• `+`: یک یا بیشتر از عنصر قبلی.
• `?`: صفر یا یک از عنصر قبلی (اختیاری).
• `{n}`: دقیقاً `n` بار از عنصر قبلی.
• `{n,m}`: بین `n` تا `m` بار از عنصر قبلی.
• `^`: شروع خط/رشته.
• `$`: پایان خط/رشته.
• `[]`: مجموعه‌ای از کاراکترها. مثلاً `[abc]` یعنی ‘a’ یا ‘b’ یا ‘c’.
• `()`: گروه بندی. برای اعمال کوانتفایرها یا استخراج زیررشته‌ها.
• `|`: یا (OR). مثلاً `cat|dog` یعنی ‘cat’ یا ‘dog’.

اعتبار‌سنجی شماره موبایل ایرانی

اعتبار‌سنجی شماره موبایل تو ایران یه داستان مخصوص خودشو داره. برخلاف خیلی از کشورها که شاید فرمت‌های خیلی متنوعی نداشته باشن، تو ایران ممکنه کاربرا شماره رو با صفر اول، بدون صفر، با کد کشور (+98)، یا حتی با فاصله و خط تیره وارد کنن. ما باید بتونیم تا جای ممکن این حالت‌ها رو پوشش بدیم.

ساختار شماره موبایل در ایران

شماره موبایل‌های ایرانی معمولاً ۱۱ رقمی هستن که با `09` شروع میشن. بعد از `09`، دو رقم بعدی پیش‌شماره اپراتور رو مشخص می‌کنه (مثل 0912 برای همراه اول، 0935 برای ایرانسل و…). بعد از اون هم ۷ رقم بعدی، شماره اختصاصی مشترکه.

الگوهای Regex برای شماره موبایل

بریم سراغ سناریوهای مختلف و Regex‌های مربوط به هر کدوم:

^09d{9}$

^(+98|0)?9d{9}$

^(+98|0)?9d{2}[- ]?d{3}[- ]?d{4}$

نکته مهم:

اعتبار‌سنجی Regex فقط ساختار رو بررسی می‌کنه، نه وجود واقعی شماره. یعنی با Regex نمی‌تونی بفهمی یه شماره موبایل واقعاً فعال هست یا نه. برای این کار نیاز به سرویس‌های احراز هویت پیامکی (OTP) داری.

اعتبار‌سنجی کد ملی ایرانی

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

ساختار کد ملی و الگوریتم کنترل صحت

کد ملی ایرانی یک عدد ۱۰ رقمیه که از سمت چپ، سه رقم اول کد شهرستان محل صدور رو نشون میده. ۷ رقم بعدی به صورت تصادفی اختصاص داده میشن و رقم دهم هم رقم کنترل (Check Digit) هست که با یک الگوریتم خاص محاسبه میشه. این رقم کنترل کمک می‌کنه تا از وارد کردن کد ملی‌های اشتباه یا تایپی جلوگیری بشه.

الگوریتم محاسبه رقم کنترل (روش ساده):

1. 9 رقم اول کد ملی رو در نظر بگیر.
2. هر رقم رو به ترتیب در اعداد 10 تا 2 ضرب کن (رقم اول در 10، رقم دوم در 9 و … رقم نهم در 2).
3. حاصل ضرب‌ها رو با هم جمع کن.
4. مجموع رو بر 11 تقسیم کن و باقیمانده رو به دست بیار.
5. اگه باقیمانده کوچکتر از 2 بود، رقم کنترل باید برابر با همون باقیمانده باشه.
6. اگه باقیمانده بزرگتر یا مساوی 2 بود، رقم کنترل باید برابر با `11 – باقیمانده` باشه.
7. در نهایت، این رقم کنترلی که محاسبه کردی باید با رقم دهم کد ملی ورودی برابر باشه.

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

Regex اولیه برای کد ملی

اولین گام تو اعتبار‌سنجی کد ملی، اینه که مطمئن بشیم ورودی یک عدد ۱۰ رقمیه و شامل حروف یا کاراکترهای دیگه نیست. این کار رو به راحتی با Regex میشه انجام داد:

^d{10}$

این Regex فقط چک می‌کنه که رشته‌ی وارد شده دقیقاً ۱۰ رقم عددی باشه. اما همونطور که گفتم، این تازه اول کاره. کد ملی مثل `1111111111` یا `1234567890` با این Regex معتبر شناخته میشه، در حالی که در واقعیت نامعتبرن.

الگوریتم اعتبار‌سنجی پیشرفته (همراه با کدنویسی)

برای اعتبار‌سنجی کامل کد ملی، باید Regex رو با کدنویسی ترکیب کنیم. این یه مثال از چگونگی پیاده‌سازی این الگوریتم به زبان JavaScript هست. تو زبان‌های دیگه مثل PHP یا Python هم منطق کار دقیقاً همینه.

function isValidIranianNationalCode(input) {
    if (!/^d{10}$/.test(input)) return false; // Regex اولیه: 10 رقم عددی
    
    // از بین بردن صفرهای اضافی از سمت چپ (اگر وجود داشته باشد)
    const nationalCode = ("0000000000" + input).slice(-10);

    // بررسی کدهای ملی تکراری (مثلاً 1111111111)
    if (/^(d)1{9}$/.test(nationalCode)) return false;

    let sum = 0;
    for (let i = 0; i < 9; i++) {
        sum += parseInt(nationalCode[i]) * (10 - i);
    }
    const remainder = sum % 11;
    const controlDigit = parseInt(nationalCode[9]);

    if (remainder < 2) {
        return controlDigit === remainder;
    } else {
        return controlDigit === (11 - remainder);
    }
}

// مثال استفاده:
// console.log(isValidIranianNationalCode("0023963004")); // یک کد ملی معتبر - true
// console.log(isValidIranianNationalCode("1234567890")); // نامعتبر - false (رقم کنترل اشتباه)
// console.log(isValidIranianNationalCode("1111111111")); // نامعتبر - false (رقم تکراری)
// console.log(isValidIranianNationalCode("002396300X")); // نامعتبر - false (حرف)
        

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

جزئیات و ترفندهای Regex

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

• Lookahead و Lookbehind: اینا ابزارهایی هستن که به Regex اجازه میدن بدون مصرف کردن کاراکترها (یعنی بدون اینکه تو رشته مطابقت یافته قرار بگیرن)، جلو یا عقب رو نگاه کنن. مثلاً `(?=pattern)` (positive lookahead) چک می‌کنه که بلافاصله بعد از موقعیت فعلی، الگو وجود داشته باشه.
• کوانتیفایر حریص (Greedy) در برابر غیرحریص (Lazy): به طور پیش‌فرض، کوانتیفایرهایی مثل `*`, `+`, `?` و `{}` تا جای ممکن بیشترین تطابق رو پیدا می‌کنن (Greedy). با اضافه کردن `?` بعد از کوانتیفایر، می‌تونید اون رو Lazy کنید تا کمترین تطابق رو پیدا کنه. مثلاً `.*?`
• گروه‌های Non-capturing: اگه گروهی رو فقط برای گروه بندی می‌خواین و نمی‌خواین محتوای اون گروه رو ذخیره کنید، از `(?:…)` به جای `(…)` استفاده کنید. این کار کمی عملکرد رو بهتر می‌کنه.
• پرهیز از Backtracking زیاد: Regex‌های پیچیده با کوانتیفایرهای زیاد روی الگوهای طولانی می‌تونن باعث مشکل “Catastrophic Backtracking” بشن و برنامه رو کند کنن. سعی کنید الگوها رو تا جای ممکن مشخص و دقیق بنویسید و از تودرتویی بیش از حد بپرهیزید.

اشتباهات رایج در اعتبار‌سنجی با Regex

حتی حرفه‌ای‌ها هم گاهی تو استفاده از Regex دچار اشتباه میشن. اینجا چند تا از رایج‌ترین اشتباهات رو می‌گم تا تو به دامشون نیفتی:

• اعتبار‌سنجی بیش از حد (Over-validation): گاهی اوقات توسعه‌دهنده‌ها Regex رو خیلی سخت‌گیرانه می‌نویسن. مثلاً شماره موبایلی که با فاصله وارد شده رو رد می‌کنن. این کار تجربه کاربری رو بد می‌کنه و ممکنه کاربرا از ثبت‌نام منصرف بشن. همیشه سعی کن تا جای ممکن انعطاف‌پذیر باشی ولی از چهارچوب استاندارد خارج نشی.
• اعتبار‌سنجی ناکافی (Under-validation): از اون طرف، اگه Regex خیلی ساده باشه (مثلاً فقط چک کنه ۱۰ رقم عددی باشه برای کد ملی)، اطلاعات غلط رو از فیلتر رد می‌کنه. باید یه تعادل بین سخت‌گیری و انعطاف‌پذیری ایجاد کنی.
• فراموش کردن Anchor‌ها (`^` و `$`): اگه `^` و `$` رو اول و آخر Regex نذاری، Regex فقط چک می‌کنه که الگو *در جایی از رشته* وجود داشته باشه، نه اینکه *کل رشته* دقیقاً همون الگو باشه. این می‌تونه نتایج اشتباهی بده.
• عدم در نظر گرفتن موارد خاص: مثلاً برای شماره موبایل، باید حالت‌های شروع با ۰۹، +۹۸۹ و حتی ۹ رو پوشش بدی. اگه فقط روی یه حالت تمرکز کنی، ممکنه کلی کاربر رو از دست بدی.
• پیچیده‌سازی بی‌مورد: گاهی وقت‌ها یه Regex خیلی پیچیده برای یه کار ساده نوشته میشه. سعی کن همیشه از ساده‌ترین و خواناترین Regex که کار رو راه میندازه استفاده کنی. پیچیدگی زیاد، احتمال خطا رو بالا میبره و نگهداری کد رو سخت می‌کنه.

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

عیب‌یابی سریع: مشکلات رایج و راه‌حل‌ها

هیچ پروژه‌ای بدون چالش نیست! تو کار با Regex هم ممکنه به مشکلاتی بخوری. اینجا چند تا از مشکلات رایج و راه حل‌های سریعشون رو آوردم:

جمع‌بندی

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

همیشه یادت باشه که اعتبار‌سنجی دقیق، فقط یه کار فنی نیست، بلکه یه سرمایه‌گذاری برای کیفیت داده‌ها، امنیت سیستم و رضایت کاربرات محسوب میشه. پس هیچوقت ازش غافل نشو و همیشه سعی کن بهترین و کامل‌ترین روش‌ها رو برای اعتبار‌سنجی اطلاعاتت به کار ببری. امیدوارم این مقاله برات مفید بوده باشه و بتونی با اعتماد به نفس بیشتری از Regex تو پروژه‌هات استفاده کنی. دمت گرم که تا اینجا همراه ما بودی!

سوالات متداول (FAQ Schema)

آموزش اعتبار‌سنجی (Validation) شماره موبایل و کد ملی با Regex

ورود داده‌های نامعتبر یکی از بزرگ‌ترین چالش‌ها در فرم‌های وب و اپلیکیشن‌ها است. کاربران ممکن است به اشتباه یا به عمد، شماره موبایل یا کد ملی خود را با فرمتهای نادرست وارد کنند. استفاده از عبارت‌های منظم (Regex) یکی از سریع‌ترین و بهینه‌ترین روش‌ها برای اعتبارسنجی ورودی‌های کاربر در همان ابتدای کار است. در این مقاله جامع و کابردی، یاد می‌گیریم که چطور با استفاده از الگوهای دقیق Regex، صحت شماره موبایل و کد ملی ایرانی را بررسی کنیم. همچنین با ارائه کدهای آماده و روش‌های بهینه‌سازی فرم‌ها، تجربه کاربری سایت شما را به شدت بهبود می‌بخشیم.

چرا اعتبار‌سنجی با Regex اهمیت دارد؟

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

عبارت‌های منظم (Regular Expressions) به ما این امکان را می‌دهند که بدون نیاز به نوشتن کدهای شرطی طولانی و پیچیده، ساختار دقیق ورودی را در یک خط کد ارزیابی کنیم. با ترکیب اعتبار سنجی فرانت‌اند و بک‌اند، یک لایه دفاعی قوی برای فرم‌های خود ایجاد می‌کنید. برای طراحی فرم‌های زیبا و بررسی رفتارهای ظاهری فیلدها می‌توانید از کدهای بخش سنیپت‌های CSS برای استایل‌دهی به وضعیت‌های معتبر و نامعتر ورودی‌ها کمک بگیرید.

اعتبار‌سنجی شماره موبایل ایران با Regex

شماره موبایل در ایران فرمت‌های گوناگونی دارد که ناشی از نحوه ورود اطلاعات توسط کاربران مختلف است. برخی از افراد شماره خود را با صفر شروع می‌کنند، برخی با کد کشور (+98 یا 0098) و برخی نیز شماره را بدون صفر و صرفاً با عدد 9 می‌نویسند. برای ایجاد یک تجربه کاربری عالی، سیستم شما باید تمامی این حالت‌ها را شناسایی کرده و بپذیرد.

تحلیل فرمت‌های مختلف شماره موبایل در ایران

به‌طور کلی، الگوهای پذیرفته‌شده برای یک شماره تلفن همراه معتبر ایرانی به شرح زیر است:

• فرمت استاندارد: 09123456789 (۱۱ رقم)
• فرمت بین‌المللی با پلاس: +989123456789 (۱۲ کاراکتر)
• فرمت بین‌المللی با دو صفر: 00989123456789 (۱۴ رقم)
• فرمت بدون صفر ابتدایی: 9123456789 (۱۰ رقم)

الگوهای مختلف Regex برای شماره موبایل

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

^(0|0098|+98)?9d{9}$

^(0|0098|+98)?9(0[1-5]|[13]d|2[0-3]|9[0-9]|41)d{7}$

پیاده‌سازی در زبان‌های برنامه‌نویسی

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

پیاده‌سازی در جاوا اسکریپت (سمت کلاینت):

با استفاده از متد test() در جاوا اسکریپت، به راحتی ورودی کاربر را ارزیابی کنید. برای تماشای کدهای تکمیلی فرانت‌اند، حتما به آرشیو سنیپت‌های JS سر بزنید.

function validateMobile(mobileNumber) {
    const regex = /^(0|0098|+98)?9d{9}$/;
    return regex.test(mobileNumber);
}

// تست تابع
console.log(validateMobile("09121234567")); // خروجی: true
console.log(validateMobile("+989351234567")); // خروجی: true
console.log(validateMobile("123456")); // خروجی: false

پیاده‌سازی در پایتون (سمت سرور):

پایتون ابزاری بسیار قدرتمند برای اعتبارسنجی ورودی‌های ارسالی به سرور (Backend) است. برای توسعه پروژه‌های بک‌اند خود می‌توانید از الگوهای موجود در سنیپت‌های پایتون نیز ایده بگیرید.

import re

def validate_mobile(mobile):
    pattern = r"^(0|0098|+98)?9d{9}$"
    if re.match(pattern, mobile):
        return True
    return False

# تست متد
print(validate_mobile("09123456789")) # خروجی: True
print(validate_mobile("0912abc"))     # خروجی: False

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

اعتبار‌سنجی کد ملی ایران با Regex

کد ملی ایرانیان یک رشته ۱۰ رقمی منحصربه‌فرد است. برعکس شماره موبایل، برای کد ملی صرفاً بررسی تعداد کاراکترها و فرمت عددی کافی نیست. هر کد ملی از یک ساختار ریاضی خاص پیروی می‌کند که از ایجاد شماره‌های تصادفی جلوگیری می‌کند.

ساختار استاندارد کد ملی ایران

یک کد ملی از سه بخش کلی تشکیل شده است:

• ۳ رقم اول: کد شهرستان صادرکننده کارت ملی
• ۶ رقم بعدی: یک شماره سریال منحصربه‌فرد
• رقم دهم (آخر): رقم کنترلی (Check Digit) که صحت ۹ رقم قبلی را مشخص می‌کند.

الگوی Regex برای بررسی ساختار اولیه کد ملی

قبل از اجرای محاسبات ریاضی سنگین روی سرور، ابتدا باید با استفاده از Regex مطمئن شویم ورودی کاربر دقیقاً ۱۰ رقم عددی است. برخی کدهای ملی با صفر یا دو صفر شروع می‌شوند، بنابراین باید دقت کنیم که این صفرها حذف نشوند.

^d{10}$

الگوی بالا ساده‌ترین راه است. اگر بخواهیم جلوی ورود شناسه‌هایی که همه ارقام آنها یکسان هستند را (مانند 1111111111 یا 0000000000) با Regex بگیریم، می‌توانیم از الگوی زیر بهره ببریم:

^(?!(d)1{9})d{10}$

الگوریتم صحت‌سنجی ریاضی کد ملی

بعد از برسی فرمت ۱۰ رقمی ورودی، نوبت به پیاده‌سازی الگوریتم ریاضی می‌رسد. این فرآیند به صورت گام‌به‌گام به شرح زیر است:

1. هر یک از ۹ رقم اول را در موقعیت مکانی آن ضرب می‌کنیم (رقم اول ضرب در ۱۰، رقم دوم ضرب در ۹، … و رقم نهم ضرب در ۲).
2. مجموع تمام حاصل‌ضرب‌ها را محاسبه می‌کنیم.
3. باقیمانده تقسیم مجموع حاصل‌ضرب‌ها بر عدد ۱۱ را محاسبه می‌کنیم (باقیمانده = مجموع % ۱۱).
4. اگر باقیمانده کمتر از ۲ باشد، رقم دهم (کنترلی) باید برابر خود باقیمانده باشد.
5. اگر باقیمانده بزرگتر یا مساوی ۲ باشد، رقم دهم باید برابر با (۱۱ منهای باقیمانده) باشد.

پیاده‌سازی الگوریتم کامل در جاوا اسکریپت:

function validateNationalCode(code) {
    // بررسی فرمت 10 رقمی و عدم تکرار ارقام یکسان
    if (!/^d{10}$/.test(code) || /(d)1{9}/.test(code)) return false;

    let sum = 0;
    for (let i = 0; i < 9; i++) {
        sum += parseInt(code.charAt(i)) * (10 - i);
    }

    const remainder = sum % 11;
    const lastDigit = parseInt(code.charAt(9));

    if (remainder < 2) {
        return lastDigit === remainder;
    } else {
        return lastDigit === (11 - remainder);
    }
}

// مثال‌های تست
console.log(validateNationalCode("0012345678")); // احتمال بالا به دلیل ساختگی بودن نادرست است (false)

جدول مقایسه روش‌های اعتبارسنجی

برای این که تصمیم بگیرید چه سطحی از اعتبارسنجی را برای پروژه‌های خود انتخاب کنید، جدول مقایسه‌ای زیر به شما دید بهتری می‌دهد:

عیب‌یابی سریع و رفع خطاهای رایج

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

سوالات متداول (FAQ)

{
“@context”: “https://schema.org”,
“@type”: “FAQPage”,
“mainEntity”: [
{
“@type”: “Question”,
“name”: “آیا Regex به تنهایی برای اعتبارسنجی کدملی کافی است؟”,
“acceptedAnswer”: {
“@type”: “Answer”,
“text”: “خیر. الگوهای Regex فقط ساختار ظاهری را بررسی می‌کنند. برای صحت‌سنجی نهایی، پیاده‌سازی الگوریتم ریاضی بررسی رقم کنترلی دهم الزامی است.”
}
},
{
“@type”: “Question”,
“name”: “تفاوت الگوی موبایل ساده با الگوی سخت‌گیرانه چیست؟”,
“acceptedAnswer”: {
“@type”: “Answer”,
“text”: “الگوی ساده پذیرای هر شماره ۱۱ رقمی است که پس از صفر با ۹ شروع شود. اما الگوی سخت‌گیرانه، پیش‌شماره‌های رسمی هر اپراتور ایرانی (ایرانسل، همراه اول و غیره) را مو به مو بررسی و تایید می‌کند.”
}
},
{
“@type”: “Question”,
“name”: “چگونه ورودی‌های فارسی را همزمان در دسکتاپ و موبایل معتبر کنیم؟”,
“acceptedAnswer”: {
“@type”: “Answer”,
“text”: “بهترین روش، تبدیل کاراکترهای فارسی و عربی اعداد به اعداد انگلیسی در فرانت‌اند، قبل از انجام فرآیند اعتبارسنجی Regex است.”
}
}
]
}