From e073651a43946b2ec3471170fbb134301fcce67b Mon Sep 17 00:00:00 2001
From: Dennis Traub <dennist.traub@gmail.com>
Date: Thu, 12 Sep 2024 12:27:28 +0200
Subject: [PATCH] Unify comments

---
 .../bedrock-runtime/BedrockRuntimeService.php | 57 +++++++++----------
 .../GettingStartedWithBedrockRuntime.php      | 10 ++--
 php/example_code/bedrock-runtime/README.md    | 10 ++--
 php/example_code/bedrock-runtime/Runner.php   |  1 -
 .../bedrock-runtime/composer.lock             | 12 ++--
 .../tests/BedrockRuntimeTests.php             | 11 ++--
 php/example_code/bedrock/BedrockService.php   | 13 ++---
 .../bedrock/GettingStartedWithBedrock.php     |  9 ++-
 php/example_code/bedrock/README.md            |  2 +-
 php/example_code/bedrock/Runner.php           |  1 -
 php/example_code/bedrock/composer.lock        | 12 ++--
 .../bedrock/tests/BedrockBasicsTests.php      | 11 ++--
 12 files changed, 69 insertions(+), 80 deletions(-)

diff --git a/php/example_code/bedrock-runtime/BedrockRuntimeService.php b/php/example_code/bedrock-runtime/BedrockRuntimeService.php
index f24c4e6c369..dc093b03c4d 100644
--- a/php/example_code/bedrock-runtime/BedrockRuntimeService.php
+++ b/php/example_code/bedrock-runtime/BedrockRuntimeService.php
@@ -1,10 +1,8 @@
 <?php
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
 
-# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-# SPDX-License-Identifier: Apache-2.0
-
-#snippet-start:[php.example_code.bedrock-runtime.service]
-
+// snippet-start:[php.example_code.bedrock-runtime.service]
 namespace BedrockRuntime;
 
 use Aws\BedrockRuntime\BedrockRuntimeClient;
@@ -21,17 +19,17 @@ public function __construct()
         ]);
     }
 
