docksal/behat

Behat Docker镜像

一个无需外部依赖即可运行Behat的独立Docker镜像。该镜像属于Docksal项目的一部分。

核心功能和特性

• PHP7、Composer
• Behat 3.x
• DrupalExtension 3.x

使用方法

将此镜像当作二进制文件使用。工作目录需挂载到容器内的/src目录。

bash
$ docker run --rm -v $(pwd):/src docksal/behat --version
behat version 3.1.0

为方便使用，可在.bashrc、.zshrc等文件中添加shell别名：

bash
alias behat='docker run --rm -v $(pwd):/src docksal/behat --colors "$@"'

重启shell或打开新shell后即可直接使用：

bash
$ behat --version
behat version 3.1.0

示例设置

示例设置和测试可在example文件夹中找到。包含以下特性：

• 示例测试
• 无头Selenium Chrome/Firefox支持
• HTML报告

使用示例设置

bash
git clone https://github.com/docksal/behat.git docksal-behat
cd docksal-behat/example
./run-behat features/blackbox.feature

Behat与Selenium

若要运行需要真实浏览器的Behat测试（如JavaScript支持），可使用无头Selenium Chrome/Firefox。示例文件夹中提供了Docker Compose配置，可快速搭建Selenium Chrome环境：

bash
cd example
docker-compose up -d
./run-behat features/blackbox-javascript.feature

切换Chrome和Firefox

1. 在docker-compose.yml中取消相应行的注释：

   yaml
   # 选择/取消注释其中一项
   image: selenium/standalone-chrome
   #image: selenium/standalone-firefox
   

2. 更新容器配置：

   bash
   docker-compose up -d
   

3. 根据需要更新behat.yml：

   Chrome配置：

   yaml
   browser_name: chrome
   selenium2:
     wd_host: http://browser:4444/wd/hub
     capabilities: { "browser": "chrome", "version": "*" }
   

   Firefox配置：

   yaml
   browser_name: firefox
   selenium2:
     wd_host: http://browser:4444/wd/hub
     capabilities: { "browser": "firefox", "version": "*" }
   

4. 运行测试

HTML报告

HTML报告会生成到html_report文件夹中。可通过浏览器访问http://<你的Docker主机IP>:8000/html_report查看（将<你的Docker主机IP>替换为实际IP，如localhost）。

调试

使用以下命令可在容器中启动bash会话：

bash
docker run --rm -v $(pwd):/src -it --entrypoint=bash docksal/behat