Download the PHP package lucatume/wp-browser without Composer
On this page you can find all versions of the php package lucatume/wp-browser. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download lucatume/wp-browser
More information about lucatume/wp-browser
Files in lucatume/wp-browser
Package wp-browser
Short Description A set of Codeception modules to test WordPress projects.
License MIT
Homepage https://github.com/lucatume/wp-browser
Informations about the package wp-browser
wp-browser
You can use wp-browser to test WordPress sites, plugins and themes.
An easy and quick setup, with a default configuration that will work for most projects, run end-to-end tests, integration tests and unit tests all with the same tool.
This document refers to version
4
of the project. If you're using version3
or version3.5
, and are looking for the migration and troubleshooting guide, you can find it here
Requirements
Depending on the nature of your project, there are different requirements it will need to satisfy before getting started.
Site
- Ensure you're running the
vendor/bin/codecept init wpbrowser
command from the root directory of your WordPress site. - Ensure the directory contains the WordPress installation files. In a standard scenario you should have extracted WordPress files in this directory.
- Ensure your installation is configured: it should contain a
wp-config.php
file.
Plugin
- Ensure you're running the
vendor/bin/codecept init wpbrowser
command from the root directory of your plugin; this should be the directory that contains the PHP file defining the plugin header.
Theme
- Ensure you're running the
vendor/bin/codecept init wpbrowser
command from the root directory of your theme; this should be the directory that contains thestyle.css
file defining [the theme header][7].
If you decide to use the quick installation, then your PHP version should have the sqlite3
extensions installed and activated. You can check this using the php -m
command and verifying the sqlite3
extension is among the active extensions.
Installation
Add wp-browser to your project as a development dependency using Composer
Initialize wp-browser to quickly configured to suite your project and setup:
The command will set up your project to run integration and end-to-end tests using:
- SQLite as the database engine, leveraging the SQLite Database Integration plugin
- PHP built-in web server to serve the WordPress site on localhost (e.g.
http://localhost:8080
) - Chromedriver to drive the local version of Chrome installed on your machine
If you're working on a plugin or theme project, the default configuration will add some extra steps:
- install the latest version of WordPress in the
tests/_wordpress
directory - create a
tests/_plugins
directory: any file or directory in this directory will be symlinked into the WordPress installation intests/_wordpress/wp-content/plugins
- create a
tests/_themes
directory: any file or directory in this directory will be symlinked into the WordPress installation intests/_wordpress/wp-content/themes
For most projects this configuration will be enough to get started with testing.
You can run your tests immediately using the vendor/bin/codecept run
command.
Read more about the commands provided by the library here.
Using a custom configuration
If you decide to skip the default configuration, you will be able to set up wp-browser
to suit your needs and local
setup by editing the tests/.env
file.
The inline documentation in the file will guide you through the configuration process.
Read more about using a custom configuration here.
Getting support for wp-browser configuration and usage
The best place to get support for wp-browser is the project documentation.
Since this project builds on top of PHPUnit and Codeception, you can also refer to their documentation.
If you can't find the answer to your question here you can ask on the "Issues" section of the wp-browser repository taking care to provide as much information as possible.
Finally, you can contact me directly to set up a call to discuss your project needs and how wp-browser can help you.
Sponsors
A thanks to my sponsors: you make maintaining this project easier.
All versions of wp-browser with dependencies
ext-pdo Version *
ext-mysqli Version *
ext-fileinfo Version *
ext-json Version *
ext-curl Version *
ext-zip Version *
composer-runtime-api Version ^2.2
phpunit/phpunit Version <=12.0.0
codeception/codeception Version ^5.0
codeception/module-asserts Version ^2.0 || ^3.0
codeception/module-phpbrowser Version ^2.0 || ^3.0
codeception/module-webdriver Version ^2.0 || ^3.0 || ^4.0
codeception/module-db Version ^2.0 || ^3.0
codeception/module-filesystem Version ^2.0 || ^3.0
codeception/module-cli Version ^2.0 || ^3.0
symfony/process Version >=4.4.24 <7.0
symfony/filesystem Version >=4.4.24 <7.0
vlucas/phpdotenv Version ^5.0
druidfi/mysqldump-php Version ^1.1