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:  by 127.0.0.1