الدليل الشامل للنشر التلقائي عبر GitHub Webhook واستضافة cPanel

إذا كان مستودعك على GitHub خاصاً (Private)، يحتاج السيرفر لتوكن دائم حتى يسحب التحديثات تلقائياً بدون أن يسألك عن اسم المستخدم وكلمة السر في كل عملية.

1. ادخل إلى حسابك في GitHub واضغط على صورتك بالأعلى ثم اختر Settings.
2. من القائمة الجانبية اليسرى بالأسفل، اضغط على Developer Settings.
3. اختر Personal access tokens ثم Tokens (classic).
4. اضغط Generate new token (classic) واكتب اسماً للمفتاح (مثل: cpanel-deploy).
5. ضع علامة صح ✓ على صلاحية repo (Full control of private repositories).
6. اضغط زر Generate token وانسخ الرمز الذي يبدأ بـ ghp_... واحفظه معك.

لا حاجة لإنشاء أي Controller إضافي. نقوم بكتابة المسار كـ Closure Route مباشر وسريع داخل ملف routes/api.php:

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Route;

// ─────────────────────────────────────────────────────────────────────────────
// GitHub Auto-Deploy Webhook (Closure Route)
// ─────────────────────────────────────────────────────────────────────────────
Route::match(['get', 'post'], '/deploy-webhook', function (Request $request) {
    // 1. المفتاح السري المعتمد
    $secret = env('DEPLOY_SECRET', 'TERKO_DEPLOY_SECRET_2026');
    $providedSecret = $request->query('secret') ?: $request->input('secret');

    // قائمة المفاتيح المقبولة
    $validSecrets = array_filter([$secret, 'TERKO_DEPLOY_SECRET_2026']);

    // 2. التحقق من تطابق الـ Secret
    if (!empty($validSecrets) && !in_array($providedSecret, $validSecrets, true)) {
        return response()->json([
            'status' => 'error',
            'message' => 'Unauthorized: Invalid deploy secret'
        ], 403);
    }

    // 3. الانتقال لمجلد المشروع وسحب التحديثات وتفريغ الكاش
    $baseDir = base_path();
    $command = "cd {$baseDir} && git pull origin main 2>&1 && php artisan optimize:clear 2>&1";
    $output = shell_exec($command);

    // 4. إرجاع النتيجة بتنسيق JSON إلى GitHub
    return response()->json([
        'status' => 'success',
        'message' => 'Deployed successfully',
        'output' => $output,
        'timestamp' => now()->toIso8601String(),
    ], 200);
});

لأن طلب GitHub يأتي من خارج المتصفح، يجب استثناء الرابط من الـ CSRF Token حتى لا يرفضه السيرفر بخطأ 419 Page Expired:

أ) في Laravel 11 (ملف bootstrap/app.php):

    ->withMiddleware(function (Middleware $middleware) {
        $middleware->validateCsrfTokens(except: [
            'api/*',
            'deploy-webhook',
        ]);
    })

ب) في Laravel 10 و 9 (ملف app/Http/Middleware/VerifyCsrfToken.php):

protected $except = [
    'api/*',
    'deploy-webhook',
];

افتح شاشة Terminal داخل cPanel (أو اتصل بـ SSH)، وانتقل لمجلد الموقع الخاص بك ونفذ هذا السطر الكامل الجاهز للنسخ:

cd /home/saydleya/public_html/stores.saydleyat.com && git init && git remote add origin https://gabershemy:[email protected]/gabershemy/DrugsStoresApp.git || git remote set-url origin https://gabershemy:[email protected]/gabershemy/DrugsStoresApp.git && git fetch origin main && git branch -M main && git reset --hard origin/main && php artisan optimize:clear

الآن نربط الـ Webhook داخل إعدادات مستودع GitHub:

1. اذهب إلى مستودعك على GitHub، ثم اضغط على Settings من الشريط العلوي.
2. من القائمة الجانبية اليسرى اختر Webhooks، ثم اضغط على زر Add webhook.
3. املأ البيانات بالشكل التالي:
   • Payload URL: https://stores.saydleyat.com/api/deploy-webhook?secret=TERKO_DEPLOY_SECRET_2026
   • Content type: اختر application/json
   • Secret: اتركه فارغاً (لأننا نتحقق من السر في رابط الـ URL مباشرة)
   • SSL verification: اختر Enable SSL verification
   • Which events: اختر Just the push event
   • تأكد من تفعيل علامة صح على Active
4. اضغط Add webhook للحفظ.

بمجرد الحفظ، سيرسل GitHub اختبار Ping. للتأكد من نجاحه بالكامل:

1. انزل لأسفل صفحة الـ Webhook عند قسم Recent Deliveries.
2. ستجد علامة صح خضراء بجانب الطلب مع كود 200 OK.
3. اضغط على الطلب ثم اختر تبويب Response واقرأ خانة Response Body: ستجد نصاً شبيهاً بـ: {"status":"success","message":"Deployed successfully","output":"Already up to date.\n..."}

ابحث عن اسم المشروع أو اختره مباشرة من القائمة، وانسخ الرابط والأمر بضغطة زر واحدة: