Skip to content
This repository

PHP 5.3+ web browser emulator abstraction

Fetching latest commit…

Cannot retrieve the latest commit at this time

README.md

Mink

Build Status

Usage Example

<?php

use Behat\Mink\Mink,
    Behat\Mink\Session,
    Behat\Mink\Driver\GoutteDriver,
    Behat\Mink\Driver\SahiDriver;

$startUrl = 'http://example.com';

// init Mink and register sessions
$mink = new Mink(array(
    'goutte1'    => new Session(new GoutteDriver($startUrl)),
    'goutte2'    => new Session(new GoutteDriver($startUrl)),
    'javascript' => new Session(new SahiDriver($startUrl, 'firefox')),
    'custom'     => new Session(new MyCustomDriver($startUrl))
));

// set default session name
$mink->setDefaultSessionName('goutte2');

// call getSession without argument will always return default session if has one (goutte2 here)
$mink->getSession()->getPage()->findLink('Downloads')->click();
echo $mink->getSession()->getPage()->getContent();

// run in javascript (Sahi) session
$mink->getSession('javascript')->getPage()->findLink('Downloads')->click();
echo $mink->getSession('javascript')->getPage()->getContent();

// run in custom session
$mink->getSession('custom')->getPage()->findLink('Downloads')->click();
echo $mink->getSession('custom')->getPage()->getContent();

// mix sessions
$mink->getSession('goutte1')->getPage()->findLink('Chat')->click();
$mink->getSession('goutte2')->getPage()->findLink('Chat')->click();

Install Dependencies

curl http://getcomposer.org/installer | php
php composer.phar install

How to run Mink test suite

  1. Install dependencies (including Sahi and Selenium)

    bin/install_deps
    bin/install_sahi
    bin/install_selenium
    
  2. To run all tests - call bin/run_all_tests

If you want to run specific driver tests, use appropriate PHPUnit group and make sure that Sahi/Selenium is runned if you want to test one of them:

bin/start_sahi
phpunit --group sahidriver
bin/kill_sahi
bin/start_selenium
phpunit --group seleniumdriver
bin/kill_selenium

Zombie and Goutte driver tests doesn't require some specific proxy to be runned and could be tested as is:

phpunit --group zombiedriver
phpunit --group gouttedriver

Behat integration and translated languages

Behat integration altogether with translations have moved into separate project called MinkExtension. It's an extension to Behat 2.4. This will lead to much faster release cycles as MinkExtension doesn't have actual releases - any accepted PR about language translation or new step definitions will immediately go into live.

Copyright

Copyright (c) 2011 Konstantin Kudryashov (ever.zet). See LICENSE for details.

Contributors

  • Konstantin Kudryashov everzet [lead developer]
  • Pascal Cremer b00giZm [ZombieDriver creator]
  • Alexandre Salomé alexandresalome [SeleniumDriver creator]
  • Pete Otaqui pete-otaqui [Selenium2Driver creator]

Sponsors

Something went wrong with that request. Please try again.