Blackfire Player 镜像文档

镜像概述

Blackfire Player 是一款功能强大的 Web 爬取、Web 测试和 Web 抓取工具。它提供简洁的 DSL（领域特定语言），用于爬取 HTTP 服务、断言响应内容以及从 HTML/XML/JSON 响应中提取数据，帮助开发者高效完成 Web 相关的自动化任务。

核心功能与特性

• 多用途 Web 工具：集成 Web 爬取、测试与抓取能力，满足多样化 Web 自动化需求
• 灵活 DSL 支持：提供专门的领域特定语言，简化 HTTP 服务爬取、响应断言及数据提取逻辑
• 多格式数据处理：支持从 HTML、XML、JSON 等多种响应格式中提取所需数据
• Blackfire Profiler 集成：原生支持 Blackfire Profiler，可从 HTTP 层进行代码行为测试（即“HTTP 层单元测试”）

使用场景与适用范围

Blackfire Player 适用于以下场景：

• 验收测试：爬取网站或 API 并验证预期结果
• 数据抓取：从网站或 API 中抓取并提取特定数据值
• 网站监控：定期检查网站可用性及响应状态
• 测试集成：与单元测试框架（如 PHPUnit、Behat、Codeception 等）集成，扩展测试能力
• 性能分析：通过 Blackfire Profiler 集成，在 HTTP 层分析代码行为与性能

使用方法与配置说明

基本信息

• 容器工作目录：容器内默认工作目录为 /app，需将本地目录挂载至此以访问场景文件
• 镜像名称：blackfire/player

环境变量配置

使用 Blackfire Profiler 集成时，需配置以下环境变量（从主机传递至容器）：

• BLACKFIRE_CLIENT_ID：Blackfire 客户端 ID
• BLACKFIRE_CLIENT_TOKEN：Blackfire 客户端令牌

快速使用示例

运行场景文件

执行本地 my-scenario.bkf 场景文件：

bash
docker run --rm -it \
  -e BLACKFIRE_CLIENT_ID \
  -e BLACKFIRE_CLIENT_TOKEN \
  -v "$(pwd):/app" \
  blackfire/player run my-scenario.bkf

设置 Shell 别名（推荐）

为简化命令，可在 .bashrc、.zshrc 等配置文件中添加别名：

bash
alias blackfire-player='docker run --rm -it -e BLACKFIRE_CLIENT_ID -e BLACKFIRE_CLIENT_TOKEN -v "$(pwd):/app" blackfire/player'

保存后，通过 source ~/.bashrc（或对应配置文件）使别名生效。此后可直接使用 blackfire-player 命令，如同操作本地二进制文件：

bash
# 查看版本
blackfire-player --version

# 列出可用命令
blackfire-player list

# 运行场景文件
blackfire-player run my-scenario.bkf

注意事项

• 若无需使用 Blackfire Profiler 集成，可省略 BLACKFIRE_CLIENT_ID 和 BLACKFIRE_CLIENT_TOKEN 环境变量
• 挂载本地目录时，确保当前用户对挂载目录有读写权限，避免权限问题导致场景文件无法访问

更多关于 Blackfire Player 的详细使用方法，请参考 ***文档。