initial commit - php function

.forgejo/workflows/deploy.yml

@@ -0,0 +1,83 @@
+# FnKit Deploy — Forgejo Actions
+# Builds and deploys this function container on every push to main
+# Requires: Forgejo runner with Docker socket access (fnkit deploy runner)
+#
+# Pipeline: git push → build image → deploy container → health check
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build image
+        run: |
+          FUNCTION_NAME="fn-php"
+          IMAGE_NAME="fnkit-fn-${FUNCTION_NAME}:latest"
+          IMAGE_PREV="fnkit-fn-${FUNCTION_NAME}:prev"
+
+          echo "🔨 Building ${FUNCTION_NAME}..."
+          docker build -t $IMAGE_NAME .
+
+          echo "IMAGE_NAME=$IMAGE_NAME" >> $GITHUB_ENV
+          echo "IMAGE_PREV=$IMAGE_PREV" >> $GITHUB_ENV
+          echo "FUNCTION_NAME=$FUNCTION_NAME" >> $GITHUB_ENV
+
+      - name: Deploy container
+        run: |
+          echo "🌐 Ensuring fnkit-network exists..."
+          docker network create fnkit-network 2>/dev/null || true
+
+          # Tag current image as :prev for rollback
+          docker tag $IMAGE_NAME $IMAGE_PREV 2>/dev/null || true
+
+          echo "♻️  Replacing running container..."
+          docker stop $FUNCTION_NAME 2>/dev/null || true
+          docker rm $FUNCTION_NAME 2>/dev/null || true
+
+          echo "🚀 Starting ${FUNCTION_NAME}..."
+          docker run -d \
+            --name $FUNCTION_NAME \
+            --network fnkit-network \
+            --label fnkit.fn=true \
+            --label fnkit.deployed="$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
+            --restart unless-stopped \
+            $IMAGE_NAME
+
+      - name: Health check
+        run: |
+          echo "🏥 Checking container health..."
+          sleep 3
+
+          if docker ps --filter "name=$FUNCTION_NAME" --filter "status=running" -q | grep -q .; then
+            echo "✅ ${FUNCTION_NAME} is running"
+            echo "🌐 Available at gateway: /${FUNCTION_NAME}"
+          else
+            echo "❌ Container failed to start — rolling back..."
+            docker logs $FUNCTION_NAME 2>&1 || true
+
+            # Rollback to previous image if available
+            if docker image inspect $IMAGE_PREV >/dev/null 2>&1; then
+              echo "🔄 Rolling back to previous image..."
+              docker rm $FUNCTION_NAME 2>/dev/null || true
+              docker run -d \
+                --name $FUNCTION_NAME \
+                --network fnkit-network \
+                --label fnkit.fn=true \
+                --label fnkit.deployed="$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
+                --label fnkit.rollback=true \
+                --restart unless-stopped \
+                $IMAGE_PREV
+              echo "⚠️  Rolled back to previous version"
+            fi
+            exit 1
+          fi
+
+      - name: Cleanup old images
+        run: |
+          echo "🧹 Cleaning up dangling images..."
+          docker image prune -f --filter "label=fnkit.fn=true" 2>/dev/null || true

.gitignore

@@ -0,0 +1,15 @@
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Docker
+Dockerfile.local
+# PHP
+vendor/
+composer.lock

Dockerfile

@@ -0,0 +1,9 @@
+FROM php:8.2-cli
+LABEL fnkit.fn="true"
+WORKDIR /app
+COPY composer.json composer.lock ./
+RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
+RUN composer install --no-dev
+COPY . .
+ENV FUNCTION_TARGET=helloHttp
+CMD ["php", "-S", "0.0.0.0:8080", "vendor/google/cloud-functions-framework/router.php"]

composer.json

@@ -0,0 +1,6 @@
+{
+  "name": "example/fn-php",
+  "require": {
+    "google/cloud-functions-framework": "^1.1"
+  }
+}

docker-compose.yml

@@ -0,0 +1,36 @@
+# Docker Compose for FnKit function with gateway integration
+# Requires: docker network create fnkit-network
+# Requires: fnkit-gateway running (fnkit gateway init && fnkit gateway build && fnkit gateway start)
+
+version: '3.8'
+
+services:
+  fn-php:
+    build: .
+    container_name: fn-php
+    networks:
+      - fnkit-network
+    depends_on:
+      fnkit-gateway:
+        condition: service_started
+    restart: unless-stopped
+
+  # Uncomment to include gateway in this compose file
+  # fnkit-gateway:
+  #   image: fnkit-gateway:latest
+  #   container_name: fnkit-gateway
+  #   ports:
+  #     - "8080:8080"
+  #   environment:
+  #     - FNKIT_AUTH_TOKEN=${FNKIT_AUTH_TOKEN:-}
+  #   networks:
+  #     - fnkit-network
+
+networks:
+  fnkit-network:
+    name: fnkit-network
+    external: true
+
+# Usage:
+#   docker-compose up -d
+#   curl -H "Authorization: Bearer <token>" http://localhost:8080/fn-php

index.php

@@ -0,0 +1,8 @@
+<?php
+
+use Psr\Http\Message\ServerRequestInterface;
+
+function helloHttp(ServerRequestInterface $request): string
+{
+    return "Hello, World!" . PHP_EOL;
+}