‎Laravel Octane على ‎VPS: ‎FrankenPHP و‎Docker و‎Traefik

‎PHP-FPM مقابل ‎Laravel Octane — ما الذي يتغير فعلاً

ست فروق هيكلية يجب معرفتها

• دورة حياة مشتركة — حاوية ‎IoC الخاصة بـ ‎Laravel والمزودين والـ ‎singletons تُنشأ مرة واحدة وتبقى بين جميع طلبات العامل. قيمة مكتوبة في ‎singleton في الطلب ‎N لا تزال موجودة في الطلب ‎N+1.
• مكسب أداء موثق — تُظهر معايير توثيق ‎Laravel Octane الرسمية ‎4× إلى ‎6× طلبات/ثانية مقارنةً بـ ‎PHP-FPM 8.3 على نقاط نهاية نموذجية، بفضل حذف تهيئة ‎PHP في كل طلب.
• المتغيرات الثابتة = تسريبات مضمونة — أي خاصية ‎static مكتوبة خلال طلب تلوث الطلبات التالية. واجهات ‎Laravel Facades تخفي مراجع ثابتة؛ بعضها يُنظّفه ‎Octane والبعض الآخر لا.
• الملفات الثابتة تُخدَم بواسطة ‎FrankenPHP — يتضمن الثنائي خادم ‎HTTP كاملاً. على ‎VPS، لا حاجة لـ ‎nginx أمام ‎PHP: يتعامل ‎FrankenPHP مع ‎TLS و‎HTTP/2 و‎HTTP/3 بشكل أصلي.
• ذاكرة ‎RSS مستقرة ≠ ذاكرة مسربة — ترتفع ذاكرة العملية عند بدء التشغيل ثم تستقر. التسريب الحقيقي يظهر كنمو مستمر عبر آلاف الطلبات، ليس المستوى الأولي.
• العمال والتزامن — يبدأ ‎Octane ‎--workers=N عملية. كل عامل يحتفظ بحالته الخاصة، لكن نفس العامل يعالج طلباته بالتسلسل.
• توافق ‎Laravel 10 و11 — ‎Octane 2.x يدعم ‎Laravel 10+. ‎FrankenPHP كبرنامج تشغيل متاح منذ ‎laravel/octane 2.3. ‎PHP 8.2 كحد أدنى، ‎PHP 8.3 موصى به.

المتطلبات الأساسية قبل البدء

نشر ‎Laravel Octane + ‎FrankenPHP + ‎Traefik في ‎Docker Compose

1. 01

   تثبيت ‎laravel/octane ونشر الإعداد

   في مشروع ‎Laravel:

   composer require laravel/octane
   php artisan octane:install --server=frankenphp

   هذا ينشر config/octane.php ويضيف متغيرات البيئة إلى .env.example. تحقق من تعيين OCTANE_SERVER=frankenphp.

2. 02

   كتابة ‎Dockerfile لـ ‎FrankenPHP

   FROM dunglas/frankenphp:1-php8.3-alpine
   
   RUN install-php-extensions \
       pdo_mysql \
       redis \
       opcache \
       pcntl \
       zip \
       intl
   
   WORKDIR /app
   
   COPY --chown=www-data:www-data . .
   
   RUN composer install --no-dev --optimize-autoloader --no-interaction \
    && php artisan config:cache \
    && php artisan route:cache \
    && php artisan view:cache
   
   EXPOSE 8000
   
   CMD ["php", "artisan", "octane:frankenphp", "--host=0.0.0.0", "--port=8000", "--workers=4", "--max-requests=500"]

   خيار --max-requests=500 يُعيد تشغيل العامل بعد 500 طلب: شبكة أمان ضد تسريبات الذاكرة المتبقية.

3. 03

   كتابة ‎docker-compose.yml الكامل

   services:
     app:
       build: .
       restart: unless-stopped
       environment:
         APP_ENV: production
         APP_KEY: ${APP_KEY}
         DB_HOST: db
         REDIS_HOST: redis
         CACHE_DRIVER: redis
         SESSION_DRIVER: redis
         QUEUE_CONNECTION: redis
         OCTANE_SERVER: frankenphp
       networks:
         - internal
         - traefik
       labels:
         - "traefik.enable=true"
         - "traefik.http.routers.app.rule=Host(`${DOMAIN}`)"
         - "traefik.http.routers.app.entrypoints=websecure"
         - "traefik.http.routers.app.tls.certresolver=letsencrypt"
         - "traefik.http.services.app.loadbalancer.server.port=8000"
       depends_on:
         db:
           condition: service_healthy
         redis:
           condition: service_healthy
   
     worker:
       build: .
       restart: unless-stopped
       command: ["php", "artisan", "queue:work", "redis", "--sleep=3", "--tries=3", "--max-time=3600"]
       networks:
         - internal
       depends_on:
         db:
           condition: service_healthy
         redis:
           condition: service_healthy
   
     scheduler:
       build: .
       restart: unless-stopped
       command: ["sh", "-c", "while true; do php artisan schedule:run >> /dev/null 2>&1; sleep 60; done"]
       networks:
         - internal
   
     db:
       image: mysql:8.0
       restart: unless-stopped
       volumes:
         - db_data:/var/lib/mysql
       networks:
         - internal
       healthcheck:
         test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
         interval: 10s
         timeout: 5s
         retries: 5
   
     redis:
       image: redis:7-alpine
       restart: unless-stopped
       volumes:
         - redis_data:/data
       networks:
         - internal
       healthcheck:
         test: ["CMD", "redis-cli", "ping"]
         interval: 10s
         timeout: 3s
         retries: 5
   
   volumes:
     db_data:
     redis_data:
   
   networks:
     internal:
     traefik:
       external: true

