qa:runtests:documentation:commandline

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 ... yes yes, see verbose-mode
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 yes
r <file> Read lists of tests to be executed from <file> yes

Long options

Cmd line ENV var Function Required in the re-write? implemented
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... yes yes, see verbose-mode

New options

Cmd line ENV var 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

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)
qa/runtests/documentation/commandline.txt · Last modified: 2017/09/22 13:28 (external edit)