README

您可以使用wp-browser来测试WordPress网站、插件和主题。

简单快捷的设置，默认配置适用于大多数项目，使用相同的工具运行端到端测试、集成测试和单元测试。

本文档针对项目的第4版。如果您使用的是第3版或第3.5版，并正在寻找迁移和故障排除指南，您可以在这里找到

需求

根据您项目的性质，在开始之前需要满足不同的需求。

网站

• 确保您从WordPress网站的根目录运行vendor/bin/codecept init wpbrowser命令。
• 确保目录包含WordPress安装文件。在标准情况下，您应该已经将WordPress文件解压到该目录中。
• 确保您的安装已配置：它应该包含一个wp-config.php文件。

插件

• 确保您从插件的根目录运行vendor/bin/codecept init wpbrowser命令；这应该是包含定义插件头的PHP文件的目录。

主题

• 确保您从主题的根目录运行vendor/bin/codecept init wpbrowser命令；这应该是包含定义[主题头][7]的style.css文件的目录。

如果您决定使用快速安装，那么您的PHP版本应该已安装并激活了sqlite3扩展。您可以使用php -m命令检查并验证sqlite3扩展是否在活动扩展中。

安装

使用Composer将wp-browser添加到您的项目作为开发依赖项。

cd my-wordrpess-project
composer require --dev lucatume/wp-browser

初始化wp-browser以快速配置以适应您的项目和设置

vendor/bin/codecept init wpbrowser

该命令将设置您的项目，以便使用以下工具运行集成和端到端测试：

• SQLite作为数据库引擎，利用SQLite数据库集成插件
• PHP内置的Web服务器在本地主机上（例如http://localhost:8080）提供WordPress站点
• Chromedriver来驱动您机器上安装的本地Chrome版本

如果您正在处理插件或主题项目，默认配置将添加一些额外步骤：

• 在tests/_wordpress目录中安装最新版本的WordPress
• 创建一个tests/_plugins目录：此目录中的任何文件或目录都将链接到tests/_wordpress/wp-content/plugins中的WordPress安装
• 创建一个tests/_themes目录：此目录中的任何文件或目录都将链接到tests/_wordpress/wp-content/themes中的WordPress安装

对于大多数项目，此配置将足以开始测试。

您可以使用vendor/bin/codecept run命令立即运行您的测试。

在这里了解更多关于库中提供命令的信息。

使用自定义配置

如果您决定跳过默认配置，您可以通过编辑 tests/.env 文件来设置 wp-browser 以满足您的需求和本地设置。文件中的内联文档将引导您完成配置过程。

在这里了解更多关于使用自定义配置的信息。

获取 wp-browser 配置和使用的支持

获取 wp-browser 支持的最佳地方是项目文档。
由于该项目基于 PHPUnit 和 Codeception 构建，您也可以参考它们的文档。

如果您在这里找不到您问题的答案，您可以在 wp-browser 存储库的“问题”部分 中提问，并尽量提供尽可能多的信息。

最后，您可以直接联系我，安排电话讨论您的项目需求以及 wp-browser 如何帮助您。

赞助商

感谢我的赞助商：您让维护这个项目变得更容易。