گردو
راهنمای استقرار Laravel و PHP

چطور پروژه Laravel و PHP را روی گردو دیپلوی کنیم؟

راهنمای عملی استقرار Laravel، PHP و Artisan روی PaaS گردو از Git یا Gerdoo CLI؛ شامل دستور ساخت، دستور اجرا، متغیرها، دامنه و نکات محیط عملیاتی.

پاسخ کوتاه

مخزن پروژه Laravel و PHP را به PaaS گردو متصل کنید یا داخل پوشه پروژه gerdoo deploy را اجرا کنید. گردو پروژه را می‌سازد، سرویس را در محیط ایزوله اجرا می‌کند و دامنه موقت، SSL، «لاگ‌ها» و مدیریت نسخه‌ها را در اختیار شما می‌گذارد.

آخرین بازبینی: ۱۴۰۵/۰۶/۱۵

پروژه را برای استقرار آماده کنید

فایل‌های وابستگی یعنی composer.json و composer.lock را در مخزن ثبت کنید. مقادیر معمول فیلدهای «دستور ساخت» و «دستور اجرا» برای این استک:

# دستور ساخت
composer install --no-dev --optimize-autoloader && php artisan config:cache

# دستور اجرا
php artisan serve --host=0.0.0.0 --port=$PORT

APP_KEY، APP_ENV، APP_URL و اطلاعات دیتابیس را به‌صورت variable ثبت کنید.

استقرار از Git

  1. در پنل گردو یک پروژه و محیط بسازید.
  2. سرویس جدید را به مخزن GitHub یا GitLab و شاخه موردنظر متصل کنید.
  3. فیلدهای «دستور ساخت» و «دستور اجرا» را با ساختار واقعی پروژه تطبیق دهید.
  4. مقادیر لازم را در بخش «متغیرها» وارد و نوع زمان ساخت یا زمان اجرا را مشخص کنید.
  5. استقرار را اجرا کنید و لاگ ساخت و لاگ اجرا را تا عبور بررسی سلامت دنبال کنید.
  6. در بخش «دامنه‌ها»، دامنه اختصاصی را متصل و پاسخ HTTPS را آزمایش کنید.

استقرار از پوشه محلی با Gerdoo CLI

curl -fsSL https://get.gerdoo.cloud/install.sh | sh
gerdoo login
cd your-project
gerdoo deploy
gerdoo logs

CLI پوشه محلی را بدون نیاز به اتصال Git منتشر می‌کند. برای CI می‌توانید توکن را از محیط بخوانید و وضعیت سرویس را با خروجی JSON بررسی کنید. راهنمای کامل در مستندات CLI قرار دارد.

چک‌لیست محیط عملیاتی برای Laravel و PHP

  • migration را آگاهانه و پس از backup اجرا کنید.
  • queue worker و scheduler را به‌صورت سرویس یا cron جدا اجرا کنید.
  • برای فایل‌های upload از دیسک ماندگار یا MinIO استفاده کنید.
  • مسیر بررسی سلامت، زمان انتظار و رفتار شروع مجدد را پیش از دریافت ترافیک واقعی آزمایش کنید.
  • داده را بیرون از فایل‌سیستم نسخه اجرایی، در «افزونه‌ها» یا «ذخیره‌سازی» ماندگار نگه دارید.
  • از بخش «استقرارها» یک «بازگشت به نسخهٔ قبلی» آزمایشی انجام دهید تا مسیر بازیابی تیم مشخص باشد.

مدیریت با Gerdoo Agents

پس از اتصال MCP گردو، Agentهای سازگار مانند Claude Code، Cursor و Codex می‌توانند سرویس را پیدا کنند، استقرار را اجرا کنند، «ساخت‌ها» و «لاگ‌ها» را بخوانند و «متغیرها»، «دامنه‌ها» و وضعیت سرویس را مدیریت کنند. عملیات مخرب همچنان به تأیید صریح نیاز دارند. راهنمای اتصال Agents را ببینید.

سوالات پرتکرار

آیا Laravel و PHP بدون Dockerfile روی گردو اجرا می‌شود؟

بله. اگر فایل‌های استاندارد پروژه مانند composer.json و composer.lock در مخزن باشند، گردو می‌تواند فرایند ساخت را تشخیص دهد. برای کنترل کامل نیز Dockerfile پشتیبانی می‌شود.

پروژه Laravel و PHP را می‌توان با CLI منتشر کرد؟

بله. داخل پوشه پروژه gerdoo deploy را اجرا کنید. نخستین اجرا سرویس را ایجاد و دفعات بعد همان سرویس را به‌روزرسانی می‌کند.

دامنه و SSL چگونه فعال می‌شوند؟

بعد از deploy یک دامنه موقت دارید. دامنه اختصاصی را از تنظیمات سرویس اضافه کنید تا گواهی SSL به‌صورت خودکار صادر شود.

متغیرهای محرمانه کجا قرار می‌گیرند؟

مقادیر محرمانه را در بخش «متغیرها»ی سرویس یا محیط ثبت کنید و آن‌ها را داخل Git، Dockerfile یا کد مرورگر قرار ندهید.