4. 04

   نشر ‎Traefik مع شهادات تلقائية

   docker network create traefik
   mkdir -p /opt/traefik/letsencrypt
   touch /opt/traefik/letsencrypt/acme.json
   chmod 600 /opt/traefik/letsencrypt/acme.json
   docker compose -f /opt/traefik/docker-compose.yml up -d

5. 05

   ‫تهيئة ملف ‎.env‬ للإنتاج

   المتغيرات الأساسية التي يجب تعريفها على ‎VPS‬:

   APP_ENV=production
   APP_DEBUG=false
   APP_KEY=base64:...  # يُنشأ بـ php artisan key:generate
   DOMAIN=your-domain.com
   DB_DATABASE=laravel
   DB_USERNAME=laravel
   DB_PASSWORD=strong_password
   DB_ROOT_PASSWORD=root_strong_password
   OCTANE_SERVER=frankenphp
   CACHE_DRIVER=redis
   SESSION_DRIVER=redis
   QUEUE_CONNECTION=redis

   لا تُودّع ‎.env‬ في ‎git‬ أبدًا. على ‎VPS‬، أدِره عبر ‎scp‬ أو مدير الأسرار.

6. 06

   تشغيل عمليات الترحيل بدون توقف

   docker compose run --rm app php artisan migrate --force

   للنشر بدون توقف، استخدم علامة --step على الترحيلات التي تضيف أعمدة ‎NOT NULL.

7. 07

   تشغيل الـ ‎stack والتحقق من ‎healthcheck

   docker compose up -d --build
   docker compose ps

   انتظر حتى يصل ‎db و‎redis إلى حالة ‎healthy قبل أن يبدأ ‎app.

8. 08

   التحقق من الحالة باستخدام ‎octane:status

   docker compose exec app php artisan octane:status

   تعرض هذه الأمر الخادم النشط (‎frankenphp)، عدد العمال وحالتهم. استجابة ‎running تؤكد أن العمال يستجيبون.

9. 09

   إعادة تحميل العمال عند النشر

   docker compose build app worker scheduler
   docker compose up -d --no-deps app worker scheduler

   لإعادة التحميل بدون قطع الاتصالات النشطة:

   docker compose exec app php artisan octane:reload

قائمة التحقق من التوافق قبل التبديل إلى الإنتاج

8 نقاط يجب التحقق منها

• ‎Singletons ذات حالة قابلة للتغيير — أي خدمة مسجلة بـ ‎$this->app->singleton() تخزن بيانات خاصة بالطلب يجب إعادة تهيئتها في ‎OctaneServiceProvider. مراجعة: ‎grep -r 'singleton' app/Providers.
• الجلسات — مع ‎SESSION_DRIVER=redis تصمد الجلسات بشكل صحيح. قد يُسبب برنامج التشغيل ‎file حالات تنافس مع عمال متعددين. الترحيل إلى ‎redis أو ‎database موصى به.
• اتصالات قاعدة البيانات — يحتفظ ‎Octane باتصالات ‎DB دائمة لكل عامل. تحقق من أن ‎MySQL يقبل ‎max_connections ≥ workers × replicas.
• المتغيرات الثابتة في النماذج أو الخدمات — ‎static $cache = [] في نموذج ‎Eloquent يستمر بين الطلبات. استبدله بحقن التبعية بنطاق الطلب.
• مستمعو الأحداث غير الأكفاء — مستمع مسجل في ‎boot() يُسجَّل مرة واحدة فقط، لكنه يُنفَّذ في كل طلب يُطلق الحدث. مشكلة فقط إذا كان يجمع حالة عامة.
• المهام والطوابير — لا تعمل ‎Jobs في عملية ‎Octane الرئيسية بل في حاوية ‎worker منفصلة. لا تعديلات مطلوبة على كود ‎Jobs.
• الملفات المرفوعة والتخزين — تأكد من تركيب مجلد ‎/app/storage كـ ‎volume لكي تستمر الملفات بين إعادة بناء الصورة.
• الحزم التابعة لجهات خارجية — تحقق من توافق ‎Octane لكل حزمة تستخدمها. عطّل ‎Debugbar وTelescope في الإنتاج.

‎FrankenPHP مقابل ‎Swoole مقابل ‎RoadRunner: اختيار برنامج تشغيل ‎Octane

مرّر الجدول أفقيًا

استكشاف الأخطاء: أخطاء الإنتاج الشائعة

لمزيد من المعلومات