#Installation

Note: Pest requires PHP 8.4+ to run.

Installing the Pest PHP testing framework is a simple process you may complete in a few steps. Before you begin, make sure you have PHP 8.4+ installed on your system.

First, require Pest as a "dev" dependency in your project by running the following commands on your command line:

1composer remove phpunit/phpunit
2composer require pestphp/pest --dev --with-all-dependencies

Next, you will need to initialize Pest in your current PHP project. This step will create a configuration file named Pest.php at the root level of your test suite, allowing you to fine-tune your test suite later:

1./vendor/bin/pest --init

Finally, you may run your tests by executing the ./vendor/bin/pest command:

1./vendor/bin/pest

Here is an example of the output displayed when running Pest in a fresh project:

If you are planning on using browser testing, you may install the pest-plugin-browser package to get started with browser testing in Pest. For more information, check out the Browser Testing documentation.

Optionally, if you are migrating from PHPUnit, you may use the pest-plugin-drift package to automatically convert your PHPUnit tests to Pest. For more information, check out the Migrating from PHPUnit guide.

After the installation process is finished, you may enhance your developer experience while working with Pest by configuring your editor: Editor Setup →. If you are migrating from PHPUnit, check out the Migration Guide →.