نشر Laravel على InfinityFree مجاناً مع MySQL وبدون SSH

دليل نشر Laravel على استضافة InfinityFree المجانية مع MySQL: ما يعمل وما لا يعمل، وتجهيز المشروع محلياً، والرفع بـ FTP، وإعداد .htaccess.

استضافة InfinityFree مجانية وتدعم PHP وMySQL، لكنها ليست خادماً تتحكم فيه: لا SSH ولا Composer ولا artisan على الخادم، وجذر الموقع مجلد ثابت اسمه htdocs. ومع ذلك يمكن تشغيل تطبيق Laravel عليها بشرط أن تفهم القيود وتحضّر كل شيء على جهازك قبل الرفع. هذا الدليل يشرح كل خطوة ولماذا تُفعل بهذه الطريقة، ومتى يجب أن تتوقف عن استخدام هذه الاستضافة.

هذا المقال الثاني من سلسلة. الأول عن النشر على Render مع Neon وDocker. إن كنت تحتاج مهام مجدولة أو queue workers أو API فاقرأ الأول أو فكّر بخادم VPS.

أولاً: ماذا تقدم لك InfinityFree وما حدودها؟

بناءً على شروط الاستخدام في منتدى InfinityFree والدليل المنشور في المنتدى لتثبيت Laravel:

ما تحصل عليه: PHP وMySQL وphpMyAdmin ومساحة رفع بالـ FTP.

ما لا يعمل (لأنه غير متاح في الخطة المجانية):

قيود الاستخدام: موارد المعالج والذاكرة وعدد الطلبات (hits) محدودة بأرقام لا تنشرها الاستضافة، والمساحة محدودة بعدد الملفات (inodes) أيضاً، ومجلد vendor الضخم قد يقترب منها. ويمنع شرط الاستخدام استضافة "الـ API وقواعد البيانات" كخدمة بحد ذاتها، وتخزين الملفات والنسخ الاحتياطية، وسكربتات الدردشة الحية. أي أن الاستضافة مخصصة لـ مواقع عادية، لا لتشغيل API يستهلكه تطبيق آخر. والاستضافة تضع نظام حماية يسمح للمتصفحات العادية فقط، فقد تُحجب أدوات مثل webhooks وطلبات cURL الآلية، فاختبر أي ميزة تعتمد عليها.

خلاصة: مناسبة لموقع تعريفي أو مدونة أو لوحة بسيطة ولتجربة المشروع، وغير مناسبة لنظام يحتاج مهام خلفية أو حمل عالٍ.

ثانياً: تأكد من إصدار PHP

كل إصدار من Laravel يتطلب حداً أدنى من PHP. افتح composer.json وانظر إلى require.php في مشروعك، وتحقق من أن الاستضافة تدعمه.

بحسب إعلان في منتدى InfinityFree تم ترقية الاستضافة المجانية إلى PHP 8.4، لكن إصدار حسابك قد يختلف، فلا تعتمد على الإعلان وحده:

1. من لوحة التحكم افتح Select PHP Version (أو ما يماثلها في لوحتك) وانظر ما يتوفر.
2. ارفع ملفاً مؤقتاً phpinfo.php فيه <?php phpinfo(); داخل htdocs/public وافتحه، وتأكد من الإصدار ومن وجود الإضافات: pdo_mysql وmbstring وopenssl وfileinfo وgd وintl. احذف الملف بعد الاستخدام لأنه يكشف إعدادات الخادم.

والأهم: ولّد الحزم على جهازك بإصدار PHP مطابق لإصدار الاستضافة. إن ولّدت composer.lock على PHP أعلى من الموجود على الاستضافة فقد تُثبَّت حزم لا تعمل هناك. تأكد قبل الرفع:

composer config platform.php 8.3   # ضع إصدار استضافتك
composer update --no-dev --lock    # يعيد حل الحزم على هذا الإصدار

ثالثاً: أنشئ الحساب وقاعدة البيانات

