1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235
|
<?php declare(strict_types=1);
/*
* This file is part of sebastian/environment.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Environment;
use const PHP_SAPI;
use const PHP_VERSION;
use function assert;
use function extension_loaded;
use function in_array;
use function ini_get;
use function is_array;
use function xdebug_info;
use PHPUnit\Framework\Attributes\CoversClass;
use PHPUnit\Framework\Attributes\RequiresPhpExtension;
use PHPUnit\Framework\TestCase;
#[CoversClass(Runtime::class)]
final class RuntimeTest extends TestCase
{
public function testCannotCollectCodeCoverageWhenNeitherXdebugNorPcovAreAvailable(): void
{
$this->markTestSkippedWhenXdebugCanCollectCoverage();
$this->markTestSkippedWhenPcovIsLoaded();
$this->markTestSkippedWhenRunningOnPhpdbg();
$this->assertFalse((new Runtime)->canCollectCodeCoverage());
}
public function testCanCollectCodeCoverageWhenXdebugCanCollectCoverage(): void
{
$this->markTestSkippedWhenXdebugCannotCollectCoverage();
$this->markTestSkippedWhenPcovIsLoaded();
$this->markTestSkippedWhenRunningOnPhpdbg();
$this->assertTrue((new Runtime)->canCollectCodeCoverage());
}
public function testCanCollectCodeCoverageWhenPcovCanCollectCoverage(): void
{
$this->markTestSkippedWhenPcovIsNotLoaded();
$this->markTestSkippedWhenXdebugCanCollectCoverage();
$this->markTestSkippedWhenRunningOnPhpdbg();
$this->assertTrue((new Runtime)->canCollectCodeCoverage());
}
public function testCanCollectCodeCoverageWhenRunningOnPhpdbg(): void
{
$this->markTestSkippedWhenNotRunningOnPhpdbg();
$this->markTestSkippedWhenXdebugCanCollectCoverage();
$this->markTestSkippedWhenPcovIsLoaded();
$this->assertTrue((new Runtime)->canCollectCodeCoverage());
}
public function testBinaryCanBeRetrieved(): void
{
$this->assertNotEmpty((new Runtime)->getBinary());
}
public function testRawBinaryCanBeRetrieved(): void
{
$this->assertNotEmpty((new Runtime)->getRawBinary());
}
public function testIsPhpReturnsTrueWhenRunningOnPhp(): void
{
$this->markTestSkippedWhenRunningOnPhpdbg();
$this->assertTrue((new Runtime)->isPHP());
}
#[RequiresPhpExtension('pcov')]
public function testPCOVCanBeDetected(): void
{
$this->assertTrue((new Runtime)->hasPCOV());
}
public function testPhpdbgCanBeDetected(): void
{
$this->markTestSkippedWhenNotRunningOnPhpdbg();
$this->assertTrue((new Runtime)->hasPHPDBGCodeCoverage());
}
#[RequiresPhpExtension('xdebug')]
public function testXdebugCanBeDetected(): void
{
$this->markTestSkippedWhenRunningOnPhpdbg();
$this->assertTrue((new Runtime)->hasXdebug());
}
public function testNameAndVersionCanBeRetrieved(): void
{
$this->assertNotEmpty((new Runtime)->getNameWithVersion());
}
public function testGetNameReturnsPhpdbgWhenRunningOnPhpdbg(): void
{
$this->markTestSkippedWhenNotRunningOnPhpdbg();
$this->assertSame('PHPDBG', (new Runtime)->getName());
}
public function testGetNameReturnsPhpdbgWhenRunningOnPhp(): void
{
$this->markTestSkippedWhenRunningOnPhpdbg();
$this->assertSame('PHP', (new Runtime)->getName());
}
public function testNameAndCodeCoverageDriverCanBeRetrieved(): void
{
$this->assertNotEmpty((new Runtime)->getNameWithVersionAndCodeCoverageDriver());
}
public function testGetVersionReturnsPhpVersionWhenRunningPhp(): void
{
$this->assertSame(PHP_VERSION, (new Runtime)->getVersion());
}
public function testGetVendorUrlReturnsPhpDotNetWhenRunningPhp(): void
{
$this->assertSame('https://www.php.net/', (new Runtime)->getVendorUrl());
}
public function testGetCurrentSettingsReturnsEmptyDiffIfNoValuesArePassed(): void
{
$this->assertSame([], (new Runtime)->getCurrentSettings([]));
}
#[RequiresPhpExtension('xdebug')]
public function testGetCurrentSettingsReturnsCorrectDiffIfXdebugValuesArePassed(): void
{
if (ini_get('xdebug.mode') === '') {
$this->markTestSkipped('xdebug.mode must not be set to "off"');
}
$this->assertArrayHasKey('xdebug.mode', (new Runtime)->getCurrentSettings(['xdebug.mode']));
}
public function testGetCurrentSettingsWillSkipSettingsThatIsNotSet(): void
{
$this->assertSame([], (new Runtime)->getCurrentSettings(['allow_url_include']));
}
private function markTestSkippedWhenPcovIsLoaded(): void
{
if (extension_loaded('pcov')) {
$this->markTestSkipped('PHP extension pcov is loaded');
}
}
private function markTestSkippedWhenPcovIsNotLoaded(): void
{
if (!extension_loaded('pcov')) {
$this->markTestSkipped('PHP extension pcov is not loaded');
}
}
private function markTestSkippedWhenXdebugIsLoaded(): void
{
if (extension_loaded('xdebug')) {
$this->markTestSkipped('PHP extension xdebug is loaded');
}
}
private function markTestSkippedWhenXdebugCanCollectCoverage(): void
{
$this->markTestSkippedWhenXdebugIsLoaded();
if (!extension_loaded('xdebug')) {
return;
}
$xdebugMode = xdebug_info('mode');
assert(is_array($xdebugMode));
if (in_array('coverage', $xdebugMode, true)) {
$this->markTestSkipped('xdebug.mode=coverage must not be set');
}
}
private function markTestSkippedWhenXdebugCannotCollectCoverage(): void
{
$this->markTestSkippedWhenXdebugIsNotLoaded();
$xdebugMode = xdebug_info('mode');
assert(is_array($xdebugMode));
if (!in_array('coverage', $xdebugMode, true)) {
$this->markTestSkipped('xdebug.mode=coverage must be set');
}
}
private function markTestSkippedWhenXdebugIsNotLoaded(): void
{
if (!extension_loaded('xdebug')) {
$this->markTestSkipped('PHP extension xdebug is not loaded');
}
}
private function markTestSkippedWhenRunningOnPhpdbg(): void
{
if (!$this->isRunningOnPhpdbg()) {
return;
}
$this->markTestSkipped('PHPDBG must not be used');
}
private function markTestSkippedWhenNotRunningOnPhpdbg(): void
{
if ($this->isRunningOnPhpdbg()) {
return;
}
$this->markTestSkipped('PHPDBG must be used');
}
private function isRunningOnPhpdbg(): bool
{
return PHP_SAPI === 'phpdbg';
}
}
|