Weave Code
Webdriver Laravel Package
facebook/webdriver
Archived Selenium WebDriver bindings for PHP. Controls browsers via Selenium 2–4 using JsonWireProtocol and partial W3C WebDriver support. Install with Composer and connect to a running selenium-server. Use php-webdriver/php-webdriver for current updates.
Archived version of facebook/php-webdriver. See https://github.com/php-webdriver/php-webdriver for replacement.
Frequently asked questions about Webdriver
- Can I use facebook/webdriver for Laravel UI testing instead of HttpTests?
- Yes, this package lets you automate real browsers (Chrome, Firefox) for testing SPAs, complex JavaScript, or visual regressions. Replace Laravel’s HttpTests with WebDriver for full browser interactions, but expect slower execution times. Use headless mode for CI/CD to speed up tests.
- What’s the difference between facebook/webdriver and php-webdriver?
- This package (facebook/webdriver) is archived and lacks updates, while php-webdriver is the active successor with better W3C WebDriver support. Migrate to php-webdriver unless you’re locked into legacy Selenium 2.x features. Check the README for migration steps.
- How do I install and run Selenium Server with Laravel?
- Install the package via Composer (`composer require facebook/webdriver`), then download a Selenium Server JAR (e.g., `selenium-server-standalone-4.10.jar`) from the [official releases](http://selenium-release.storage.googleapis.com/). Run it with `java -jar selenium-server-standalone-*.jar` (requires Java 8+). For Laravel, consider Dockerizing the server to avoid host dependencies.
- Will this work with Laravel Queues for background browser tasks?
- Absolutely. Offload browser-heavy tasks (e.g., PDF generation, scraping) to Laravel Queues by wrapping WebDriver logic in a job. Use `dispatch()` to queue tasks, and ensure your queue worker has access to Selenium Server or browser drivers. Monitor memory usage for long-running sessions.
- Does facebook/webdriver support Laravel’s testing frameworks like PestPHP?
- Not natively, but you can integrate it by creating custom test listeners or extending PestPHP/PHPUnit. Use WebDriver for browser-specific tests while keeping HttpTests for API-level validation. Example: Write a `WebDriverTestCase` class to bootstrap sessions before each test.
- What Laravel versions and PHP requirements does this package support?
- Works with Laravel 8/9/10 (PHP 7.4+) and may require polyfills for older PHP versions. Test thoroughly with your Laravel version, as the archived status means no official compatibility guarantees. For Laravel 11, consider php-webdriver instead.
- How do I handle flaky WebDriver tests in Laravel?
- Implement retries with exponential backoff (e.g., 3 retries with 1s delays) using Laravel’s `retry()` helper or a custom trait. For persistent failures, use circuit breakers (e.g., `spatie/flysystem-circuitbreaker`) to skip tests after X failures. Log driver crashes to debug root causes.
- Can I use GeckoDriver/ChromeDriver directly without Selenium Server?
- Yes, this package supports direct browser drivers (e.g., `webdriver:chrome` or `webdriver:firefox`) via W3C WebDriver protocol. Configure drivers in your code like `$driver = RemoteWebDriver::create('http://localhost:9515', DesiredCapabilities::chrome())`. Manage driver binaries via Docker, CI/CD, or local installs.
- What are the performance implications of browser automation in Laravel?
- Browser tasks are resource-intensive: expect 1–5 seconds per request in headless mode, longer for full browsers. Optimize by using queues, limiting concurrent sessions, and caching results. For production, containerize Selenium Server (e.g., Docker) to isolate resource usage.
- Are there alternatives to facebook/webdriver for Laravel?
- For modern Laravel apps, use `php-webdriver` (active maintenance) or consider Puppeteer/PuppeteerSharp via PHP extensions for headless Chrome. For lightweight scraping, try Guzzle with HTML parsers (e.g., Symfony DomCrawler). Evaluate trade-offs: php-webdriver offers better W3C support, while Puppeteer is faster but less feature-rich.
Weaver
How can I help you explore Laravel packages today?