1. سجّل في InfinityFree وأنشئ Hosting Account واختر نطاقاً فرعياً مجانياً أو نطاقك الخاص.
2. من لوحة التحكم (Control Panel) ستجد بيانات FTP: المضيف واسم المستخدم وكلمة المرور (وهي بيانات الـ FTP لا بيانات حسابك).
3. افتح MySQL Databases وأنشئ قاعدة. ستحصل على:
   • اسم القاعدة (مسبوق ببادئة حسابك).
   • اسم المستخدم وكلمة المرور.
   • المضيف (Host): اسم خادم خاص مثل sqlXXX.infinityfree.com، وهو ليس localhost. انسخه كما هو من اللوحة.
4. زر phpMyAdmin بجانب القاعدة هو أداتك الوحيدة لإدارتها، لأنك لا تستطيع الاتصال من خارج الاستضافة.

ما قواعد البيانات المتاحة؟ وكم يمكنك إنشاء منها؟

هذه نقطة تحيّر كثيرين، فلنوضحها:

متى تحتاج أكثر من قاعدة؟

• لكل تطبيق قاعدته: إن استضفت أكثر من موقع Laravel على الحساب نفسه، أنشئ لكل واحد قاعدة مستقلة بمستخدمها حتى لا تتداخل البيانات.
• بيئات منفصلة: قاعدة للتجربة (staging) وأخرى للإنتاج، وبدّل بينهما بـ .env.
• تقليل الحمل: لا حاجة لتوزيع جداول تطبيق واحد على عدة قواعد، فهذا يعقّد الاستعلامات والعلاقات بلا فائدة. ما دمت تحت حدود الحمل، قاعدة واحدة تكفي.

وإن أردت فعلاً أن يتصل تطبيق واحد بقاعدتين على الاستضافة نفسها (مثلاً قاعدة للتقارير) فعرّف اتصالاً ثانياً في config/database.php:

'connections' => [
    'mysql' => [ /* الاتصال الأساسي كما هو، من DB_* */ ],

    'mysql_reports' => [
        'driver' => 'mysql',
        'host' => env('DB2_HOST'),
        'port' => env('DB2_PORT', '3306'),
        'database' => env('DB2_DATABASE'),
        'username' => env('DB2_USERNAME'),
        'password' => env('DB2_PASSWORD'),
        'charset' => 'utf8mb4',
        'collation' => 'utf8mb4_unicode_ci',
    ],
],

واستخدمه في الموديل بـ protected $connection = 'mysql_reports';، أو في استعلام بـ DB::connection('mysql_reports')->table(...). وتذكّر أن بيانات اتصال كل قاعدة تأتي من لوحة MySQL Databases (كل قاعدة بمستخدمها وكلمة مرورها).

النسخ الاحتياطي: لأنك لا تستطيع تشغيل mysqldump ضد الخادم من جهازك، فخذ نسخك من phpMyAdmin ← Export بانتظام وخزّنها خارج الاستضافة. ولا تعتمد على الاستضافة المجانية في الاحتفاظ ببياناتك.

رابعاً: التحضير على جهازك (أهم مرحلة)

بما أن الخادم لا يشغّل أي أمر، فكل ما يحتاج أوامر يحدث عندك:

# 1) حزم الإنتاج فقط، مع autoloader محسّن
composer install --no-dev --optimize-autoloader

# 2) بناء الأصول (Vite) فيتولد public/build
npm ci && npm run build

# 3) تنظيف أي كاش محلي (مهم! انظر الشرح)
php artisan optimize:clear

# 4) مفتاح التطبيق (انسخه لملف .env الإنتاجي)
php artisan key:generate --show

شرح كل خطوة:

• --no-dev: حزم الاختبار والتطوير لا تلزم في الإنتاج، وتقلل عدد الملفات (inodes) وحجم الرفع.
• npm run build: الاستضافة لا تشغّل Node. فملفات CSS/JS الجاهزة في public/build يجب أن تُبنى عندك وتُرفع. وبدونها تحصل على خطأ Vite manifest not found.
• optimize:clear وليس optimize: لا تشغّل config:cache ولا route:cache على جهازك قبل الرفع. الكاش المولّد يحتوي مسارات مطلقة من جهازك (مثل /home/user/project/...) فيتعطل التطبيق على الاستضافة. ننظّف الكاش لا نبنيه.
• لا ترفع node_modules: آلاف الملفات تستهلك حصة الملفات بلا فائدة (ينبه الدليل المنشور لهذا).
• مفتاح التطبيق: APP_KEY يشفّر الجلسات والـ cookies. ولّده مرة واحدة واحفظه، فتغييره لاحقاً يبطل الجلسات المشفرة.

