php: Add application getOrCreate (#2101)

was not added in the original PHP SDK release.

Author: svix-mman

codegen/templates/php/api_extra/application_create.php

@@ -0,0 +1,15 @@
+/** Get or create a new application */
+public function getOrCreate(
+    ApplicationIn $applicationIn,
+    ?ApplicationCreateOptions $options = null,
+): ApplicationOut {
+    $request = $this->client->newReq('POST', '/api/v1/app');
+    if (null !== $options) {
+        $request->setHeaderParam('idempotency-key', $options->idempotencyKey);
+    }
+    $request->setQueryParam("get_if_exists", "true");
+    $request->setBody(json_encode($applicationIn));
+    $res = $this->client->send($request);
+
+    return ApplicationOut::fromJson($res);
+}

codegen/templates/php/api_resource.php.jinja

@@ -75,5 +75,8 @@ class {{ resource_type_name }}
         {% endif -%}
     }
 
+    {% set api_operation_extra -%}api_extra/{{ resource.name | to_snake_case }}_{{ op.name | to_snake_case }}.php{% endset %}
+    {% include api_operation_extra ignore missing %}
+
     {% endfor -%}
 }

php/src/Api/Application.php

@@ -48,6 +48,22 @@ public function create(
         return ApplicationOut::fromJson($res);
     }
 
+    /** Get or create a new application */
+    public function getOrCreate(
+        ApplicationIn $applicationIn,
+        ?ApplicationCreateOptions $options = null,
+    ): ApplicationOut {
+        $request = $this->client->newReq('POST', '/api/v1/app');
+        if (null !== $options) {
+            $request->setHeaderParam('idempotency-key', $options->idempotencyKey);
+        }
+        $request->setQueryParam('get_if_exists', 'true');
+        $request->setBody(json_encode($applicationIn));
+        $res = $this->client->send($request);
+
+        return ApplicationOut::fromJson($res);
+    }
+
     /** Get an application. */
     public function get(
         string $appId,

php/tests/MockTest.php

@@ -455,4 +455,18 @@ public function testEmptyAppPortalAccessInBody(): void
 
         $this->assertEquals('{}', $rawBody);
     }
+
+    public function testGetOrCreate(): void
+    {
+        $this->mockHandler->append(new Response(200, [], AppOut));
+
+        $svx = new \Svix\Svix("super_secret", httpClient: $this->httpClient);
+
+        $svx->application->getOrCreate(ApplicationIn::create("asd"));
+
+        $req = $this->requestHistory[0]['request'];
+
+        $this->assertEquals('get_if_exists=true', $req->getUri()->getQuery());
+    }
+
 }