-    #snippet-start:[php.example_code.bedrock-runtime.service.invokeClaude]
+    // snippet-start:[php.example_code.bedrock-runtime.service.invokeClaude]
     public function invokeClaude($prompt)
     {
-        # The different model providers have individual request and response formats.
-        # For the format, ranges, and default values for Anthropic Claude, refer to:
-        # https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-claude.html
+        // The different model providers have individual request and response formats.
+        // For the format, ranges, and default values for Anthropic Claude, refer to:
+        // https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-claude.html
 
         $completion = "";
         try {
             $modelId = 'anthropic.claude-v2';
-            # Claude requires you to enclose the prompt as follows:
+            // Claude requires you to enclose the prompt as follows:
             $prompt = "\n\nHuman: {$prompt}\n\nAssistant:";
             $body = [
                 'prompt' => $prompt,
@@ -52,9 +50,9 @@ public function invokeClaude($prompt)
 
         return $completion;
     }
-    #snippet-end:[php.example_code.bedrock-runtime.service.invokeClaude]
+    // snippet-end:[php.example_code.bedrock-runtime.service.invokeClaude]
 
-    #snippet-start:[php.example_code.bedrock-runtime.service.invokeJurassic2]
+    // snippet-start:[php.example_code.bedrock-runtime.service.invokeJurassic2]
     public function invokeJurassic2($prompt)
     {
         # The different model providers have individual request and response formats.
@@ -82,14 +80,14 @@ public function invokeJurassic2($prompt)
 
         return $completion;
     }
-    #snippet-end:[php.example_code.bedrock-runtime.service.invokeJurassic2]
+    // snippet-end:[php.example_code.bedrock-runtime.service.invokeJurassic2]
 
-    #snippet-start:[php.example_code.bedrock-runtime.service.invokeLlama2]
+    // snippet-start:[php.example_code.bedrock-runtime.service.invokeLlama2]
     public function invokeLlama2($prompt)
     {
-        # The different model providers have individual request and response formats.
-        # For the format, ranges, and default values for Meta Llama 2 Chat, refer to:
-        # https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-meta.html
+        // The different model providers have individual request and response formats.
+        // For the format, ranges, and default values for Meta Llama 2 Chat, refer to:
+        // https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-meta.html
 
         $completion = "";
         try {
@@ -112,14 +110,14 @@ public function invokeLlama2($prompt)
 
         return $completion;
     }
-    #snippet-end:[php.example_code.bedrock-runtime.service.invokeLlama2]
+    // snippet-end:[php.example_code.bedrock-runtime.service.invokeLlama2]
 
-    #snippet-start:[php.example_code.bedrock-runtime.service.invokeStableDiffusion]
+    // snippet-start:[php.example_code.bedrock-runtime.service.invokeStableDiffusion]
     public function invokeStableDiffusion(string $prompt, int $seed, string $style_preset)
     {
-        # The different model providers have individual request and response formats.
-        # For the format, ranges, and available style_presets of Stable Diffusion models refer to:
-        # https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-stability-diffusion.html
+        // The different model providers have individual request and response formats.
+        // For the format, ranges, and available style_presets of Stable Diffusion models refer to:
+        // https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-stability-diffusion.html
 
         $base64_image_data = "";
         try {
@@ -149,14 +147,14 @@ public function invokeStableDiffusion(string $prompt, int $seed, string $style_p
 
         return $base64_image_data;
     }
-    #snippet-end:[php.example_code.bedrock-runtime.service.invokeStableDiffusion]
+    // snippet-end:[php.example_code.bedrock-runtime.service.invokeStableDiffusion]
 
-    #snippet-start:[php.example_code.bedrock-runtime.service.invokeTitanImage]
+    // snippet-start:[php.example_code.bedrock-runtime.service.invokeTitanImage]
     public function invokeTitanImage(string $prompt, int $seed)
     {
-        # The different model providers have individual request and response formats.
-        # For the format, ranges, and default values for Titan Image models refer to:
-        # https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-titan-image.html
+        // The different model providers have individual request and response formats.
+        // For the format, ranges, and default values for Titan Image models refer to:
+        // https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-titan-image.html
 
         $base64_image_data = "";
         try {
@@ -188,7 +186,6 @@ public function invokeTitanImage(string $prompt, int $seed)
 
         return $base64_image_data;
     }
-    #snippet-end:[php.example_code.bedrock-runtime.service.invokeTitanImage]
+    // snippet-end:[php.example_code.bedrock-runtime.service.invokeTitanImage]
 }
-
-#snippet-end:[php.example_code.bedrock-runtime.service]
+// snippet-end:[php.example_code.bedrock-runtime.service]
diff --git a/php/example_code/bedrock-runtime/GettingStartedWithBedrockRuntime.php b/php/example_code/bedrock-runtime/GettingStartedWithBedrockRuntime.php
index 2ae6c4a668b..fb27160ce76 100644
--- a/php/example_code/bedrock-runtime/GettingStartedWithBedrockRuntime.php
+++ b/php/example_code/bedrock-runtime/GettingStartedWithBedrockRuntime.php
@@ -1,7 +1,6 @@
 <?php
-
-# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-# SPDX-License-Identifier: Apache-2.0
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
 
 /**
  * Purpose
@@ -9,7 +8,7 @@
  * - ...
  **/
 
-# snippet-start:[php.example_code.bedrock-runtime.basics.scenario]
+// snippet-start:[php.example_code.bedrock-runtime.basics.scenario]
 namespace BedrockRuntime;
 
 class GettingStartedWithBedrockRuntime
@@ -66,5 +65,4 @@ private function saveImage($base64_image_data, $model_id): string
         return $file_path;
     }
 }
-
-# snippet-end:[php.example_code.bedrock-runtime.basics.scenario]
+// snippet-end:[php.example_code.bedrock-runtime.basics.scenario]
diff --git a/php/example_code/bedrock-runtime/README.md b/php/example_code/bedrock-runtime/README.md
index 81c5fc0b615..222ea681547 100644
--- a/php/example_code/bedrock-runtime/README.md
+++ b/php/example_code/bedrock-runtime/README.md
@@ -44,23 +44,23 @@ functions within the same service.
 
 ### AI21 Labs Jurassic-2
 
-- [InvokeModel](BedrockRuntimeService.php#L57)
+- [InvokeModel](BedrockRuntimeService.php#L55)
 
 ### Amazon Titan Image Generator
 
-- [InvokeModel](BedrockRuntimeService.php#L154)
+- [InvokeModel](BedrockRuntimeService.php#L152)
 
 ### Anthropic Claude
 
-- [InvokeModel](BedrockRuntimeService.php#L24)
+- [InvokeModel](BedrockRuntimeService.php#L22)
 
 ### Meta Llama
 
-- [InvokeModel: Llama 2](BedrockRuntimeService.php#L87)
+- [InvokeModel: Llama 2](BedrockRuntimeService.php#L85)
 
 ### Stable Diffusion
 
-- [InvokeModel](BedrockRuntimeService.php#L117)
+- [InvokeModel](BedrockRuntimeService.php#L115)
 
 
 <!--custom.examples.start-->
diff --git a/php/example_code/bedrock-runtime/Runner.php b/php/example_code/bedrock-runtime/Runner.php
index 101f66c43ad..eb1ecaee049 100644
--- a/php/example_code/bedrock-runtime/Runner.php
+++ b/php/example_code/bedrock-runtime/Runner.php
@@ -1,5 +1,4 @@
 <?php
-
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
 
diff --git a/php/example_code/bedrock-runtime/composer.lock b/php/example_code/bedrock-runtime/composer.lock
index 78840220a4b..67036369eb2 100644
--- a/php/example_code/bedrock-runtime/composer.lock
+++ b/php/example_code/bedrock-runtime/composer.lock
@@ -62,16 +62,16 @@
         },
         {
             "name": "aws/aws-sdk-php",
-            "version": "3.321.8",
+            "version": "3.321.9",
             "source": {
                 "type": "git",
                 "url": "https://github.com/aws/aws-sdk-php.git",
-                "reference": "df456658bdc2ad84a00cf35a7b5af874fdcc7a53"
+                "reference": "5de5099cfe0e17cb3eb2fe51de0101c99bc9442a"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/aws/aws-sdk-php/zipball/df456658bdc2ad84a00cf35a7b5af874fdcc7a53",
-                "reference": "df456658bdc2ad84a00cf35a7b5af874fdcc7a53",
+                "url": "https://api.github.com/repos/aws/aws-sdk-php/zipball/5de5099cfe0e17cb3eb2fe51de0101c99bc9442a",
+                "reference": "5de5099cfe0e17cb3eb2fe51de0101c99bc9442a",
                 "shasum": ""
             },
             "require": {
@@ -154,9 +154,9 @@
             "support": {
                 "forum": "https://forums.aws.amazon.com/forum.jspa?forumID=80",
                 "issues": "https://github.com/aws/aws-sdk-php/issues",
-                "source": "https://github.com/aws/aws-sdk-php/tree/3.321.8"
+                "source": "https://github.com/aws/aws-sdk-php/tree/3.321.9"
             },
-            "time": "2024-09-10T18:18:03+00:00"
+            "time": "2024-09-11T18:15:49+00:00"
         },
         {
             "name": "guzzlehttp/guzzle",
diff --git a/php/example_code/bedrock-runtime/tests/BedrockRuntimeTests.php b/php/example_code/bedrock-runtime/tests/BedrockRuntimeTests.php
index 390c44435cf..a5665ef3c08 100644
--- a/php/example_code/bedrock-runtime/tests/BedrockRuntimeTests.php
+++ b/php/example_code/bedrock-runtime/tests/BedrockRuntimeTests.php
@@ -1,11 +1,10 @@
 <?php
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
 
-# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-# SPDX-License-Identifier: Apache-2.0
-
-#
-# Integration tests for the Amazon Bedrock Runtime service.
-#
+/**
+ * Integration tests for the Amazon Bedrock Runtime service.
+ */
 
 namespace bedrockruntime\tests;
 
diff --git a/php/example_code/bedrock/BedrockService.php b/php/example_code/bedrock/BedrockService.php
index ee3bfcf08bd..cafc8527e40 100644
--- a/php/example_code/bedrock/BedrockService.php
+++ b/php/example_code/bedrock/BedrockService.php
@@ -1,9 +1,8 @@
 <?php
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
 
-# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-# SPDX-License-Identifier: Apache-2.0
-
-#snippet-start:[php.example_code.bedrock.service]
+// snippet-start:[php.example_code.bedrock.service]
 namespace Bedrock;
 
 use Aws\Bedrock\BedrockClient;
@@ -11,7 +10,7 @@
 
 class BedrockService extends AWSServiceClass
 {
-    #snippet-start:[php.example_code.bedrock.service.listFoundationModels]
+    // snippet-start:[php.example_code.bedrock.service.listFoundationModels]
     public function listFoundationModels()
     {
         $bedrockClient = new BedrockClient([
@@ -21,6 +20,6 @@ public function listFoundationModels()
         $response = $bedrockClient->listFoundationModels();
         return $response['modelSummaries'];
     }
-    #snippet-end:[php.example_code.bedrock.service.listFoundationModels]
+    // snippet-end:[php.example_code.bedrock.service.listFoundationModels]
 }
-#snippet-end:[php.example_code.bedrock.service]
+// snippet-end:[php.example_code.bedrock.service]
diff --git a/php/example_code/bedrock/GettingStartedWithBedrock.php b/php/example_code/bedrock/GettingStartedWithBedrock.php
index 0995edb5429..8d78bfdb563 100644
--- a/php/example_code/bedrock/GettingStartedWithBedrock.php
+++ b/php/example_code/bedrock/GettingStartedWithBedrock.php
@@ -1,7 +1,6 @@
 <?php
-
-# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-# SPDX-License-Identifier: Apache-2.0
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
 
 /**
  * Purpose
@@ -9,7 +8,7 @@
  * List information about the available foundation models.
  **/
 
-# snippet-start:[php.example_code.bedrock.basics.scenario]
+// snippet-start:[php.example_code.bedrock.basics.scenario]
 namespace Bedrock;
 
 class GettingStartedWithBedrock
@@ -38,4 +37,4 @@ public function runExample()
         }
     }
 }
-# snippet-end:[php.example_code.bedrock.basics.scenario]
+// snippet-end:[php.example_code.bedrock.basics.scenario]
diff --git a/php/example_code/bedrock/README.md b/php/example_code/bedrock/README.md
index afe41b6a2f8..7a1785d339e 100644
--- a/php/example_code/bedrock/README.md
+++ b/php/example_code/bedrock/README.md
@@ -40,7 +40,7 @@ For prerequisites, see the [README](../../README.md#Prerequisites) in the `php`
 
 Code excerpts that show you how to call individual service functions.
 
-- [ListFoundationModels](BedrockService.php#L14)
+- [ListFoundationModels](BedrockService.php#L13)
 
 
 <!--custom.examples.start-->
diff --git a/php/example_code/bedrock/Runner.php b/php/example_code/bedrock/Runner.php
index cf6c71b491e..1d3e21b97ac 100644
--- a/php/example_code/bedrock/Runner.php
+++ b/php/example_code/bedrock/Runner.php
@@ -1,5 +1,4 @@
 <?php
-
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
 
diff --git a/php/example_code/bedrock/composer.lock b/php/example_code/bedrock/composer.lock
index 78840220a4b..67036369eb2 100644
--- a/php/example_code/bedrock/composer.lock
+++ b/php/example_code/bedrock/composer.lock
@@ -62,16 +62,16 @@
         },
         {
             "name": "aws/aws-sdk-php",
-            "version": "3.321.8",
+            "version": "3.321.9",
             "source": {
                 "type": "git",
                 "url": "https://github.com/aws/aws-sdk-php.git",
-                "reference": "df456658bdc2ad84a00cf35a7b5af874fdcc7a53"
+                "reference": "5de5099cfe0e17cb3eb2fe51de0101c99bc9442a"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/aws/aws-sdk-php/zipball/df456658bdc2ad84a00cf35a7b5af874fdcc7a53",
-                "reference": "df456658bdc2ad84a00cf35a7b5af874fdcc7a53",
+                "url": "https://api.github.com/repos/aws/aws-sdk-php/zipball/5de5099cfe0e17cb3eb2fe51de0101c99bc9442a",
+                "reference": "5de5099cfe0e17cb3eb2fe51de0101c99bc9442a",
                 "shasum": ""
             },
             "require": {
@@ -154,9 +154,9 @@
             "support": {
                 "forum": "https://forums.aws.amazon.com/forum.jspa?forumID=80",
                 "issues": "https://github.com/aws/aws-sdk-php/issues",
-                "source": "https://github.com/aws/aws-sdk-php/tree/3.321.8"
+                "source": "https://github.com/aws/aws-sdk-php/tree/3.321.9"
             },
-            "time": "2024-09-10T18:18:03+00:00"
+            "time": "2024-09-11T18:15:49+00:00"
         },
         {
             "name": "guzzlehttp/guzzle",
diff --git a/php/example_code/bedrock/tests/BedrockBasicsTests.php b/php/example_code/bedrock/tests/BedrockBasicsTests.php
index 395951de60e..47c296ace30 100644
--- a/php/example_code/bedrock/tests/BedrockBasicsTests.php
+++ b/php/example_code/bedrock/tests/BedrockBasicsTests.php
@@ -1,11 +1,10 @@
 <?php
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
 
-# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-# SPDX-License-Identifier: Apache-2.0
-
-#
-# Integration test runner for Amazon Bedrock files.
-#
+/**
+ * Integration test runner for Amazon Bedrock files.
+ */
 
 namespace bedrock\tests;