chrome-php/chrome
Instrument headless chrome/chromium instances from PHP
v1.16.1
5.6M downloads/mo
#1314 most downloaded on Packagist
chrome-php/chrome
What this package is like to depend on
Last release 1 months ago
06 Jul 2026
Ships fairly regularly
a new release about every 4 months
Most releases are documented
notes for 39 of 54 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
54 releases · first in 2018
4 releases in the last 12 months
see the full history below
Release timeline
54 releases · Apr 2018 to Jul 2026Releases
latest 54-
v1.16.106 Jul 2026 -
v1.16.006 Jul 2026Release notes
Open source →- Promote the returned
PageUtilshelper classes to the public API - Add an option and browser API to disable JavaScript execution on existing and future pages
- Allow choosing the box model in
Node::getPosition() - Allow setting
referrer,referrerPolicyandtransitionTypeinPage::navigate() - Add
Page::authenticateandPage::clearAuthenticationmethods for HTTP authentication challenges - Add
AbstractBinaryInput::saveToStreammethod - Allow specifying options in
Page::screenshotElement() - Allow fractional mouse coordinates in
Mouse::move() - Return floats from
Mouse::getPosition() - Wait for socket data instead of polling for responses
- Require
chrome-php/wrench^1.9 - Support newer versions of Chrome
Release notes
Open source →- Promote the returned
PageUtilshelper classes to the public API - Add an option and browser API to disable JavaScript execution on existing and future pages
- Allow choosing the box model in
Node::getPosition() - Allow setting
referrer,referrerPolicyandtransitionTypeinPage::navigate() - Add
Page::authenticateandPage::clearAuthenticationmethods for HTTP authentication challenges - Add
AbstractBinaryInput::saveToStreammethod - Allow specifying options in
Page::screenshotElement() - Allow fractional mouse coordinates in
Mouse::move() - Return floats from
Mouse::getPosition() - Wait for socket data instead of polling for responses
- Require
chrome-php/wrench^1.9 - Support newer versions of Chrome
- Promote the returned
-
v1.15.106 Jul 2026Release notes
Open source →- Fix mouse scrolling timing out when the page changes during the scroll
- Fix Linux Chrome binary detection on POSIX shells
Release notes
Open source →- Fix mouse scrolling timing out when the page changes during the scroll
- Fix Linux Chrome binary detection on POSIX shells
-
v1.15.027 Dec 2025Release notes
Open source →- Add PHP 8.5 support
- Add support for using Symfony 8 components
- Remove support for Symfony 4 components
- Add
CHROME_NO_SANDBOXenv var
Release notes
Open source →- Add PHP 8.5 support
- Add support for using Symfony 8 components
- Remove support for Symfony 4 components
- Add
CHROME_NO_SANDBOXenv var
-
v1.14.028 May 2025Release notes
Open source →- Use more specific return type in
PageScreenshot::getException - Security fix for missing encoding in
CssSelector
Release notes
Open source →- Use more specific return type in
PageScreenshot::getException - Security fix for missing encoding in
CssSelector
- Use more specific return type in
-
v1.13.007 Feb 2025 -
v1.12.107 Feb 2025 -
v1.12.009 Dec 2024Release notes
Open source →- Add PHP 8.4 support
- Add the ability to screenshot individual elements on the page
- Add
AbstractBinaryInput::getRawBinarymethod - Have
CookieimplementIteratorAggregate
Release notes
Open source →- Add PHP 8.4 support
- Add the ability to screenshot individual elements on the page
- Add
AbstractBinaryInput::getRawBinarymethod - Have
CookieimplementIteratorAggregate
-
v1.11.017 Mar 2024 -
v1.10.117 Mar 2024 -
v1.10.010 Dec 2023Release notes
Open source →- Add
Add Node::setHTMLmethod - Add
Page::setScriptExecutionmethod - Allow usage of XPath in
Page::waitForElement - Enable removal of Chrome flags via
excludedSwitchesoption - Add support for
webpformatandoptimizeForSpeedoption inPage::screenshot - Add support for using Symfony 7 components
- Add
-
v1.9.108 Oct 2023Release notes
Open source →- Fix rare crash in
Page::getHtml - Fix whitespace character handling in
Keyboard::typeText()
- Fix rare crash in
-
v1.9.030 Apr 2023Release notes
Open source →- Added some additional life-cycle event constants
- Added support for disabling browser notifications
-
v1.8.111 Mar 2023Release notes
Open source →- Fixed issue where Chrome 111 and later have different default allowed origins
-
v1.8.027 Feb 2023Release notes
Open source →- Add helper function to find target
- Add
--crash-dumps-diroption - Allow passing the event name to wait for in
setHtml - Dropped PHP 7.3 support
-
v1.7.227 Feb 2023Release notes
Open source →- Fix case where the timeout in
setHtml()isn't respected - Fix hard coded timeout in
Domclass - Fix hard coded timeout in
ResponseReaderclass - Stop process when an error occurs during startup
- Stop process on
waitForStartupif dev tools failed to start - Disconnect socket on
sendCloseMessage
- Fix case where the timeout in
-
v1.7.104 Sep 2022 -
v1.7.028 Aug 2022Release notes
Open source →- Use
commandto guess the chrome executable in Linux - Officially support PHP 8.2
- Fix extra HTTP headers
- Use
-
v1.6.228 Aug 2022Release notes
Open source →- Fix intermittency in
Mouse::findElement() - Fix scroll with values higher than possible
- Fix intermittency in
-
v1.6.117 May 2022 -
v1.6.030 Mar 2022 -
v1.5.025 Mar 2022Release notes
Open source →- Added
Browser::getPagesmethod - Added
Page::waitUntilContainsElement()method - Added
Page::setHtml()method - Added support for XPath by introducing
Selector - Added
Mouse::findElement()method - Switch to flatten mode
- Added
-
v1.4.125 Mar 2022Release notes
Open source →- Added fallback to css layout metrics
- Added missing destroyed setting
- Prevent
Node::querySelectorfrom returning nodeId0 - Fixed "What's new" page opening on startup
- More fixes to enable eventual PHP 8.1 support
-
v1.4.023 Jan 2022Release notes
Open source →- Added support for
--no-proxy-serverand--proxy-bypass-list - Added timeout option to
Page::getHtml - Added
Node::sendFilesmethod
- Added support for
-
v1.3.123 Jan 2022Release notes
Open source →- Fixed issues with
Keyboard::typeTextwith multibyte strings - Fixed issues with retina and scaled displays
- Fixed issues with timeouts if system time changes
- Fixed
Mouse::find()after cursor has moved
- Fixed issues with
-
v1.3.007 Dec 2021Release notes
Open source →- Added support for setting HTTP headers
- Added support for
psr/log2 and 3
-
v1.2.107 Dec 2021 -
v1.2.020 Nov 2021Release notes
Open source →- Dropped
--disable-default-appsand--disable-extensionsby default - Added API for interacting with the DOM
- Added a way to set the timezone
- Reworked
PagePdfclass to improve validation
- Dropped
-
v1.1.120 Nov 2021 -
v1.1.026 Sep 2021 -
v1.0.101 Sep 2021 -
v1.0.015 Aug 2021Release notes
Open source →- Switched over to
chrome-php/wrench - Add support for keyboard key combinations
- Switched over to
-
v0.11.201 Sep 2021Nothing published for this version
-
v0.11.115 Aug 2021 -
v0.11.018 Jul 2021Release notes
Open source →- Added support for proxy servers as a direct option
- Added support for passing environment variables
- Added support for Symfony 6
- Removed broken
getChromeVersionfunction - Implemented more robust auto-discovery
-
v0.10.022 May 2021Release notes
Open source →- Added
Page::getHtml - Added keyboard API
- Added mouse scrolling
- Attempt to auto-detect chrome binary path
- Added support for
setDownloadPath - Added support for
captureBeyondViewport
- Added
-
v0.9.009 Dec 2020Release notes
Open source →- Support PHP 8.0
- Increase default sync timeout to 5 seconds
- Set
--font-render-hinting=nonein headless mode - Fixed keep alive option
- Fixed various phpdoc issues
- Fixed sending params to newer Chrome
- Fixed
Wrench::connect()return value - Avoid non-thread-safe getenv function
-
v0.8.120 Feb 2020 -
v0.8.020 Feb 2020Release notes
Open source →- Added
Page::pdf - Added timeout for PageEvaluation methods
- Added support for Symfony 5
- Added
Browser::close
- Added
-
v0.7.004 Oct 2019Release notes
Open source →- Escaping custom flags for
BrowserFactoryis now automatic - Added timeout for
Page::getFullPageClip - Added timeout for method
getBase64 - Added options
headerTemplateandfooterTempalteforPage::pdf - Added options
scalefor Page::pdf - Handle gracefully all pages failing to close
- Fixed deprecation from Symfony
- Escaping custom flags for
-
v0.6.014 Nov 2018Nothing published for this version
-
v0.5.013 Nov 2018Nothing published for this version
-
v0.4.025 Oct 2018Nothing published for this version
-
v0.3.013 Oct 2018Nothing published for this version
-
v0.2.404 Oct 2018Nothing published for this version
-
v0.2.302 Oct 2018Nothing published for this version
-
v0.2.228 Aug 2018Nothing published for this version
-
v0.2.120 Jun 2018Nothing published for this version
-
v0.2.015 Jun 2018Nothing published for this version
-
v0.1.427 Apr 2018Nothing published for this version
-
v0.1.326 Apr 2018Nothing published for this version
-
v0.1.226 Apr 2018Nothing published for this version
-
v0.1.125 Apr 2018Nothing published for this version
-
v0.1.006 Apr 2018Nothing published for this version