ال tests الطويلة دي مرهقة بجد. كنت بستنى اكتر من 15 دقيقة عشان ال CI يخلص وده كان بيخليني اتعب من الانتظار.

فاكتشفت طريقة اقسم بيها ال tests على jobs كتيرة وأشغلهم parallel. النتيجة؟ وقت ال tests قل من 15 دقيقة لـ 4 دقائق بس.

هشرحلك ال setup اللي انا بستخدمه دلوقتي. مش معقد بس محتاج تركيز شوية.

ده لمين؟

لو انت مطور Laravel وبتواجه نفس المشكلة - tests بطيئة في ال CI - يبقا المقال ده ليك.

المشكلة

كل ما بضيف features ال tests بتزيد وتبقا ابطأ. اللي كان 30 ثانية بقا 15 دقيقة في ال CI.

ال solution مش انك تشتري runners اقوى. ال solution انك تقسم ال tests وتشغلهم مع بعض.

---

ال Setup

انا بستخدم 3 jobs:

name: tests

on:
  push:
    branches: ['*']
  pull_request:
    branches: ['*']

بيشتغل على اي push او PR.

concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true

لو عملت commits كتير ورا بعض، هيلغي القديمة ويشغل الجديدة بس. بيوفر فلوس.

---

Job 1: البناء (prepare)

ده بيعمل build للـ app مرة واحدة. باقي ال jobs تاخد النتيجة.

prepare:
  name: Prepare deps, assets & .env
  runs-on: ubuntu-latest
  container:
    image: lorisleiva/laravel-docker:8.3

بستخدم Docker container عشان ميحصلش مشاكل versions.

steps:
  - uses: actions/checkout@v4

نزل ال code.

- name: Disable Xdebug & OPCache for CLI
  run: |
    echo "xdebug.mode=off"      > /usr/local/etc/php/conf.d/disable-xdebug.ini
    echo "opcache.enable_cli=0" >> /usr/local/etc/php/conf.d/disable-opcache.ini

قفل Xdebug عشان مبطئ.

- name: Install Node.js & npm
  run: apk add --no-cache nodejs npm

لو بتستخدم Filament او Inertia محتاج Node. لو Laravel API بس، شيل دي.

- name: Cache Composer cache
  uses: actions/cache@v4
  with:
    path: ~/.composer/cache
    key: ${{ runner.os }}-composer-cache-${{ hashFiles('composer.lock') }}
    restore-keys: ${{ runner.os }}-composer-cache-

cache للتنزيلات.

- name: Cache vendor
  uses: actions/cache@v4
  with:
    path: vendor
    key: ${{ runner.os }}-vendor-${{ hashFiles('composer.lock') }}
    restore-keys: ${{ runner.os }}-vendor-

cache للـ vendor folder.

- name: Install PHP dependencies
  run: composer install --no-interaction --prefer-dist --no-scripts --no-progress

ثبت ال packages.

- name: Cache Node modules
  uses: actions/cache@v4
  with:
    path: node_modules
    key: ${{ runner.os }}-node-modules-${{ hashFiles('**/package.json') }}
    restore-keys: ${{ runner.os }}-node-modules-

cache للـ npm.

- name: Install & build JS assets
  run: |
    npm ci --silent
    npm run build

build للـ frontend.

- name: Copy test .env
  run: cp .env.example .env

- name: Generate application key
  run: php artisan key:generate --ansi

حضر Laravel.

- name: Upload build & .env
  uses: actions/upload-artifact@v4
  with:
    name: build-env
    path: |
      public/build
      .env

ارفع النتيجة. ال test jobs هتنزلها.

---

Job 2: ال Tests (tests-be)

هنا السحر. نقسم ال tests ونشغل كل جزء منفصل.

tests-be:
  name: Run unit tests (BE)   shard ${{ matrix.ci_node_index }}/6
  needs: prepare
  runs-on: ubuntu-latest
  container:
    image: lorisleiva/laravel-docker:8.3

6 jobs في نفس الوقت.

strategy:
  fail-fast: true
  matrix:
    ci_node_index: [1, 2, 3, 4, 5, 6]
    ci_node_total: [6]

كل job بياخد index مختلف. بيقسم ال tests بناء عليه.

steps:
  - uses: actions/checkout@v4

كل job بيبدأ من الصفر.

- name: Install GNU coreutils (for split -d)
  run: apk add --no-cache coreutils

محتاج split عشان اقسم ال tests.

- name: Disable Xdebug & OPCache for CLI
  run: |
    echo "xdebug.mode=off" > /usr/local/etc/php/conf.d/disable-xdebug.ini
    echo "opcache.enable_cli=0" >> /usr/local/etc/php/conf.d/disable-opcache.ini

