Merge branch '1.13' into patch-11

Author: divinity76

.github/workflows/static.yml

@@ -32,7 +32,7 @@ jobs:
         with:
           timeout_minutes: 5
           max_attempts: 5
-          command: composer bin phpstan update --no-interaction --no-progress
+          command: composer bin phpstan install --no-interaction --no-progress
 
       - name: Execute PHPStan
         run: vendor/bin/phpstan analyze --no-progress

.github/workflows/tests.yml

@@ -11,7 +11,7 @@ jobs:
 
     strategy:
       matrix:
-        php: ['7.4', '8.0', '8.1', '8.2', '8.3']
+        php: ['7.4', '8.0', '8.1', '8.2', '8.3', '8.4']
         symfony: ['4', '5', '6', '7']
         exclude:
           - php: '7.4'
@@ -22,11 +22,17 @@ jobs:
             symfony: '7'
           - php: '8.1'
             symfony: '7'
+          - php: '8.4'
+            symfony: '4'
 
     steps:
       - name: Checkout Code
         uses: actions/checkout@v4
 
+      - uses: browser-actions/setup-chrome@v1
+        with:
+          chrome-version: 122
+
       - name: Setup PHP
         uses: shivammathur/setup-php@v2
         with:
@@ -81,4 +87,4 @@ jobs:
       - name: Execute PHPUnit
         run: vendor/bin/phpunit
         env:
-          CHROME_PATH: google-chrome-stable
+          CHROME_PATH: /opt/hostedtoolcache/setup-chrome/chromium/122.0.6261.128/x64/chrome

.gitignore

@@ -1,5 +1,5 @@
-.phpunit.result.cache
-composer.lock
-phpstan.neon
-phpunit.xml
+/.phpunit.result.cache
+/composer.lock
+/phpstan.neon
+/phpunit.xml
 vendor

CHANGELOG.md

@@ -1,6 +1,24 @@
 # CHANGELOG
 
 
+## 1.13.0 (2025-02-07)
+
+* Set maximal expires value if `session=false` in `Page::setCookies`
+
+
+## 1.12.1 (2025-02-07)
+
+* Fix nullable parameter definition in `AbstractBinaryInput::getRawBinary`
+
+
+## 1.12.0 (2024-12-09)
+
+* Add PHP 8.4 support
+* Add the ability to screenshot individual elements on the page
+* Add `AbstractBinaryInput::getRawBinary` method
+* Have `Cookie` implement `IteratorAggregate`
+
+
 ## 1.11.0 (2024-03-17)
 
 * Add PHP 8.3 support

README.md

@@ -24,7 +24,7 @@ Happy browsing!
 
 ## Requirements
 
-Requires PHP 7.4-8.3 and a Chrome/Chromium 65+ executable.
+Requires PHP 7.4-8.4 and a Chrome/Chromium 65+ executable.
 
 Note that the library is only tested on Linux but is compatible with macOS and Windows.
 

composer.json

@@ -17,7 +17,7 @@
     ],
     "require": {
         "php": "^7.4.15 || ^8.0.2",
-        "chrome-php/wrench": "^1.6",
+        "chrome-php/wrench": "^1.7",
         "evenement/evenement": "^3.0.1",
         "monolog/monolog": "^1.27.1 || ^2.8 || ^3.2",
         "psr/log": "^1.1 || ^2.0 || ^3.0",

src/Browser.php

@@ -98,7 +98,7 @@ public function getConnection(): Connection
      *
      * @param string|null $script
      */
-    public function setPagePreScript(string $script = null): void
+    public function setPagePreScript(?string $script = null): void
     {
         $this->pagePreScript = $script;
     }

src/Browser/BrowserProcess.php

@@ -78,7 +78,7 @@ class BrowserProcess implements LoggerAwareInterface
      *
      * @param LoggerInterface|null $logger
      */
-    public function __construct(LoggerInterface $logger = null)
+    public function __construct(?LoggerInterface $logger = null)
     {
         // set or create logger
         $this->setLogger($logger ?? new NullLogger());

src/BrowserFactory.php

@@ -50,7 +50,7 @@ class BrowserFactory
      */
     protected $options = [];
 
-    public function __construct(string $chromeBinary = null)
+    public function __construct(?string $chromeBinary = null)
     {
         $this->chromeBinary = $chromeBinary ?? (new AutoDiscover())->guessChromeBinaryPath();
     }

src/Clip.php

@@ -13,20 +13,23 @@
 
 class Clip
 {
+    /** @var int|float */
     protected $x;
+    /** @var int|float */
     protected $y;
+    /** @var int|float */
     protected $height;
+    /** @var int|float */
     protected $width;
+    /** @var float */
     protected $scale;
 
     /**
-     * Clip constructor.
-     *
-     * @param int   $x
-     * @param int   $y
-     * @param int   $height
-     * @param int   $width
-     * @param float $scale
+     * @param int|float $x
+     * @param int|float $y
+     * @param int|float $height
+     * @param int|float $width
+     * @param float     $scale
      */
     public function __construct($x, $y, $width, $height, $scale = 1.0)
     {
@@ -38,79 +41,79 @@ public function __construct($x, $y, $width, $height, $scale = 1.0)
     }
 
     /**
-     * @return mixed
+     * @return int|float
      */
     public function getX()
     {
         return $this->x;
     }
 
     /**
-     * @return mixed
+     * @return int|float
      */
     public function getY()
     {
         return $this->y;
     }
 
     /**
-     * @return mixed
+     * @return int|float
      */
     public function getHeight()
     {
         return $this->height;
     }
 
     /**
-     * @return mixed
+     * @return int|float
      */
     public function getWidth()
     {
         return $this->width;
     }
 
     /**
-     * @return mixed
+     * @return float
      */
     public function getScale()
     {
         return $this->scale;
     }
 
     /**
-     * @param mixed $x
+     * @param int|float $x
      */
     public function setX($x): void
     {
         $this->x = $x;
     }
 
     /**
-     * @param mixed $y
+     * @param int|float $y
      */
     public function setY($y): void
     {
         $this->y = $y;
     }
 
     /**
-     * @param mixed $height
+     * @param int $height
      */
     public function setHeight($height): void
     {
         $this->height = $height;
     }
 
     /**
-     * @param mixed $width
+     * @param int $width
      */
     public function setWidth($width): void
     {
         $this->width = $width;
     }
 
     /**
-     * @param mixed $scale
+     * @param float $scale
      */
     public function setScale($scale): void
     {