ملف .env للإنتاج

أنشئ ملفاً جديداً بقيم الإنتاج (لا تنسخ .env المحلي كما هو):

APP_NAME="اسم موقعك"
APP_ENV=production
APP_KEY=base64:................
APP_DEBUG=false
APP_URL=https://yoursite.infinityfreeapp.com

DB_CONNECTION=mysql
DB_HOST=sqlXXX.infinityfree.com
DB_PORT=3306
DB_DATABASE=if0_XXXXXXXX_dbname
DB_USERNAME=if0_XXXXXXXX
DB_PASSWORD=كلمة_المرور

SESSION_DRIVER=file
CACHE_STORE=file
QUEUE_CONNECTION=sync
LOG_CHANNEL=daily
FILESYSTEM_DISK=public

(استبدل الأسماء بما تعرضه لوحتك بالضبط). ملاحظات:

• APP_DEBUG=false إلزامي. إذا بقيت true فسيعرض الموقع مساراتك وأسرارك في صفحات الأخطاء.
• APP_URL بـ https://: حتى يولّد Laravel روابط آمنة.
• الجلسات والكاش على file: لا Redis. ويمكنك استخدام database للجلسات بشرط إنشاء جدولها.
• QUEUE_CONNECTION=sync: هو الخيار الوحيد العملي.
• البريد: استخدم مزود بريد خارجياً (SMTP أو API). تأكد من اختباره، لأن بعض الاستضافات المجانية تقيّد الاتصالات الخارجية.

خامساً: إنشاء الجداول بدون artisan migrate

لا يوجد SSH، ولا يمكنك توجيه artisan migrate من جهازك إلى قاعدة الاستضافة (الاتصال الخارجي غير مسموح). لذلك أمامك طريقتان:

الطريقة 1 (الموصى بها): تصدير SQL واستيراده

1. أنشئ قاعدة MySQL فارغة محلياً وشغّل عليها:

php artisan migrate --force
php artisan db:seed --force   # إن كان عندك seeders ضرورية

2. صدّرها:

mysqldump -u root -p --no-tablespaces اسم_القاعدة_المحلية > dump.sql

3. في phpMyAdmin على الاستضافة: اختر قاعدتك ← Import ← ارفع dump.sql.

ملاحظات: إن كان الملف كبيراً فاضغطه (phpMyAdmin يقبل .zip و.gz عادةً)، وانظر الحد الأقصى المعروض في صفحة Import. وكل تغيير لاحق في البنية يتطلب تصدير الجزء المتغير فقط واستيراده أو تنفيذ SQL يدوياً. ويمكنك أيضاً توليد SQL للبنية بـ php artisan schema:dump ثم استيراده كما ذكر الدليل المنشور في المنتدى.

الطريقة 2 (مؤقتة وخطرة): مسار ويب يشغّل الترحيل

أحياناً تحتاج تشغيل ترحيل بعد النشر. يمكنك إضافة مسار مؤقت محمي بسر طويل:

// routes/web.php  ← مؤقت، احذفه مباشرة بعد الاستخدام
Route::get('/_run-migrations/{token}', function (string $token) {
    abort_unless(hash_equals((string) env('MIGRATE_TOKEN'), $token), 404);

    Artisan::call('migrate', ['--force' => true]);

    return '<pre>'.e(Artisan::output()).'</pre>';
});

ضع MIGRATE_TOKEN في .env بقيمة عشوائية طويلة (32 حرفاً فأكثر)، افتح الرابط مرة واحدة، ثم احذف المسار والمتغير فوراً. ترك مسار كهذا مفتوحاً يعني أن أي شخص يخمّن السر يستطيع تعديل قاعدة بياناتك. وتأكد أيضاً أنك لم ترفع ملفات كاش الإعدادات من جهازك (bootstrap/cache/config.php) لأنها تحمل مسارات جهازك.

