PEAR_RunTest Class Reference

Public Member Functions
	__construct ($logger=null, $options=array())
	_preparePhpBin ($php, $file, $ini_settings)
	iniString2array ($ini_string)
	run ($file, $ini_settings=array(), $test_number=1)
	runPHPUnit ($file, $ini_settings='')
	settings2array ($settings, $ini_settings)
	settings2params ($ini_settings)
	system_with_timeout ($commandline, $env=null, $stdin=null)

Data Fields
	$_headers = array()
	$_logger
	$_options
	$_php
	$_savephp
	$ini_overwrites
	$tests_count
	$xdebug_loaded

Detailed Description

Definition at line 44 of file RunTest.php.

Constructor & Destructor Documentation

__construct()

__construct	(		$logger = null,
			$options = array() )

An object that supports the PEAR_Common->log() signature, or null

Parameters

PEAR_Common|null

Definition at line 82 of file RunTest.php.

    {
        if (!defined('E_DEPRECATED')) {
            define('E_DEPRECATED', 0);
        }
        if (!defined('E_STRICT')) {
            define('E_STRICT', 0);
        }
        $excluded_error_reporting = E_DEPRECATED;
        if (!defined('PHP_VERSION_ID') || PHP_VERSION_ID < 80400) {
            $excluded_error_reporting |= E_STRICT;
        }
        $this->ini_overwrites[] = 'error_reporting=' . (E_ALL & ~$excluded_error_reporting);
        if (!defined('PHP_VERSION_ID') || PHP_VERSION_ID < 80500) {
            $this->ini_overwrites[] = 'report_memleaks=0';
        }
        if (is_null($logger)) {
            require_once 'PEAR/Common.php';
            $logger = new PEAR_Common;
        }
        $this->_logger  = $logger;
        $this->_options = $options;
 
        $conf = &PEAR_Config::singleton();
        $this->_php = $conf->get('php_bin');
    }

References $options.

Member Function Documentation

_preparePhpBin()

_preparePhpBin	(		$php,
			$file,
			$ini_settings )

Definition at line 226 of file RunTest.php.

    {
        $file = escapeshellarg($file);
        $cmd = $php . $ini_settings . ' -f ' . $file;
 
        return $cmd;
    }

Referenced by run(), and runPHPUnit().

Here is the caller graph for this function:

iniString2array()

iniString2array

(

$ini_string

)

Turns a PHP INI string into an array

Turns -d "include_path=/foo/bar" into this: array( 'include_path' => array( 'operator' => '-d', 'value' => '/foo/bar', ) ) Works both with quotes and without

Parameters

string

an PHP INI string, -d "include_path=/foo/bar"

Returns

array

Definition at line 184 of file RunTest.php.

    {
        if (!$ini_string) {
            return array();
        }
        $split = preg_split('/[\s]|=/', $ini_string, -1, PREG_SPLIT_NO_EMPTY);
        $key   = $split[1][0] == '"'                     ? substr($split[1], 1)     : $split[1];
        $value = $split[2][strlen($split[2]) - 1] == '"' ? substr($split[2], 0, -1) : $split[2];
        // FIXME review if this is really the struct to go with
        $array = array($key => array('operator' => $split[0], 'value' => $value));
        return $array;
    }

Referenced by run().

Here is the caller graph for this function:

run()

run	(		$file,
			$ini_settings = array(),
			$test_number = 1 )

Runs an individual test case.

Parameters

string	The filename of the test
array|string	INI settings to be applied to the test run
integer	Number what the current running test is of the whole test suite being runned.

Returns

string|object Returns PASSED, WARNED, FAILED depending on how the test came out. PEAR Error when the tester it self fails

Definition at line 266 of file RunTest.php.

References _cleanupOldFiles(), _preparePhpBin(), _processHeaders(), _processUpload(), _readFile(), _resetEnv(), _restorePHPBinary(), _runSkipIf(), _savePHPBinary(), _stripHeadersCGI(), _testCleanup(), _writeLog(), generate_diff(), iniString2array(), save_text(), settings2array(), settings2params(), and system_with_timeout().

Here is the call graph for this function:

runPHPUnit()

runPHPUnit	(		$file,
			$ini_settings = '' )

