PHPackages agalmar/chromiuman - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Testing & Quality](/categories/testing) 4. / 5. agalmar/chromiuman ActiveLibrary[Testing & Quality](/categories/testing) agalmar/chromiuman ================== The Codeception extension for automatically starting and stopping Chromedriver when running tests. 1.6.0(3y ago)013.7k1MITPHPPHP >=5.4.0 Since Sep 1Pushed 3y agoCompare [ Source](https://github.com/agalmar/chromiuman)[ Packagist](https://packagist.org/packages/agalmar/chromiuman)[ Docs](https://github.com/agalmar/chromiuman)[ RSS](/packages/agalmar-chromiuman/feed)WikiDiscussions master Synced today READMEChangelog (3)Dependencies (1)Versions (8)Used By (0) Chromiuman ========== [](#chromiuman) [![Latest Version](https://camo.githubusercontent.com/429e5328c1169e9e4355c48c5876f7155717cf679dd820d6d80b8eca2bc905eb/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6167616c6d61722f6368726f6d69756d616e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/agalmar/chromiuman)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)[![Total Downloads](https://camo.githubusercontent.com/bab4591da758c8f5bbb61a09904f32a13285f18aaa501b6a50e1543008adcdb3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6167616c6d61722f6368726f6d69756d616e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/agalmar/chromiuman) The [Codeception](http://codeception.com/) extension for automatically starting and stopping [Chromedriver](https://sites.google.com/a/chromium.org/chromedriver/) when running tests. Minimum Requirements -------------------- [](#minimum-requirements) - Codeception 2.2.7 - PHP 5.4 Installation using [Composer](https://getcomposer.org) ------------------------------------------------------ [](#installation-using-composer) ``` $ composer require agalmar/chromiuman ``` Be sure to enable the extension in `codeception.yml` as shown in [configuration](#configuration) below. Recommended Additional Packages ------------------------------- [](#recommended-additional-packages) ### Chromedriver Installer via Composer [](#chromedriver-installer-via-composer) It is highly recommended that you use the [Chromedriver Installer](https://github.com/lbaey/chromedriver) package which will install Chromedriver locally to your project in `vendor/bin`. Please follow the [installation instructions](https://github.com/lbaey/chromedriver#chrome-driver-packaged-in-composer)provided. **Chromiuman uses `vendor/bin/chromedriver` by default. If any other installation of chromedriver is used, please set the path as shown in the configuration below.** Configuration ------------- [](#configuration) By default Chromiuman will use the path `vendor/bin/chromedriver` and port `9515`. Enabling and configuration can be done in `codeception.yml` or in your suite config file. ### Enabling Chromedriver with defaults [](#enabling-chromedriver-with-defaults) ``` extensions: enabled: - Codeception\Extension\Chromiuman ``` ### Enabling Chromiuman with alternate settings [](#enabling-chromiuman-with-alternate-settings) ``` extensions: enabled: - Codeception\Extension\Chromiuman config: Codeception\Extension\Chromiuman: path: '/usr/bin/chromedriver' port: 9515 suites: ['acceptance'] ``` ### Enabling Chromiuman in the acceptance suite except on the `ci` environment [](#enabling-chromiuman-in-the-acceptance-suite-except-on-the-ci-environment) ``` extensions: enabled: - Codeception\Extension\Chromiuman: suites: ['acceptance'] env: ci: extensions: enabled: - Codeception\Extension\Chromiuman: suites: [] ``` ### Available options [](#available-options) Options set in the Chromiuman configuration are mapped to [Chromedriver Options](https://sites.google.com/a/chromium.org/chromedriver/capabilities#TOC-ChromeDriver-server-command-line-arguments). The currently supported options are listed below. - `path: {path}` - Full path to the Chromedriver binary. - Default: `vendor/bin/chromedriver` - `port: {port}` - Webdriver port to start chromedriver with - Default: `9515` - `adb_port: {port}` - Adb server port - `log_path: {FILE}` - Write server log to file instead of stderr, increases log level to INFO - `log_level: {LEVEL}` - Set log level: ALL, DEBUG, INFO, WARNING, SEVERE, OFF - `debug: {true|false}` - Display debug output (log verbosely, equivalent to `log-level: {ALL}`) while Chromedriver runs - Default: `false` - `silent: {true|false}` - Logs nothing (equivalent to `log-level: {OFF}`) - Default: `false` - `append_log: {true|false}` - Append log file instead of rewriting - Default: `false` - `url_base: {base URL}` - Base URL path prefix for commands, e.g. wd/url - Default: `wd/url` - `replayable: {true|false}` - (experimental) log verbosely and don't truncate long strings so that the log can be replayed - `enable_chrome_logs: {true|false}` - show logs from the browser (overrides other logging options) - `allowed_ips: {CS-IP_List}` - Comma-separated allowlist of remote IP addresses which are allowed to connect to ChromeDriver - `allowed_origins: {CS-Request_Origin_List}` - comma-separated allowlist of request origins which are allowed to connect to ChromeDriver. Using `*` to allow any host origin is dangerous! - `disable_dev_shm_usage: {true|false}` - Do not use /dev/shm (add this switch if seeing errors related to shared memory) - Default: `false` - `readable_timestamp: {true|false}` - Adds readable timestamps to log - Default: `false` - `suites: {array|string}` - If omitted, Chromedriver is started for all suites - Specify an array of suites or a single suite name Usage ----- [](#usage) Once installed and enabled, running your tests with `php codecept run` will automatically start the Chromedriver server and wait for it to be accessible before proceeding with the tests. ``` Starting Chromedriver. Waiting for Chromedriver to be reachable.. Chromedriver now accessible. ``` Once the tests are complete, Chromedriver will be shut down. ``` Stopping Chromedriver. ``` ### Health Score 31 — LowBetter than 68% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity20 Limited adoption so far Community7 Small or concentrated contributor base Maturity63 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~309 days Recently: every ~369 days Total 7 Last Release 1316d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/aedcdff5769e833a56f845038883e26bc708a0b3ebaf066f71d87d07076b5b72?d=identicon)[agalmar](/maintainers/agalmar) --- Top Contributors [![agalmar](https://avatars.githubusercontent.com/u/31545464?v=4)](https://github.com/agalmar "agalmar (7 commits)") --- Tags codeceptionheadlesschromeextension ### Embed Badge ![Health badge](/badges/agalmar-chromiuman/health.svg) ``` [![Health](https://phpackages.com/badges/agalmar-chromiuman/health.svg)](https://phpackages.com/packages/agalmar-chromiuman) ``` ### Alternatives [site5/phantoman The Codeception extension for automatically starting and stopping PhantomJS when running tests. 481.1M17](/packages/site5-phantoman)[dmore/behat-chrome-extension Behat extension for controlling Chrome without Selenium 3313.2M358](/packages/dmore-behat-chrome-extension)[mcustiel/phiremock-codeception-extension Codeception extension for Phiremock. Allows to stub remote services for HTTP requests. 311.0M5](/packages/mcustiel-phiremock-codeception-extension)[robertfausk/mink-panther-driver Symfony Panther driver for Mink framework 123.4M2](/packages/robertfausk-mink-panther-driver)[mcustiel/codeception-http-mock Extension for HTTP Mock. 1424.3k1](/packages/mcustiel-codeception-http-mock)[docler-labs/codeception-slim-module Codeception Module for Slim framework. 13178.0k1](/packages/docler-labs-codeception-slim-module) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)