مشاكل شائعة في الاستيراد والترحيل

• Specified key was too long: مع إصدارات MySQL القديمة، أضف في AppServiceProvider::boot(): Schema::defaultStringLength(191); ثم أعد توليد القاعدة.
• اختلاف الـ collation: استخدم utf8mb4 في كل الجداول لدعم العربية والرموز التعبيرية.
• ترتيب الجداول والمفاتيح الأجنبية: الاستيراد من mysqldump يضع أوامر إيقاف فحص المفاتيح تلقائياً، فلا تقلق، لكن إن كتبت SQL بيدك فاحرص على الترتيب.

سادساً: بنية المجلدات و.htaccess

بما أن جذر الموقع هو htdocs ولا يمكن تغييره، وأمان Laravel يعتمد على أن يكون الجذر هو مجلد public فقط، فنحتاج حيلة: نضع المشروع كله داخل htdocs ونجعل .htaccess يوجّه كل الطلبات إلى public.

البنية بعد الرفع

htdocs/
├── .htaccess          ← الذي سننشئه (يوجّه إلى public)
├── .env
├── app/
├── bootstrap/
├── config/
├── database/
├── public/
│   ├── .htaccess      ← الأصلي من Laravel (لا تعدّله)
│   ├── index.php
│   └── build/         ← أصول Vite المبنية
├── resources/
├── routes/
├── storage/
└── vendor/

ملف htdocs/.htaccess

هذه الصيغة من الدليل المنشور في منتدى InfinityFree (بعد تصحيح خطأ فيه):

RewriteEngine On
RewriteRule ^storage/(.*)$ /storage/app/public/$1 [END]
RewriteRule (.*) /public/$1 [L]

شرح السطور:

1. RewriteEngine On: يفعّل محرك إعادة الكتابة في Apache.
2. القاعدة الأولى بديل storage:link: الطلب /storage/photo.jpg يُخدَّم من storage/app/public/photo.jpg مباشرة. نحتاجها لأن الروابط الرمزية غير مدعومة. يجب أن تسبق القاعدة العامة، وإلا تأكلها الثانية. ولا تلزمك إن كنت لا تستخدم القرص public.
3. القاعدة الثانية: كل طلب آخر يُعاد توجيهه داخلياً إلى public/. بهذا تصل index.php بالطريقة المعتادة، وفي الوقت نفسه تمنع الوصول إلى الملفات الحساسة: الطلب /.env يتحول إلى /public/.env غير الموجود فيرجع 404.

اختبر الأمان فوراً بعد الرفع

افتح هذه الروابط، ويجب أن ترى 404 أو 403 في كلها:

• https://موقعك/.env
• https://موقعك/storage/logs/laravel.log
• https://موقعك/composer.json
• https://موقعك/vendor/autoload.php

إن ظهر أي محتوى فملف .htaccess لا يعمل، فأوقف الموقع وأصلح الأمر قبل أي شيء، لأن كشف .env يعني كشف كلمات مرور قاعدة البيانات ومفتاح التطبيق.

سابعاً: الرفع بالـ FTP

1. استخدم FileZilla (أو أي عميل FTP). في الإعدادات فعّل Show hidden files (Server ← Force showing hidden files) وإلا لن ترى .env و.htaccess ولن تُرفع.
2. اتصل بمضيف FTP وبياناته من اللوحة، وادخل مجلد htdocs.
3. ارفع المحتوى كما في البنية أعلاه. رفع vendor يستغرق وقتاً لكثرة ملفاته، فاصبر ولا تقطع الرفع. وبعده راجع أن عدد الملفات على الخادم يطابق عدد ملفاتك المحلية.
4. انتبه: يحذّر الدليل المنشور من أن ملفات PHP التي يتجاوز حجمها 1MB قد تُرفض دون أي رسالة خطأ، فتظهر لاحقاً أخطاء classes مفقودة. إن حصل ذلك فشغّل محلياً composer dump-autoload --no-dev --optimize=false وأعد رفع الملفات المتأثرة.
5. تأكد أن مجلدي storage وbootstrap/cache موجودان (حتى لو فارغين) وقابلان للكتابة. إن ظهرت أخطاء صلاحيات فاضبط الأذونات إلى 755 (أو 775) من عميل FTP.

