Skip to content

panther

2,829 4 185 MIT
v2.1.0 (30 May 2023) Jul 17 2018 7.0 thousand (month)

Panther is a convenient standalone library to scrape websites and to run end-to-end tests using real browsers.

Panther is super powerful. It leverages the W3C's WebDriver protocol to drive native web browsers such as Google Chrome and Firefox.

Panther is very easy to use, because it implements Symfony's popular BrowserKit and DomCrawler APIs, and contains all the features you need to test your apps. It will sound familiar if you have ever created a functional test for a Symfony app: as the API is exactly the same! Keep in mind that Panther can be used in every PHP project, as it is a standalone library.

Panther automatically finds your local installation of Chrome or Firefox and launches them, so you don't need to install anything else on your computer, a Selenium server is not needed!

In test mode, Panther automatically starts your application using the PHP built-in web-server. You can focus on writing your tests or web-scraping scenario and Panther will take care of everything else.

Features:

  • executes the JavaScript code contained in webpages
  • supports everything that Chrome (or Firefox) implements
  • allows taking screenshots
  • can wait for asynchronously loaded elements to show up
  • lets you run your own JS code or XPath queries in the context of the loaded page
  • supports custom Selenium server installations
  • supports remote browser testing services including SauceLabs and BrowserStack

Example Use


<?php

use Symfony\Component\Panther\Client;

require __DIR__.'/vendor/autoload.php'; // Composer's autoloader

$client = Client::createChromeClient();
// Or, if you care about the open web and prefer to use Firefox
$client = Client::createFirefoxClient();

$client->request('GET', 'https://api-platform.com'); // Yes, this website is 100% written in JavaScript
$client->clickLink('Get started');

// Wait for an element to be present in the DOM (even if hidden)
$crawler = $client->waitFor('#installing-the-framework');
// Alternatively, wait for an element to be visible
$crawler = $client->waitForVisibility('#installing-the-framework');

echo $crawler->filter('#installing-the-framework')->text();
$client->takeScreenshot('screen.png'); // Yeah, screenshot!

Alternatives / Similar


1,271 2.0.1 (9 months ago) Dec 27 2021 compare
443 2.0.0 (5 months ago) May 04 2020 compare
1,312 v0.7.1 (3 months ago) Mar 16 2013 compare
277 v1.3.0 (a month ago) Apr 18 2022 compare

Other Languages

21,215 v2.1.0 (3 years ago) May 14 2018 compare
7,476 v1.3.4 (3 years ago) Feb 15 2020 compare
2,296 2023-11-24 (4 days ago) Jun 06 2019 compare
28,273 4.15.2 (25 days ago) Apr 25 2008 compare
622 2023-11-24 (4 days ago) Feb 09 2017 compare
9,689 1.40.0 (7 days ago) Feb 24 2021 compare
49,364 2.11.0 (2 months ago) Jul 26 2019 compare
1,428 1.0.3 (2 years ago) Nov 22 2014 compare
2,734 1.4.3 (2 months ago) Sep 04 2013 compare
6,541 1.4.0 (10 months ago) Sep 10 2012 compare
5,513 v0.18.0 (8 months ago) Aug 06 2019 compare
2,021 (2 years ago) Nov 20 2016 compare
9,752 chromedp (3 months ago) Aug 15 2019 compare
1,755 0.2.1 (6 months ago) Dec 28 2012 compare
5,654 1.1.14 (1 year, 4 months ago) Jul 26 2019 compare
1,298 3.0.0 (1 year, 3 months ago) Dec 27 2011 compare
769 0.7.0 (10 months ago) Jul 25 2009 compare
150 2.2.4 (2 years ago) Dec 22 2019 compare
1,701 0.8.5 (1 year, 2 months ago) Oct 17 2018 compare
2,864 1.4.1 (2 months ago) Sep 30 2018 compare
3,944 3.5 (3 years ago) Apr 25 2014 compare
3,118 0.9.13 (4 months ago) Jul 04 2017 compare
10,120 1.1.9 (5 years ago) Aug 24 2018 compare
224 1.27.1 (3 months ago) Feb 05 2023 compare
186 1.0.0-beta8.4 (5 months ago) Apr 18 2019 compare
386 0.1.3 (3 months ago) Feb 20 2022 compare