سورس‌کد

قالب شروع SaaS فارسی با PHP

یک سرویس اشتراکی کامل با پرداخت PayStar که روی هاست cPanel نصب می‌شود و شما برندش را عوض می‌کنید

PHP ساده، بدون Composer و بدون فریم‌ورک
سازگار با PHP 7.4 به بالا و هاست اشتراکی cPanel
MySQL با PDO و SQLite برای اجرای محلی
پرداخت PayStar با تأیید سمت سرور و فعال‌سازی دقیقاً یک‌باره
پنل مدیریت، تاریخ شمسی و حالت تیره
کتاب فارسی ده‌فصلی و تست سرتاسری

بیشتر زمان ساختن یک سرویس اشتراکی صرف بخش‌های تکراری می‌شود: ثبت‌نام، ورود، پلن، پرداخت و پنل مدیریت. این بسته همان بخش‌ها را به شما می‌دهد تا وقتتان را روی قابلیت اصلی سرویس خودتان بگذارید.

برای چه کسی است

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

چه چیزی داخل آن است

Front Controller با .htaccess و نصب‌کنندهٔ وب
ثبت‌نام و ورود با موبایل و رمز، با password_hash، محدودیت تلاش، CSRF و سخت‌سازی سشن
پلن و اشتراک با انقضا، تمدید و سهمیهٔ هر پلن
پرداخت با PayStar که روی سرور تأیید می‌شود و اشتراک را دقیقاً یک بار فعال می‌کند
داشبورد کاربر با یک قابلیت نمونه: لینک کوتاه با سهمیه
پنل مدیریت برای کاربران، پلن‌ها، پرداخت‌ها و تمدید دستی
تاریخ شمسی، اعداد فارسی، رابط راست‌به‌چپ با حالت تیره، صفحهٔ فرود و نقشهٔ سایت

کتاب و تست

کتاب PDF ده فصل دارد: نصب روی cPanel، معماری، پرداخت، افزودن قابلیت و پلن، تغییر ظاهر، امنیت، تست و چک‌لیست انتشار. یک تست سرتاسری هم همراه درگاه آزمایشی در بسته است که امضاهای HMAC را بررسی می‌کند و سناریوهایی مثل callback تکراری و دستکاری مبلغ را آزمایش می‌کند.

چطور از آن استفاده می‌شود

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

چه چیزی ندارد

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

داخل بسته چیست؟

سورس کامل با ۵۳ فایل PHP، به‌علاوهٔ CSS، JS و فایل‌های .htaccess
کتاب PDF فارسی با ۱۰ فصل
تست سرتاسری tests/e2e.php با ۱۴۲ بررسی
درگاه آزمایشی tests/mock_paystar.php برای توسعهٔ محلی
بررسی‌کنندهٔ سازگاری با PHP 7.4 در tests/check_php74.php
فایل README و نمونهٔ تنظیمات با مقادیر placeholder

پیش‌نیازها

هاست با PHP 7.4 یا بالاتر و افزونه‌های PDO، pdo_mysql، cURL و mbstring
دیتابیس MySQL یا MariaDB
وب‌سرور Apache یا LiteSpeed که .htaccess را بخواند
برای پرداخت واقعی: درگاه فعال PayStar به نام خودتان
آشنایی مقدماتی با PHP و کار با cPanel

مجوز استفاده و منبع

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

پرسش‌های این محصول

روی PHP 7.4 تست شده است؟

کد با PHP 8.5 اجرا و تست شده و با یک بررسی‌کنندهٔ ایستا مطمئن شده‌ایم سینتکس یا تابع مخصوص PHP 8 ندارد، ولی تست سرتاسری روی خود PHP 7.4 اجرا نشده است. اگر هاست شما PHP 7.4 دارد، قبل از انتشار tests/e2e.php را روی همان نسخه اجرا کنید.

آیا با درگاه واقعی PayStar آزمایش شده است؟

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

می‌توانم درگاه دیگری وصل کنم؟

بله، ولی آماده نیست و باید خودتان بنویسید. منطق درگاه در دو فایل app/PayStar.php و app/Payments.php است و بقیهٔ برنامه به آن وابسته نیست.

برای شروع حتماً درگاه لازم دارم؟

نه. برنامه بدون درگاه هم نصب و اجرا می‌شود و برای توسعهٔ محلی درگاه آزمایشی در بسته هست. فقط برای دریافت پول واقعی به درگاه فعال نیاز دارید.

با Nginx کار می‌کند؟

کد کار می‌کند، ولی Nginx فایل .htaccess را نمی‌خواند، پس باید قوانین هدایت مسیر و بستن پوشه‌های app و storage را خودتان در کانفیگ سرور بنویسید.