- name: Increase PHP memory limit
  run: echo "memory_limit=-1" > /usr/local/etc/php/conf.d/memory.ini

قفل Xdebug وزود الـ memory.

- name: Cache Composer cache
  uses: actions/cache@v4
  with:
    path: ~/.composer/cache
    key: ${{ runner.os }}-composer-cache-${{ hashFiles('composer.lock') }}
    restore-keys: ${{ runner.os }}-composer-cache-

- name: Cache vendor
  uses: actions/cache@v4
  with:
    path: vendor
    key: ${{ runner.os }}-vendor-${{ hashFiles('composer.lock') }}
    restore-keys: ${{ runner.os }}-vendor-

- name: Install PHP dependencies (if not cached)
  run: composer install --no-interaction --prefer-dist --no-scripts --no-progress

نرجع ال PHP dependencies من ال cache.

- name: Download build & .env
  uses: actions/download-artifact@v4
  with:
    name: build-env
    path: .

نزل الـ build وال .env.

- name: Copy .env
  run: cp .env.example .env

- name: Generate application key
  run: php artisan key:generate --ansi

حضر Laravel.

- name: Ensure Paratest cache dir exists
  run: mkdir -p storage/framework/cache

Paratest محتاج المجلد ده.

- id: split
  uses: remarkablemark/find-and-split@v1
  with:
    directory: tests
    pattern: '*Test.php'
    chunk: ${{ matrix.ci_node_index }}/${{ matrix.ci_node_total }}

بيقسم ال tests لـ 6 مجموعات.

- name: Run Pest (shard ${{ matrix.ci_node_index }})
  run: |
    FILES="${{ steps.split.outputs.files }}"
    PATTERNS=$(for f in $FILES; do basename "$f" .php; done | paste -sd '|' -)
    php -d memory_limit=-1 artisan test --filter "/($PATTERNS)/" --parallel \
      --cache-directory=storage/framework/cache --stop-on-failure

شغل ال tests بتاعت ال shard ده parallel.

---

Job 3: خلاص (finish-tests)

finish-tests:
  name: Finish tests
  needs: tests-be
  runs-on: ubuntu-latest
  steps:
    - run: echo "All shards passed!"

بيشتغل بس لو كل حاجة نجحت. ممكن تستخدمه لـ deployment او اشعارات.

---

خلاصة

Setup بسيط وبيشتغل مع Pest و PHPUnit. الوقت بتاعي قل من 15 دقيقة لـ 4 دقائق.

لو عندك tests كتيرة اوي، ممكن تزود العدد من 6 لـ 8 او 10. او تضيف browser tests للـ matrix.

جربه وهتشوف الفرق بنفسك.

---

ليه مقسمناش كله في job واحد؟

لو حطيت كل حاجة في job واحد، كل واحد من الـ 6 jobs هيعمل:

• يثبت Composer dependencies
• يثبت npm dependencies
• يبني frontend assets
• يحضر Laravel environment
• يشغل ال tests

ده شغل مكرر كتير.

بدل كده، بنعمل الشغل ده مرة واحدة في job منفصل وكل ال test jobs تاخد النتيجة الجاهزة. النتيجة؟ وقت اقل بكتير.

---

الكود كامل

هنا الـ .github/workflows/tests.yml كامل:

name: tests

on:
  push:
    branches: ['*']
  pull_request:
    branches: ['*']

concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true

