tmpLogfile = tempnam(sys_get_temp_dir(), 'epube_debug_'); } protected function tearDown(): void { // Clean up temp log file if ($this->tmpLogfile && file_exists($this->tmpLogfile)) { unlink($this->tmpLogfile); } // Reset Debug static state via public setters Debug::set_enabled(false); Debug::set_quiet(false); Debug::set_logfile(''); Debug::set_loglevel(0); } // ── Constants ──────────────────────────────────────────────────────────── public function test_constants_defined(): void { $this->assertEquals(-1, Debug::LOG_DISABLED); $this->assertEquals(0, Debug::LOG_NORMAL); $this->assertEquals(1, Debug::LOG_VERBOSE); $this->assertEquals(2, Debug::LOG_EXTENDED); } // ── set_enabled / enabled() ────────────────────────────────────────────── public function test_enabled_defaults_to_false(): void { $this->assertFalse(Debug::enabled()); } public function test_set_enabled_true(): void { Debug::set_enabled(true); $this->assertTrue(Debug::enabled()); } public function test_set_enabled_false(): void { Debug::set_enabled(true); Debug::set_enabled(false); $this->assertFalse(Debug::enabled()); } // ── set_loglevel / get_loglevel() ──────────────────────────────────────── public function test_loglevel_defaults_to_zero(): void { $this->assertEquals(0, Debug::get_loglevel()); } public function test_set_loglevel(): void { Debug::set_loglevel(Debug::LOG_VERBOSE); $this->assertEquals(Debug::LOG_VERBOSE, Debug::get_loglevel()); } public function test_set_loglevel_extended(): void { Debug::set_loglevel(Debug::LOG_EXTENDED); $this->assertEquals(Debug::LOG_EXTENDED, Debug::get_loglevel()); } // ── log() — disabled ───────────────────────────────────────────────────── public function test_log_disabled_does_nothing(): void { Debug::set_enabled(false); $this->expectOutputString(''); Debug::log('test message', Debug::LOG_NORMAL); } // ── log() — level filtering ────────────────────────────────────────────── public function test_log_level_filtering(): void { // loglevel < level means the message is skipped // So with loglevel=0 (NORMAL), a message at level=1 (VERBOSE) is filtered Debug::set_enabled(true); Debug::set_loglevel(Debug::LOG_NORMAL); Debug::set_quiet(true); ob_start(); Debug::log('verbose message', Debug::LOG_VERBOSE); $output = ob_get_clean(); $this->assertEmpty($output, 'VERBOSE message should be filtered when loglevel is NORMAL'); } public function test_log_level_normal_when_loglevel_zero(): void { Debug::set_enabled(true); Debug::set_loglevel(Debug::LOG_NORMAL); Debug::set_quiet(true); ob_start(); Debug::log('normal message', Debug::LOG_NORMAL); $output = ob_get_clean(); $this->assertNotEmpty($output, 'NORMAL message should pass when loglevel is NORMAL'); } // ── log() — file writing ───────────────────────────────────────────────── public function test_log_writes_to_file(): void { Debug::set_enabled(true); Debug::set_logfile($this->tmpLogfile); Debug::set_loglevel(Debug::LOG_NORMAL); Debug::log('file test message', Debug::LOG_NORMAL); $this->assertFileExists($this->tmpLogfile); $content = file_get_contents($this->tmpLogfile); $this->assertStringContainsString('file test message', $content); } public function test_log_timestamp_in_file(): void { Debug::set_enabled(true); Debug::set_logfile($this->tmpLogfile); Debug::set_loglevel(Debug::LOG_NORMAL); Debug::log('timestamp test', Debug::LOG_NORMAL); $content = file_get_contents($this->tmpLogfile); // Format: [HH:MM:SS/PID] message, PID is optional $this->assertMatchesRegularExpression('/\[\d{2}:\d{2}:\d{2}(\/\d+)?\]/', $content); } public function test_log_multiple_messages_to_file(): void { Debug::set_enabled(true); Debug::set_logfile($this->tmpLogfile); Debug::set_loglevel(Debug::LOG_NORMAL); Debug::log('first message', Debug::LOG_NORMAL); Debug::log('second message', Debug::LOG_NORMAL); $lines = array_filter(explode("\n", file_get_contents($this->tmpLogfile))); $this->assertCount(2, $lines); $this->assertStringContainsString('first message', $lines[0]); $this->assertStringContainsString('second message', $lines[1]); } // ── log() — quiet mode ─────────────────────────────────────────────────── public function test_quiet_mode_suppresses_stdout(): void { // quiet mode only suppresses stdout when a logfile is set Debug::set_enabled(true); Debug::set_loglevel(Debug::LOG_NORMAL); Debug::set_quiet(true); Debug::set_logfile($this->tmpLogfile); ob_start(); Debug::log('quiet test', Debug::LOG_NORMAL); $output = ob_get_clean(); $this->assertEmpty($output, 'Quiet mode should suppress stdout when logfile is set'); } public function test_non_quiet_mode_prints_to_stdout(): void { Debug::set_enabled(true); Debug::set_loglevel(Debug::LOG_NORMAL); Debug::set_quiet(false); ob_start(); Debug::log('stdout test', Debug::LOG_NORMAL); $output = ob_get_clean(); $this->assertStringContainsString('stdout test', $output); } // ── set_logfile ────────────────────────────────────────────────────────── public function test_set_logfile(): void { Debug::set_logfile('/tmp/test_debug.log'); $ref = new ReflectionClass(Debug::class); $prop = $ref->getProperty('logfile'); $this->assertEquals('/tmp/test_debug.log', $prop->getValue(null)); } // ── set_quiet ──────────────────────────────────────────────────────────── public function test_set_quiet_true(): void { Debug::set_quiet(true); $ref = new ReflectionClass(Debug::class); $prop = $ref->getProperty('quiet'); $this->assertTrue($prop->getValue(null)); } public function test_set_quiet_false(): void { Debug::set_quiet(true); Debug::set_quiet(false); $ref = new ReflectionClass(Debug::class); $prop = $ref->getProperty('quiet'); $this->assertFalse($prop->getValue(null)); } }