release: 3.14.0

.php-cs-fixer.dist.php

@@ -4,6 +4,8 @@
 use PhpCsFixer\Finder;
 use PhpCsFixer\Runner\Parallel\ParallelConfigFactory;
 
+ini_set('memory_limit', -1);
+
 return (new Config)
     ->setParallelConfig(ParallelConfigFactory::detect())
     ->setFinder(Finder::create()->in([__DIR__.'/src', __DIR__.'/tests']))

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "3.13.1"
+  ".": "3.14.0"
 }

CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 3.14.0 (2026-02-03)
+
+Full Changelog: [v3.13.1...v3.14.0](https://github.com/browserbase/stagehand-php/compare/v3.13.1...v3.14.0)
+
+### Features
+
+* use `$_ENV` aware getenv helper ([648193c](https://github.com/browserbase/stagehand-php/commit/648193c0d5db24aec73e908a6415342059106763))
+
+
+### Chores
+
+* **internal:** php cs fixer should not be memory limited ([85b427d](https://github.com/browserbase/stagehand-php/commit/85b427d1f6c2d7074950c2b02a9731491e3f8a60))
+
 ## 3.13.1 (2026-01-31)
 
 Full Changelog: [v3.13.0...v3.13.1](https://github.com/browserbase/stagehand-php/compare/v3.13.0...v3.13.1)

README.md

@@ -80,7 +80,7 @@ The REST API documentation can be found on [docs.stagehand.dev](https://docs.sta
 <!-- x-release-please-start-version -->
 
 ```
-composer require "browserbase/stagehand 3.13.1"
+composer require "browserbase/stagehand 3.14.0"
 ```
 
 <!-- x-release-please-end -->

src/Client.php

@@ -37,11 +37,17 @@ public function __construct(
         ?string $baseUrl = null,
         RequestOptions|array|null $requestOptions = null,
     ) {
-        $this->browserbaseAPIKey = (string) ($browserbaseAPIKey ?? getenv('BROWSERBASE_API_KEY'));
-        $this->browserbaseProjectID = (string) ($browserbaseProjectID ?? getenv('BROWSERBASE_PROJECT_ID'));
-        $this->modelAPIKey = (string) ($modelAPIKey ?? getenv('MODEL_API_KEY'));
-
-        $baseUrl ??= getenv(
+        $this->browserbaseAPIKey = (string) ($browserbaseAPIKey ?? Util::getenv(
+            'BROWSERBASE_API_KEY'
+        ));
+        $this->browserbaseProjectID = (string) ($browserbaseProjectID ?? Util::getenv(
+            'BROWSERBASE_PROJECT_ID'
+        ));
+        $this->modelAPIKey = (string) ($modelAPIKey ?? Util::getenv(
+            'MODEL_API_KEY'
+        ));
+
+        $baseUrl ??= Util::getenv(
             'STAGEHAND_BASE_URL'
         ) ?: 'https://api.stagehand.browserbase.com';
 

src/Core/Util.php

@@ -25,6 +25,23 @@ final class Util
 
     public const JSONL_CONTENT_TYPE = '/^application\/(:?x-(?:n|l)djson)|(:?(?:x-)?jsonl)/';
 
+    public static function getenv(string $key): ?string
+    {
+        if (array_key_exists($key, array: $_ENV)) {
+            if (!is_string($value = $_ENV[$key])) {
+                throw new \InvalidArgumentException;
+            }
+
+            return $value;
+        }
+
+        if (is_string($value = getenv($key))) {
+            return $value;
+        }
+
+        return null;
+    }
+
     /**
      * @return array<string,mixed>
      */

src/Version.php

@@ -5,5 +5,5 @@
 namespace Stagehand;
 
 // x-release-please-start-version
-const VERSION = '3.13.1';
+const VERSION = '3.14.0';
 // x-release-please-end

tests/Services/SessionsTest.php

@@ -6,6 +6,7 @@
 use PHPUnit\Framework\Attributes\Test;
 use PHPUnit\Framework\TestCase;
 use Stagehand\Client;
+use Stagehand\Core\Util;
 use Stagehand\Sessions\SessionActResponse;
 use Stagehand\Sessions\SessionEndResponse;
 use Stagehand\Sessions\SessionExecuteResponse;
@@ -28,7 +29,7 @@ protected function setUp(): void
     {
         parent::setUp();
 
-        $testUrl = getenv('TEST_API_BASE_URL') ?: 'http://127.0.0.1:4010';
+        $testUrl = Util::getenv('TEST_API_BASE_URL') ?: 'http://127.0.0.1:4010';
         $client = new Client(
             browserbaseAPIKey: 'My Browserbase API Key',
             browserbaseProjectID: 'My Browserbase Project ID',