This is an old revision of the document!

run-tests.php command line options and environment variables options

Short Options

Cmd line	ENV var	Function	Required in the re-write?	implemented
h		help	yes	yes
p	PHP_TEST_EXECUTABLE	Specifies PHP executable to be tested	yes	yes
v		Writes the PHP command that's passed to proc_open(), and ...	NO (see below)
q	NO_INTERACTION	Suppress option to send results to QA? Only ever relevant if run using 'make test' I think	yes
x	SKIP_SLOW_TESTS	Skip slow tests	NO
w <file>		Write a list of all failed tests to <file>.	NO
a <file>		Same as -w but append rather then truncating <file>	NO
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	Yes
m		Test for memory leaks with Valgrind	Yes (See additional requirement from Nuno)	yes
s <file>		Write output to <file>	yes	yes
l <file>		Read lists of tests to be executed from <file>, write failed tests back to same file	NO
r <file>		Read lists of tests to be executed from <file>	NO

Cmd line	Function	Required in the re-write?
html <file>	Write HTML summary output to file	NO (replaced by output-type)
temp-source <sdir> temp-target <tdir> [temp-urlbase <url>]	Write temporary files to <tdir> by replacing <sdir> from the filenames to generate with <tdir>...	NO
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	NO
show-(all, php...)	Show 'all' files, 'php' test file ... etc	NO
no-clean	Don't execute the CLEAN section	yes
verbose	Writes the PHP command that's passed to proc_open(), and...	NO (see below)

Cmd line	Function	implemented
o <list,csv,xml,html>	Specifies the output-type	yes
z <nproc>	Run in parallel, forks <nproc> processes.	yes
v	verbose-mode level 1	yes
vv	verbose-mode level 2	yes
vvv	verbose-mode level 3	yes

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)