====== run-tests.php configuration options ======

===== Short Options =====


^ Cmd line ^ ENV var ^ Function ^ Required in the re-write? ^
| p | PHP_TEST_EXECUTABLE | Specifies PHP executable to be tested | yes |
| v |                     | Writes the PHP command that's passed to proc_open(), and ... | Yes |
| q | NO_INTERACTION                  | Suppress option to send results to QA? Only ever relevant if run using 'make test' I think   |  |
| x | SKIP_SLOW_TESTS                | Skip slow tests |  |
| w <file> |                | Write a list of all failed tests to <file>. | |
| a <file> |                | Same as -w but append rather then truncating <file> | |
| c |                         | Look for php.ini in directory <file> or use <file> as ini | Yes | 
| n |                        | Pass -n option to the php binary (Do not use a php.ini) | Yes |
| d foo=bar | | Pass -d foo=bar option to the php binary | |
| m          |               | Test for memory leaks with Valgrind | Yes (See additional requirement from Nuno)|
| s <file> |                 | Write output to <file> | |
| l <file>|                         | Read lists of tests to be executed from <file>, write failed tests back to same file | |
| r <file> | | Read lists of tests to be executed from <file> | |

===== Long options =====

^ Cmd line ^ ENV var ^ Function ^ Required in the re-write? ^
| html <file> |  | Write HTML summary output to file | |
|temp-source <sdir>  temp-target <tdir> [temp-urlbase <url>] | | Write temporary files to <tdir> by replacing <sdir> from the filenames to generate with <tdir>. If --html is being used and     <url> given then the generated links are relative and prefixed with the given url. In general you want to make <sdir> the path to your source files and <tdir> some pach in your web page         hierarchy with <url> pointing to <tdir> | |
| keep-(all,php...) | | Do not delete 'all' files, 'php' test file, 'skip' or 'clean' file. |Yes (all, Nuno for gcov etc) |
| set-timeout n | | Set timeout for individual tests. n is seconds | |
| show-(all, php...) | | Show 'all' files, 'php' test file ... etc | |
| no-clean | | Don't execute the CLEAN section | | 
| verbose | | Writes the PHP command that's passed to proc_open(), and … |  |  

===== Environment variables =====
^ var name ^ Cmd line ^ Meaning ^ Required in the re-write^
| TEST_PHP_EXECUTABLE | p | PHP executable to test | Yes |
| TEST_PHP_CGI_EXECUTABLE | | PHP CGI executable to test | Yes |
|TEST_PHP_LOG_FORMAT | | Sets log format, defaults to LEOD (log, out, exp diff files are created) | |
| TEST_PHP_DETAILED | v/verbose | Writes the PHP command that's passed to proc_open(), and ... | |
| TEST_PHP_USER | | List of directories to be run | |
| NO_INTERACTION | q | Suppress option to send results to QA? Only ever relevant if run using 'make test' I think | |
| PHP_AUTOCONF | | ? *ix only | |
| TEST_PHP_ERROR_STYLE | | Strange logic, this is only ever used on failure to write log file. I don't think it can ever work | |
| NO_PHPTEST_SUMMARY | | Suppress listing of failed tests | |
| CC | | | |
| TEST_PHP_ARGS | | Command line arguments to run-tests.php |Yes (Nuno - for make test) |