Skip to content

Latest commit

 

History

History
82 lines (58 loc) · 2.48 KB

index.rst

File metadata and controls

82 lines (58 loc) · 2.48 KB

Welcome to the Mink documentation!

One of the most important parts in the web is a browser. Browser is the window through which web users interact with web applications and other users. Users are always talking with web applications through browsers.

So, in order to test that our web application behaves correctly, we need a way to simulate this interaction between the browser and the web application in our tests. We need a Mink.

Mink is an open source browser controller/emulator for web applications, written in PHP 5.3.

Read :doc:`/at-a-glance` to learn more about Mink and why you need it.

Installation

Mink is a php 5.3 library that you'll use inside your test suites or project. Before you begin, ensure that you have at least PHP 5.3.1 installed.

The recommended way to install Mink with all its dependencies is through Composer:

$ composer require behat/mink

Everything will be installed inside vendor folder. Finally, include Composer autoloading script to your project:

require_once 'vendor/autoload.php';

Note

By default, Mink will be installed with no drivers. In order to be able to use additional drivers, you should install them (through composer). Require the appropriate dependencies:

  • GoutteDriver - behat/mink-goutte-driver
  • Selenium2Driver - behat/mink-selenium2-driver
  • BrowserKitDriver - behat/mink-browserkit-driver
  • ZombieDriver - behat/mink-zombie-driver
  • SeleniumDriver - behat/mink-selenium-driver
  • SahiDriver - behat/mink-sahi-driver
  • WUnitDriver - behat/mink-wunit-driver

If you're newcomer or just don't know what to choose, you should probably start with the GoutteDriver and the Selenium2Driver (you will be able to tuneup it later):

Guides

Learn Mink with the topical guides:

.. toctree::
    :maxdepth: 1

    at-a-glance
    guides/session
    guides/traversing-pages
    guides/manipulating-pages
    guides/drivers
    guides/managing-sessions

Testing Tools Integration

Mink has integrations for several testing tools: