feat(sdk): add PHP generator

Implements PHP SDK generator using Docker-only approach:
- Requires Docker with openapitools/openapi-generator-cli
- No native PHP generator tool; Docker is the only option

Includes tests following _Good convention for Available and Generate.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

pkg/sdk/generators/php.go

@@ -0,0 +1,64 @@
+package generators
+
+import (
+	"context"
+	"fmt"
+	"os"
+	"os/exec"
+	"path/filepath"
+)
+
+// PHPGenerator generates PHP SDKs from OpenAPI specs.
+type PHPGenerator struct{}
+
+// NewPHPGenerator creates a new PHP generator.
+func NewPHPGenerator() *PHPGenerator {
+	return &PHPGenerator{}
+}
+
+// Language returns the generator's target language identifier.
+func (g *PHPGenerator) Language() string {
+	return "php"
+}
+
+// Available checks if generator dependencies are installed.
+func (g *PHPGenerator) Available() bool {
+	_, err := exec.LookPath("docker")
+	return err == nil
+}
+
+// Install returns instructions for installing the generator.
+func (g *PHPGenerator) Install() string {
+	return "Docker is required for PHP SDK generation"
+}
+
+// Generate creates SDK from OpenAPI spec.
+func (g *PHPGenerator) Generate(ctx context.Context, opts Options) error {
+	if !g.Available() {
+		return fmt.Errorf("php.Generate: Docker is required but not available")
+	}
+
+	if err := os.MkdirAll(opts.OutputDir, 0755); err != nil {
+		return fmt.Errorf("php.Generate: failed to create output dir: %w", err)
+	}
+
+	specDir := filepath.Dir(opts.SpecPath)
+	specName := filepath.Base(opts.SpecPath)
+
+	cmd := exec.CommandContext(ctx, "docker", "run", "--rm",
+		"-v", specDir+":/spec",
+		"-v", opts.OutputDir+":/out",
+		"openapitools/openapi-generator-cli", "generate",
+		"-i", "/spec/"+specName,
+		"-g", "php",
+		"-o", "/out",
+		"--additional-properties=invokerPackage="+opts.PackageName,
+	)
+	cmd.Stdout = os.Stdout
+	cmd.Stderr = os.Stderr
+
+	if err := cmd.Run(); err != nil {
+		return fmt.Errorf("php.Generate: %w", err)
+	}
+	return nil
+}

pkg/sdk/generators/php_test.go

@@ -0,0 +1,58 @@
+package generators
+
+import (
+	"context"
+	"os"
+	"path/filepath"
+	"testing"
+	"time"
+)
+
+func TestPHPGenerator_Good_Available(t *testing.T) {
+	g := NewPHPGenerator()
+
+	// These should not panic
+	lang := g.Language()
+	if lang != "php" {
+		t.Errorf("expected language 'php', got '%s'", lang)
+	}
+
+	_ = g.Available()
+
+	install := g.Install()
+	if install == "" {
+		t.Error("expected non-empty install instructions")
+	}
+}
+
+func TestPHPGenerator_Good_Generate(t *testing.T) {
+	g := NewPHPGenerator()
+	if !g.Available() {
+		t.Skip("no PHP generator available (docker not installed)")
+	}
+
+	// Create temp directories
+	tmpDir := t.TempDir()
+	specPath := createTestSpec(t, tmpDir)
+	outputDir := filepath.Join(tmpDir, "output")
+
+	opts := Options{
+		SpecPath:    specPath,
+		OutputDir:   outputDir,
+		PackageName: "TestClient",
+		Version:     "1.0.0",
+	}
+
+	ctx, cancel := context.WithTimeout(context.Background(), 2*time.Minute)
+	defer cancel()
+
+	err := g.Generate(ctx, opts)
+	if err != nil {
+		t.Fatalf("Generate failed: %v", err)
+	}
+
+	// Verify output directory was created
+	if _, err := os.Stat(outputDir); os.IsNotExist(err) {
+		t.Error("output directory was not created")
+	}
+}