Behat结合Facebook/WebDriver实现页面对象模型配置求助

我太懂这种从Java/TestNG的舒适区跳到PHP/Behat的迷茫了——页面对象模型的核心思路没变，但工具链的配置确实得换个玩法。既然你不想用Mink的selenium2driver，只想纯靠facebook/webdriver搭页面对象，那咱们一步步来：

首先用Composer把需要的包拉进来，Behat核心、facebook/webdriver，再加个PHPUnit做断言（毕竟你之前用TestNG，断言逻辑熟）：

composer require --dev behat/behat facebook/webdriver phpunit/phpunit

打开你的behat.yml，不需要任何Mink相关的扩展配置，只需要指定Feature文件路径和上下文类就行：

default:
  suites:
    default:
      paths:
        - %paths.base%/features
      contexts:
        - FeatureContext

然后在features/bootstrap/FeatureContext.php里初始化WebDriver，用Behat的钩子方法来管理驱动的生命周期：

use Facebook\WebDriver\Remote\RemoteWebDriver;
use Facebook\WebDriver\Remote\DesiredCapabilities;
use Behat\Behat\Context\Context;

class FeatureContext implements Context
{
    protected $driver;

    /** @BeforeScenario */
    public function setUp()
    {
        // 连接本地Selenium Server，默认地址是http://localhost:4444/wd/hub
        // 如果用ChromeDriver直接启动，地址改成http://localhost:9515就行
        $this->driver = RemoteWebDriver::create(
            'http://localhost:4444/wd/hub',
            DesiredCapabilities::chrome()
        );
    }

    /** @AfterScenario */
    public function tearDown()
    {
        $this->driver->quit();
    }
}

创建一个tests/PageObjects目录（或者你喜欢的路径），给每个页面写独立的类，比如登录页：

namespace PageObjects;

use Facebook\WebDriver\WebDriverBy;
use Facebook\WebDriver\Remote\RemoteWebDriver;

class LoginPage
{
    protected $driver;

    // 把元素定位器都定义成常量，方便维护
    const USERNAME_INPUT = WebDriverBy::id('username');
    const PASSWORD_INPUT = WebDriverBy::id('password');
    const SUBMIT_BTN = WebDriverBy::cssSelector('button[type="submit"]');

    public function __construct(RemoteWebDriver $driver)
    {
        $this->driver = $driver;
    }

    // 页面加载方法，返回自身支持链式调用
    public function load(): self
    {
        $this->driver->get('https://your-app-domain/login');
        return $this;
    }

    public function enterUsername(string $username): self
    {
        $this->driver->findElement(self::USERNAME_INPUT)->sendKeys($username);
        return $this;
    }

    public function enterPassword(string $password): self
    {
        $this->driver->findElement(self::PASSWORD_INPUT)->sendKeys($password);
        return $this;
    }

    // 提交后返回仪表盘页面对象，实现页面跳转的流畅衔接
    public function submitLogin(): DashboardPage
    {
        $this->driver->findElement(self::SUBMIT_BTN)->click();
        return new DashboardPage($this->driver);
    }
}

再写个仪表盘页面类做示例：

namespace PageObjects;

use Facebook\WebDriver\WebDriverBy;
use Facebook\WebDriver\Remote\RemoteWebDriver;

class DashboardPage
{
    protected $driver;
    const WELCOME_MSG = WebDriverBy::cssSelector('.welcome-text');

    public function __construct(RemoteWebDriver $driver)
    {
        $this->driver = $driver;
        // 构造时校验是否真的进入了仪表盘，避免后续步骤出错
        if (!$this->isPageLoaded()) {
            throw new \Exception('Failed to reach Dashboard page');
        }
    }

    public function getWelcomeMessage(): string
    {
        return $this->driver->findElement(self::WELCOME_MSG)->getText();
    }

    private function isPageLoaded(): bool
    {
        return $this->driver->wait(10)->until(
            fn($driver) => $driver->findElement(self::WELCOME_MSG)->isDisplayed()
        );
    }
}

把页面对象注入到上下文里，然后在步骤方法里用它们实现业务逻辑：

use PageObjects\LoginPage;
use PHPUnit\Framework\Assert;

class FeatureContext implements Context
{
    protected $driver;
    protected $currentPage;

    /** @BeforeScenario */
    public function setUp()
    {
        $this->driver = RemoteWebDriver::create(
            'http://localhost:4444/wd/hub',
            DesiredCapabilities::chrome()
        );
    }

    /**
     * @Given I am on the login page
     */
    public function iAmOnTheLoginPage()
    {
        $this->currentPage = (new LoginPage($this->driver))->load();
    }

    /**
     * @When I log in with username :username and password :password
     */
    public function iLogInWithCredentials(string $username, string $password)
    {
        /** @var LoginPage $loginPage */
        $this->currentPage = $loginPage->enterUsername($username)
            ->enterPassword($password)
            ->submitLogin();
    }

    /**
     * @Then I should see a welcome message saying :message
     */
    public function iShouldSeeWelcomeMessage(string $message)
    {
        /** @var DashboardPage $dashboardPage */
        $welcomeText = $dashboardPage->getWelcomeMessage();
        Assert::assertStringContainsString($message, $welcomeText);
    }

    /** @AfterScenario */
    public function tearDown()
    {
        $this->driver->quit();
    }
}

比如features/login.feature：

Feature: User Login
  As a registered user
  I want to log into the application
  So I can access my dashboard

  Scenario: Successful login with valid credentials
    Given I am on the login page
    When I log in with username "test_user" and password "test_pass123"
    Then I should see a welcome message saying "Welcome, test_user!"

• 元素等待：别用硬等待，页面对象里封装显式等待（就像DashboardPage里那样），避免因页面加载慢导致的失败。
• 命名空间：记得在composer.json里配置PSR-4自动加载，比如：

  "autoload-dev": {
      "psr-4": {
          "PageObjects\\": "tests/PageObjects/"
      }
  }
  

  然后跑composer dump-autoload生效。
• Selenium启动：确保本地Selenium Server或者ChromeDriver已经启动，比如用java -jar selenium-server-standalone-4.x.x.jar启动Selenium，或者直接跑chromedriver启动Chrome驱动。

内容的提问来源于stack exchange，提问作者HairyBarry