summaryrefslogtreecommitdiff
path: root/README.TESTING
diff options
context:
space:
mode:
authorYasuo Ohgaki <yohgaki@php.net>2002-03-12 09:20:04 +0000
committerYasuo Ohgaki <yohgaki@php.net>2002-03-12 09:20:04 +0000
commitaba1396f11f4eb5f5ff2f4b2057db529c9bbb0a7 (patch)
tree701657a59b52c14032d51d4879a0cd9499788e2b /README.TESTING
parentf499aa1f33b9ed1989fa7b19b30f0cbd36eb2ce5 (diff)
downloadphp-git-aba1396f11f4eb5f5ff2f4b2057db529c9bbb0a7.tar.gz
Catch up with recent test scripts changes
Diffstat (limited to 'README.TESTING')
-rw-r--r--README.TESTING38
1 files changed, 20 insertions, 18 deletions
diff --git a/README.TESTING b/README.TESTING
index 85615d8aa7..7f28e55ef1 100644
--- a/README.TESTING
+++ b/README.TESTING
@@ -1,13 +1,13 @@
[IMPORTANT NOTICE]
------------------
-Do _not_ ask to developers why some or all tests are failed under
+ Do _not_ ask to developers why some or all tests are failed under
your environment! Let us know if you find why it fails. Thank you.
-[Testing Basics]
---------
-You must build CGI SAPI, then you can do "make test" to
-execute all or some test scripts saved under
+[Testing Basics]
+----------------
+ To execute test scripts, you must build PHP with some SAPI, then you
+type "make test" to execute all or some test scripts saved under
"tests" directory under source root directory.
Usage:
@@ -15,22 +15,24 @@ make test
"make test" basically executes "run-tests.php" script
under source root. Therefore you can execute the script
-like
+as follows
-./php -c php.ini-dist run-tests.php [ext/some_extension_name]
+./sapi/cli/php -c php.ini-dist run-tests.php [ext/some_extension_name]
[Which "php" executable "make test" look for]
---------------------------------------------
- "make test" executes "run-tests.php" script with "./php".
-Test scripts must be executed by CGI SAPI. Therefore, you
-must build PHP with CGI SAPI to perform tests.
+ "make test" executes "run-tests.php" script with "php" binary. Some
+test scripts such as session must be executed by CGI SAPI. Therefore,
+you must build PHP with CGI SAPI to perform all tests.
- "run-tests.php" look for "php" executable in build top directory,
-then look for search path. Therefore, if you have "php" executable
-other than CGI SAPI in your search path or source root, tests may fail.
+ If PHP is not build with CGI SAPI, "run-tests.php" script uses CLI
+SAPI. Tests that may not executed by CLI SAPI will be skipped.
+NOTE: PHP binary executing "run-tests.php" and php binary used for
+executing test scripts may differ. If you use different PHP binary for
+executing "run-tests.php" script, you may get errors.
[Which php.ini is used]
@@ -40,10 +42,10 @@ you would like to test with other configuration file, user
"run-tests.php" script.
Example:
-./php -c ./your_php.ini ext/standard
+./sapi/cli/php -c ./your_php.ini ext/standard
-If you use php.ini other than php.ini-dist, you may see more
-failed.
+If you use php.ini other than php.ini-dist, you may see more failed
+tests.
[Which test scripts are executed]
@@ -56,7 +58,7 @@ executes it.
Tester can easily executes tests selectively with as follows.
Example:
-./php -c php.ini-dist run-tests.php ext/mbstring
+./sapi/cli/php -c php.ini-dist run-tests.php ext/mbstring
[Test results]
@@ -144,7 +146,7 @@ However, it is recommended to use other files for ease of writing
test script. For instance, you can execute test script under
ext/iconv as follows:
-./php -c /etc/php.ini-dist ext/iconv
+./sapi/cli/php -c /etc/php.ini-dist ext/iconv
[How to help us]