SymfonyChinaSF中国 SFC
4.2翻译中 Symfony 4.2版技术博客翻译中 本月内将对Symfony 4.2技术博客翻译完毕
注册/登录
  1. Home
  2. 中文文档
  3. 组件
  4. BrowserKit组件

BrowserKit组件

3.4 版本
维护中的版本
4.2 master 2.8 LTS

BrowserKit组件模拟浏览器行为，让你能够程序化地制造请求、对链接的点击以及表单提交。

安装 

你可以通过下述两种方式安装：

然后，包容vendor/autoload.php文件，以开启Composer提供的自动加载机制。否则，你的程序将无法找到这个Symfony组件的类。

基本用法 

创建Client 

本组件只提供抽象的client，并不提供任何可以用于HTTP层的后端。

要创建你自己的客户端，必须继承 Client 抽象类，然后实现其 doRequest() 方法。该方法接收一个请求并返回一个响应:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

namespace Acme;
 
use Symfony\Component\BrowserKit\Client as BaseClient;
use Symfony\Component\BrowserKit\Response;
 
class Client extends BaseClient
{
    protected function doRequest($request)
    {
        // ... convert request into a response
        // ... 把请求转换为响应
 
        return new Response($content, $status, $headers);
    }
}

基于HTTP layer的一个简单的client实现，可以看看 Goutte。基于 HttpKernelInterface 的实现，看一下由 HttpKernel组件 提供的 Client。

制造请求 

使用 request() 来制造HTTP requests。前两个参数分别是HTTP method和请求的URL:

1
2
3
4

use Acme\Client;
 
$client = new Client();
$crawler = $client->request('GET', 'http://symfony.com');

由 request() 方法返回的值，是一个 Crawler 类的实例，这个实例来自 DomCrawler组件，该组件能够程式化地访问和遍历HTML元素。

点击链接 

Crawler 对象有能力模拟对链接的点击。首先，把链接的文本传入 selectLink() 方法，该方法返回一个 Link 对象。然后再把这个对象传入 click() 方法, 该方法负责把所需的HTTP GET请求模拟成链接点击:

1
2
3
4
5
6

use Acme\Client;
 
$client = new Client();
$crawler = $client->request('GET', 'http://symfony.com');
$link = $crawler->selectLink('Go elsewhere...')->link();
$client->click($link);

提交表单 

Crawler 对象有能力选择表单。首先，用 selectButton() 方法来选择任意表单的按钮。然后，使用 form() 来选择该按钮的归属表单。

选择了表单之后，填充表单数据，并使用 submit() 方法(利用所需的HTTP POST请求来提交表单内容) 来发送表单:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

use Acme\Client;
 
// make a real request to an external site
// 制造一个对外部网站的真实请求
$client = new Client();
$crawler = $client->request('GET', 'https://github.com/login');
 
// select the form and fill in some values
// 选取表单，并填充一些值
$form = $crawler->selectButton('Log in')->form();
$form['login'] = 'symfonyfan';
$form['password'] = 'anypass';
 
// submit that form
// 提交此表单
$crawler = $client->submit($form);

Cookies 

取出Cookie 

The Client implementation exposes cookies (if any) through a CookieJar, which allows you to store and retrieve any cookie while making requests with the client:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

use Acme\Client;
 
// Make a request
// 制造一个请求
$client = new Client();
$crawler = $client->request('GET', 'http://symfony.com');
 
// Get the cookie Jar
// 取得饼干罐对象
$cookieJar = $client->getCookieJar();
 
// Get a cookie by name
// 根据cookie名称取得cookie
$cookie = $cookieJar->get('name_of_the_cookie');
 
// Get cookie data
// 取得cookie数据
$name       = $cookie->getName();
$value      = $cookie->getValue();
$raw        = $cookie->getRawValue();
$secure     = $cookie->isSecure();
$isHttpOnly = $cookie->isHttpOnly();
$isExpired  = $cookie->isExpired();
$expires    = $cookie->getExpiresTime();
$path       = $cookie->getPath();
$domain     = $cookie->getDomain();

这些方法只返回尚未过期的cookie。

循环Cookie 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

use Acme\Client;
 
// Make a request
// 制造一个请求
$client = new Client();
$crawler = $client->request('GET', 'http://symfony.com');
 
// Get the cookie Jar
// 取得饼干罐对象
$cookieJar = $client->getCookieJar();
 
// Get array with all cookies
// 取得全部cookie的数组
$cookies = $cookieJar->all();
foreach ($cookies as $cookie) {
    // ...
}
 
// Get all values
// 获取全部cookie的值
$values = $cookieJar->allValues('http://symfony.com');
foreach ($values as $value) {
    // ...
}
 
// Get all raw values
// 获取全部原生的值
$rawValues = $cookieJar->allRawValues('http://symfony.com');
foreach ($rawValues as $rawValue) {
    // ...
}

设置Cookie 

你也可以创建cookie并把它们装到cookie Jar中，以便将饼干罐注入到客户端的构造器中：

1
2
3
4
5
6
7
8
9

use Acme\Client;
 
// create cookies and add to cookie jar
// 创建cookie并添加到cookie Jar
$cookieJar = new Cookie('flavor', 'chocolate', strtotime('+1 day'));
 
// create a client and set the cookies
// 创建client并设置cookie
$client = new Client(array(), array(), $cookieJar);

历史 

客户端存有你的全部请求，允许你在历史记录中回退和前进：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

use Acme\Client;
 
// make a real request to an external site
// 制造一个对外部网站的真实请求
$client = new Client();
$client->request('GET', 'http://symfony.com');
 
// select and click on a link
// 选中并点击一个链接
$link = $crawler->selectLink('Documentation')->link();
$client->click($link);
 
// go back to home page
// 退回首页
$crawler = $client->back();
 
// go forward to documentation page
// 前进到文档页
$crawler = $client->forward();

使用 restart() 可以删除客户端的历史记录。它同时会删除全部cookies：

1
2
3
4
5
6
7
8
9
10

use Acme\Client;
 
// make a real request to an external site
// 制造一个对外部网站的真实请求
$client = new Client();
$client->request('GET', 'http://symfony.com');
 
// delete history
// 删除历史记录
$client->restart();

本文，包括例程代码在内，采用的是 Creative Commons BY-SA 3.0 创作共用授权。

登录symfonychina 发表评论或留下问题（我们会尽量回复）