ثامناً: شهادة SSL

من لوحة التحكم يمكنك طلب شهادة SSL مجانية لنطاقك. اتبع الخطوات التي تعرضها اللوحة، وقد يستغرق التفعيل بعض الوقت. بعد تفعيلها:

• اجعل APP_URL=https://....
• أضف في AppServiceProvider::boot():

use Illuminate\Support\Facades\URL;

if (app()->environment('production')) {
    URL::forceScheme('https');
}

هكذا تُولَّد كل الروابط (CSS وJS وغيرها) بـ https فلا تحصل على خطأ Mixed Content.

تاسعاً: ما لا يعمل وبدائله

عاشراً: سير عمل التحديثات

كل تحديث للكود = إعادة تحضير ورفع. للتنظيم:

1. عدّل محلياً واختبر.
2. composer install --no-dev --optimize-autoloader (إذا تغيرت الحزم) وnpm run build (إذا تغيرت الأصول).
3. php artisan optimize:clear.
4. ارفع الملفات المتغيرة فقط (FileZilla يظهر الاختلافات)، ولا تعيد رفع vendor إن لم تتغير الحزم.
5. إن تغيرت البنية فاستورد SQL التغيير في phpMyAdmin.
6. امسح ملفات الكاش على الخادم إن ظهر سلوك لا يطابق الكود: محتويات bootstrap/cache وstorage/framework/views (بدون حذف المجلدات نفسها).

ويمكنك أتمتة الرفع بـ GitHub Actions عبر حزمة تدعم FTP مثل SamKirkland/FTP-Deploy-Action (تأكد من اسم مجلد الوجهة server-dir وفق ما تراه في عميل FTP، وخزّن بيانات FTP في GitHub Secrets، ولا تضعها في الملف أبداً).

حادي عشر: أخطاء شائعة وحلولها

متى تتركها؟

انتقل لاستضافة أخرى (مثل Render في المقال الأول، أو VPS) إذا احتجت: مهاماً مجدولة، أو queue workers، أو WebSockets، أو API يستهلكه تطبيق آخر، أو وصولاً مباشراً لقاعدة البيانات من أدواتك، أو حملاً أعلى مما تتحمله حدود الاستضافة.

الخلاصة

• InfinityFree تصلح لمواقع Laravel الخفيفة، لكن بلا SSH ولا cron ولا queue ولا اتصال خارجي بقاعدة MySQL.
• كل شيء يُحضَّر محلياً: composer install --no-dev وبناء Vite وoptimize:clear ثم الرفع.
• جذر الموقع htdocs ثابت، فنضع المشروع داخله ونوجّه الطلبات إلى public بـ .htaccess، ثم نختبر أن /.env لا يُفتح.
• الجداول تُنشأ عبر تصدير SQL واستيراده بـ phpMyAdmin، لا بـ artisan migrate.
• قواعد البيانات المتاحة MySQL فقط، ويمكنك إنشاء عدة قواعد من اللوحة، لكن لا تصلها من جهازك ولا يُؤكَّد أن بإمكانك الاتصال بقاعدة خارجية (Postgres/Neon غير عملي هنا).
• اعرف حدودها مبكراً: إن كبر مشروعك فالانتقال لاستضافة بصلاحيات أوسع أرخص من محاربة القيود.

المصادر

• InfinityFree: ماذا يمكنني فعله بحسابي؟
• InfinityFree: كيف تثبّت موقع Laravel
• InfinityFree: الاتصال بـ MySQL من تطبيق خارجي
• InfinityFree: الاتصال بقاعدة بيانات خارجية من موقعك (نقاش المنتدى)
• InfinityFree: الترقية إلى PHP 8.4