php browserkit,BrowserKit组件

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

安装 ¶

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

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

基本用法 ¶

创建Client ¶

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

要创建你自己的客户端，必须继承 Client 抽象类，然后实现其

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15namespace 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组件 提供的

制造请求 ¶

使用

1

2

3

4use Acme\Client;

$client = new Client();

$crawler = $client->request('GET', 'http://symfony.com');

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

点击链接 ¶

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

1

2

3

4

5

6use 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

16use 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

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

26use 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

31use 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

9use 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

19use 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

10use Acme\Client;

// make a real request to an external site

// 制造一个对外部网站的真实请求

$client = new Client();

$client->request('GET', 'http://symfony.com');

// delete history

// 删除历史记录

$client->restart();