Mink

The main website with documentation is at http://mink.behat.org
Official user group is at Google Groups

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(
    '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

wget http://getcomposer.org/composer.phar
php composer.phar install

How to run Mink test suite

Install dependencies (including Sahi and Selenium)

bin/install_deps
bin/install_sahi
bin/install_selenium

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

Translated languages

For now exists 6 translated language: es,fr,ja,nl,pt,ru.

Note: The es and fr are outdated.

How to add a new translated language?

If you want to translate another language, you can use as reference the ru language file under translations folder.

Then add it in MinkContext after line #657.

Important: The filename must match with the same translated language file in Behat and Gherkin in order to work correctly. If the language does not exist in Gherkin and Behat you must add it there too.

Copyright

Contributors

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

asm89/Mink