Add CHROME_NO_SANDBOX env var

Author: GrahamCampbell

.github/workflows/tests.yml

@@ -96,3 +96,4 @@ jobs:
         run: vendor/bin/phpunit
         env:
           CHROME_PATH: /opt/hostedtoolcache/setup-chrome/chromium/122.0.6261.128/x64/chrome
+          CHROME_NO_SANDBOX: true

CHANGELOG.md

@@ -6,6 +6,8 @@
 * Add PHP 8.5 support
 * Add support for using Symfony 8 components
 * Remove support for Symfony 4 components
+* Merge options with defaults in factory
+* Add `CHROME_NO_SANDBOX` env var
 
 
 ## 1.14.0 (2025-05-28)

src/AutoDiscover.php

@@ -69,4 +69,21 @@ private static function shellExec(string $command): ?string
             return null;
         }
     }
+
+    /**
+     * Get default browser options from environment variables.
+     *
+     * @return array<string, mixed>
+     */
+    public function getDefaultOptions(): array
+    {
+        $options = [];
+
+        if (\array_key_exists('CHROME_NO_SANDBOX', $_SERVER)
+            && \filter_var($_SERVER['CHROME_NO_SANDBOX'], \FILTER_VALIDATE_BOOLEAN)) {
+            $options['noSandbox'] = true;
+        }
+
+        return $options;
+    }
 }

src/BrowserFactory.php

@@ -52,7 +52,9 @@ class BrowserFactory
 
     public function __construct(?string $chromeBinary = null)
     {
-        $this->chromeBinary = $chromeBinary ?? (new AutoDiscover())->guessChromeBinaryPath();
+        $autoDiscover = new AutoDiscover();
+        $this->chromeBinary = $chromeBinary ?? $autoDiscover->guessChromeBinaryPath();
+        $this->options = \array_merge($this->options, $autoDiscover->getDefaultOptions());
     }
 
     /**
@@ -66,7 +68,7 @@ public function __construct(?string $chromeBinary = null)
      */
     public function createBrowser(?array $options = null): ProcessAwareBrowser
     {
-        $options ??= $this->options;
+        $options = \array_merge($this->options, $options ?? []);
 
         // create logger from options
         $logger = self::createLogger($options);