Definition at line 234 of file RunTest.php.

    {
        if (!file_exists($file) && file_exists(getcwd() . DIRECTORY_SEPARATOR . $file)) {
            $file = realpath(getcwd() . DIRECTORY_SEPARATOR . $file);
        } elseif (file_exists($file)) {
            $file = realpath($file);
        }
 
        $cmd = $this->_preparePhpBin($this->_php, $file, $ini_settings);
        if (isset($this->_logger)) {
            $this->_logger->log(2, 'Running command "' . $cmd . '"');
        }
 
        $savedir = getcwd(); // in case the test moves us around
        chdir(dirname($file));
        echo `$cmd`;
        chdir($savedir);
        return 'PASSED'; // we have no way of knowing this information so assume passing
    }

References _preparePhpBin().

Here is the call graph for this function:

settings2array()

settings2array	(		$settings,
			$ini_settings )

Definition at line 197 of file RunTest.php.

    {
        foreach ($settings as $setting) {
            if (strpos($setting, '=') !== false) {
                $setting = explode('=', $setting, 2);
                $name  = trim(strtolower($setting[0]));
                $value = trim($setting[1]);
                $ini_settings[$name] = $value;
            }
        }
        return $ini_settings;
    }

Referenced by run().

Here is the caller graph for this function:

settings2params()

settings2params

(

$ini_settings

)

Definition at line 210 of file RunTest.php.

    {
        $settings = '';
        foreach ($ini_settings as $name => $value) {
            if (is_array($value)) {
                $operator = $value['operator'];
                $value    = $value['value'];
            } else {
                $operator = '-d';
            }
            $value = addslashes($value);
            $settings .= " $operator \"$name=$value\"";
        }
        return $settings;
    }

Referenced by run().

Here is the caller graph for this function:

system_with_timeout()

system_with_timeout	(		$commandline,
			$env = null,
			$stdin = null )

Taken from php-src/run-tests.php

Parameters

string	$commandline	command name
array	$env
string	$stdin	standard input to pass to the command

Returns

unknown

Definition at line 117 of file RunTest.php.

    {
        $data = '';
        $proc = proc_open($commandline, array(
            0 => array('pipe', 'r'),
            1 => array('pipe', 'w'),
            2 => array('pipe', 'w')
        ), $pipes, null, $env, array('suppress_errors' => true));
 
        if (!$proc) {
            return false;
        }
 
        if (is_string($stdin)) {
            fwrite($pipes[0], $stdin);
        }
        fclose($pipes[0]);
 
        while (true) {
            /* hide errors from interrupted syscalls */
            $r = $pipes;
            unset($r[0]);
            $e = $w = [];
            $n = @stream_select($r, $w, $e, 60);
 
            if ($n === 0) {
                /* timed out */
                $data .= "\n ** ERROR: process timed out **\n";
                proc_terminate($proc);
                return array(1234567890, $data);
            } else if ($n > 0) {
                $line = fread($pipes[1], 8192);
                if (strlen($line) == 0) {
                    /* EOF */
                    break;
                }
                $data .= $line;
            }
        }
        if (function_exists('proc_get_status')) {
            $stat = proc_get_status($proc);
            if ($stat['signaled']) {
                $data .= "\nTermsig=".$stat['stopsig'];
            }
        }
        $code = proc_close($proc);
        if (function_exists('proc_get_status')) {
            $code = $stat['exitcode'];
        }
        return array($code, $data);
    }

References $proc.

Referenced by _runSkipIf(), _testCleanup(), and run().

Here is the caller graph for this function:

Field Documentation

$_headers

$_headers = array()

Definition at line 46 of file RunTest.php.

$_logger

$_logger

Definition at line 47 of file RunTest.php.

$_options

$_options

Definition at line 48 of file RunTest.php.

$_php

$_php

Definition at line 49 of file RunTest.php.

Referenced by _savePHPBinary().

$_savephp

$_savephp

Definition at line 58 of file RunTest.php.

Referenced by _restorePHPBinary().

$ini_overwrites

$ini_overwrites

Initial value:

                    = array(
    'output_handler=',
    'open_basedir=',
    'disable_functions=',
    'output_buffering=Off',
    'display_errors=1',
    'log_errors=0',
    'html_errors=0',
    'report_zend_debug=0',
    'docref_root=',
    'docref_ext=.html',
    'error_prepend_string=',
    'error_append_string=',
    'auto_prepend_file=',
    'auto_append_file=',
    'xdebug.default_enable=0',
    'allow_url_fopen=1',
)

Definition at line 59 of file RunTest.php.

$tests_count

$tests_count

Definition at line 50 of file RunTest.php.

$xdebug_loaded

$xdebug_loaded

Definition at line 51 of file RunTest.php.

---

The documentation for this class was generated from the following file:

• E:/Bearsampp-development/sandbox/core/libs/php/pear/pear/PEAR/RunTest.php