Add CI workflow for PHP with testing and analysis

Author: eypsilon

.github/workflows/main.yml

@@ -0,0 +1,56 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        php: [8.1, 8.2]
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v3
+        with:
+          php-version: ${{ matrix.php }}
+          extensions: imap, mbstring
+          coverage: none
+
+      - name: Get Composer Cache
+        uses: actions/cache@v4
+        with:
+          path: vendor
+          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-composer-
+
+      - name: Install dependencies
+        run: composer install --prefer-dist --no-progress --no-suggest --no-interaction
+
+      - name: Run PHPStan (level 8)
+        # adjust path or config if needed
+        run: |
+          if [ -f phpstan.neon ]; then
+            ./vendor/bin/phpstan analyse --configuration=phpstan.neon --level=8 src tests || true
+          else
+            ./vendor/bin/phpstan analyse --level=8 src tests || true
+          fi
+
+      - name: Run tests
+        # try PHPUnit first; adjust if you use Pest or other runner
+        run: |
+          if [ -x ./vendor/bin/phpunit ]; then
+            ./vendor/bin/phpunit --configuration phpunit.xml --colors=always --testdox
+          elif [ -x ./vendor/bin/pest ]; then
+            ./vendor/bin/pest --min
+          else
+            echo "No test runner found (phpunit/pest). Ensure composer install created vendor binaries."
+            exit 1
+          fi