jobs:
  # ────────────────────────────────────────────────────────────────
  # 1) Prepare: install, build, and bundle .env for all shards
  # ────────────────────────────────────────────────────────────────
  prepare:
    name: Prepare deps, assets & .env
    runs-on: ubuntu-latest
    container:
      image: lorisleiva/laravel-docker:8.3

    steps:
      - uses: actions/checkout@v4

      - name: Disable Xdebug & OPCache for CLI
        run: |
          echo "xdebug.mode=off"      > /usr/local/etc/php/conf.d/disable-xdebug.ini
          echo "opcache.enable_cli=0" >> /usr/local/etc/php/conf.d/disable-opcache.ini

      # ── Add Node.js (for npm build) ───────────────────────────────
      - name: Install Node.js & npm
        run: apk add --no-cache nodejs npm

      # ── Composer cache & install ─────────────────────────────────
      - name: Cache Composer cache
        uses: actions/cache@v4
        with:
          path: ~/.composer/cache
          key: ${{ runner.os }}-composer-cache-${{ hashFiles('composer.lock') }}
          restore-keys: ${{ runner.os }}-composer-cache-

      - name: Cache vendor
        uses: actions/cache@v4
        with:
          path: vendor
          key: ${{ runner.os }}-vendor-${{ hashFiles('composer.lock') }}
          restore-keys: ${{ runner.os }}-vendor-

      - name: Install PHP dependencies
        run: composer install --no-interaction --prefer-dist --no-scripts --no-progress

      # ── JS caches & build ─────────────────────────────────────────
      - name: Cache Node modules
        uses: actions/cache@v4
        with:
          path: node_modules
          key: ${{ runner.os }}-node-modules-${{ hashFiles('**/package.json') }}
          restore-keys: ${{ runner.os }}-node-modules-

      - name: Install & build JS assets
        run: |
          npm ci --silent
          npm run build

      # ── Bundle .env & assets ─────────────────────────────────────
      - name: Copy test .env
        run: cp .env.example .env

      - name: Generate application key
        run: php artisan key:generate --ansi

      - name: Upload build & .env
        uses: actions/upload-artifact@v4
        with:
          name: build-env
          path: |
            public/build
            .env

  # ────────────────────────────────────────────────────────────────
  # 2) Test Shards: download artifact, restore cache, split & run
  # ────────────────────────────────────────────────────────────────
  tests-be:
    name: Run unit tests (BE)   shard ${{ matrix.ci_node_index }}/6
    needs: prepare
    runs-on: ubuntu-latest
    container:
      image: lorisleiva/laravel-docker:8.3

    strategy:
      fail-fast: true
      matrix:
        ci_node_index: [1, 2, 3, 4, 5, 6]
        ci_node_total: [6]

    steps:
      - uses: actions/checkout@v4

      - name: Install GNU coreutils (for split -d)
        run: apk add --no-cache coreutils

      - name: Disable Xdebug & OPCache for CLI
        run: |
          echo "xdebug.mode=off"      > /usr/local/etc/php/conf.d/disable-xdebug.ini
          echo "opcache.enable_cli=0" >> /usr/local/etc/php/conf.d/disable-opcache.ini

      - name: Increase PHP memory limit
        run: echo "memory_limit=-1" > /usr/local/etc/php/conf.d/memory.ini

      # ── Restore Composer cache & vendor ──────────────────────────
      - name: Cache Composer cache
        uses: actions/cache@v4
        with:
          path: ~/.composer/cache
          key: ${{ runner.os }}-composer-cache-${{ hashFiles('composer.lock') }}
          restore-keys: ${{ runner.os }}-composer-cache-

      - name: Cache vendor
        uses: actions/cache@v4
        with:
          path: vendor
          key: ${{ runner.os }}-vendor-${{ hashFiles('composer.lock') }}
          restore-keys: ${{ runner.os }}-vendor-

      - name: Install PHP dependencies (if not cached)
        run: composer install --no-interaction --prefer-dist --no-scripts --no-progress

      # ── Download build assets & .env ─────────────────────────────
      - name: Download build & .env
        uses: actions/download-artifact@v4
        with:
          name: build-env
          path: .

      - name: Copy .env
        run: cp .env.example .env

      - name: Generate application key
        run: php artisan key:generate --ansi

      - name: Ensure Paratest cache dir exists
        run: mkdir -p storage/framework/cache

      # ── Split tests & run Pest ───────────────────────────────────
      - id: split
        uses: remarkablemark/find-and-split@v1
        with:
          directory: tests
          pattern: '*Test.php'
          chunk: ${{ matrix.ci_node_index }}/${{ matrix.ci_node_total }}

      - name: Run Pest (shard ${{ matrix.ci_node_index }})
        run: |
          FILES="${{ steps.split.outputs.files }}"
          PATTERNS=$(for f in $FILES; do basename "$f" .php; done | paste -sd '|' -)
          php -d memory_limit=-1 artisan test --filter "/($PATTERNS)/" --parallel \
            --cache-directory=storage/framework/cache --stop-on-failure

  finish-tests:
    name: Finish tests
    needs: tests-be
    runs-on: ubuntu-latest
    steps:
      - run: echo "All shards passed!"

---

استنى الجزء التاني قريب!

شغل ال parallel jobs ده بيسرع ال tests بشكل جامد، بس ايه اللي يحصل لما تعدي الـ 2,000 دقيقة المجانية بتاعت GitHub في الشهر؟ ممكن تلاقي نفسك بتدفع فلوس كتير مع ال GitHub-hosted runners العادية.

في الجزء التاني من السلسلة دي، هقولك ازاي تشغل GitHub Actions بـ 4 دولار بس في الشهر باستخدام حلول رخيصة حتى لو انت بتشغل الاف دقائق tests.

هغطي ال self-hosted runners على cloud providers رخيصين، ال spot instances وازاي توفر فلوس، امتى يكون من المنطق تسيب ال GitHub-hosted runners، ومقارنات تكلفة حقيقية مع تحليل break-even.

مناسب للفرق اللي بتكبر ومحتاجة CI/CD اكتر من غير ما تكسر الميزانية. استنونا!