Skip to content

panther

2,907 4 198 MIT
v2.1.1 (3 Dec 2023) Jul 17 2018 8.2 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,337 v3.2.0 (3 months ago) Dec 27 2021 compare
506 3.0.0 (3 months ago) May 04 2020 compare
1,328 v0.7.2 (7 months ago) Mar 16 2013 compare
311 v1.9.3 (10 days ago) Apr 18 2022 compare

Other Languages

22,459 v2.1.0 (4 years ago) May 14 2018 compare
7,554 v1.3.4 (4 years ago) Feb 15 2020 compare
2,488 2024-05-09 (2 months ago) Jun 06 2019 compare
62,856 1.44.1 (a month ago) Jan 23 2015 compare
29,780 4.22.0 (24 days ago) Apr 25 2008 compare
651 2024-06-25 (20 days ago) Feb 09 2017 compare
11,134 1.45.0 (12 days ago) Feb 24 2021 compare
51,636 2.11.2 (2 months ago) Jul 26 2019 compare
1,485 1.0.4 (1 year, 10 months ago) Nov 22 2014 compare
9,064 3.5.5 (4 months ago) Sep 04 2020 compare
1,823 0.4.0 (5 months ago) Dec 28 2012 compare
10,591 chromedp (11 months ago) Aug 15 2019 compare
5,663 v0.18.0 (1 year, 3 months ago) Aug 06 2019 compare
2,029 (3 years ago) Nov 20 2016 compare
6,650 2.0.1 (20 days ago) Sep 10 2012 compare
2,884 1.4.3 (9 months ago) Sep 04 2013 compare
411 1.9.3.1 (a month ago) Jul 22 2022 compare
6,060 1.1.14 (1 year, 11 months ago) Jul 26 2019 compare
795 0.7.1 (5 months ago) Jul 25 2009 compare
1,308 3.0.0 (1 year, 10 months ago) Dec 27 2011 compare
3,048 1.5.0 (5 months ago) Sep 30 2018 compare
153 2.2.4 (3 years ago) Dec 22 2019 compare
240 1.33.0 (4 months ago) Feb 05 2023 compare
3,257 0.9.13 (11 months ago) Jul 04 2017 compare
1,737 0.8.5 (1 year, 10 months ago) Oct 17 2018 compare
4,039 3.5 (4 years ago) Apr 25 2014 compare
10,672 1.1.9 (5 years ago) Aug 24 2018 compare
200 1.0.0-beta8.4 (1 year, 17 days ago) Apr 18 2019 compare
413 0.1.3 (11 months ago) Feb 20 2022 compare
Was this page helpful?