1
1
[IMPORTANT NOTICE]
2
2
------------------
3
3
This is an addendum to README.TESTING with additional information
4
- specific to run-tests2 .php.
4
+ specific to server-tests .php.
5
5
6
- run-tests2 .php is backward compatible with tests developed for
7
- the original run-tests.php script. run-tests2 is *not* used by
8
- 'make test'. run-tests2 was developed to provide support for
6
+ server-tests .php is backward compatible with tests developed for
7
+ the original run-tests.php script. server-tests is *not* used by
8
+ 'make test'. server-tests was developed to provide support for
9
9
testing PHP under it's primary environment, HTTP, and can run the
10
10
PHP tests under any of the SAPI modules that are direct executables,
11
11
or are accessable via HTTP.
12
12
13
13
[New features]
14
14
----------------
15
15
* Command line interface:
16
- You can run 'php run-tests2 .php -h' to get all the possible options.
16
+ You can run 'php server-tests .php -h' to get all the possible options.
17
17
* Configuration file:
18
18
the -c argument will allow you to use a configuration file. This is
19
19
handy if you are testing multiple environments and need various options
20
20
depending on the environment.
21
- see run -tests-config.php for details.
21
+ see server -tests-config.php for details.
22
22
* CGI Emulation:
23
23
Will emulate a CGI environment when testing with the cgi sapi executable.
24
24
* HTTP testing:
@@ -39,31 +39,31 @@ make testing work.
39
39
Some (but not all!) examples of usage:
40
40
41
41
1. run tests from the php source directory
42
- php run-tests2 .php -p /path/to/php-cli
42
+ php server-tests .php -p /path/to/php-cli
43
43
44
44
2. run tests using cgi emulation
45
- php run-tests2 .php -p /path/to/php-cgi
45
+ php server-tests .php -p /path/to/php-cgi
46
46
47
47
3. run tests over http, copying test files into document root
48
- php run-tests2 .php -w -u http://localhost/test -m /path/to/htdocs/test
48
+ php server-tests .php -w -u http://localhost/test -m /path/to/htdocs/test
49
49
50
50
4. run tests over http, php sources have been aliased in web server
51
- php run-tests2 .php -w -u http://localhost/test
51
+ php server-tests .php -w -u http://localhost/test
52
52
53
53
5. run tests using configuration file
54
- php run-tests2 .php -c /path/to/run -tests-config.php
54
+ php server-tests .php -c /path/to/server -tests-config.php
55
55
56
56
6. run tests using configuration file, but overriding some settings:
57
57
(config file must be first)
58
- php run-tests2 .php -c /path/to/run -tests-config.php -w -t 3 -d /path/to/testdir
58
+ php server-tests .php -c /path/to/server -tests-config.php -w -t 3 -d /path/to/testdir
59
59
60
60
NOTE: configuration as described in README.TESTING still works.
61
61
62
62
[New Test Sections]
63
63
----------------
64
64
In addition to the traditional test sections
65
65
(see http://qa.php.net/write-test.php), several new sections are available
66
- under run-tests2 .
66
+ under server-tests .
67
67
68
68
--POST--
69
69
This is not a new section, but not multipart posts are supported for testing
@@ -97,7 +97,7 @@ include:
97
97
$scriptname this is what will become SCRIPT_NAME unless you override it
98
98
$docroot the equivelant of DOCUMENT_ROOT under Apache
99
99
$cwd the directory that the test is being initiated from
100
- $this->conf all run-tests2 configuration vars
100
+ $this->conf all server-tests configuration vars
101
101
$this->env all environment variables that will get passed to the test
102
102
103
103
0 commit comments