Fix server hanging

Fixes #6

Author: sindresorhus

index.d.ts

@@ -80,14 +80,14 @@ export type Options = {
 
 export type Server = {
 	/**
-	The [`subprocess.stderr`](https://nodejs.org/api/child_process.html#child_process_subprocess_stdout).
+	The [`subprocess.stdout`](https://nodejs.org/api/child_process.html#child_process_subprocess_stdout).
 	*/
-	readonly stdout: NodeJS.WritableStream;
+	readonly stdout: NodeJS.ReadableStream;
 
 	/**
 	The [`subprocess.stderr`](https://nodejs.org/api/child_process.html#child_process_subprocess_stderr).
 	*/
-	readonly stderr: NodeJS.WritableStream;
+	readonly stderr: NodeJS.ReadableStream;
 
 	/**
 	The URL to the server.

index.js

@@ -112,6 +112,17 @@ export default async function phpServer(options) {
 		},
 	});
 
+	// Drain stdout/stderr to prevent the child process from blocking if nothing reads them.
+	// Users can still attach listeners on these streams as needed.
+	// See https://github.com/sindresorhus/php-server/issues/6
+	if (subprocess.stdout) {
+		subprocess.stdout.resume();
+	}
+
+	if (subprocess.stderr) {
+		subprocess.stderr.resume();
+	}
+
 	subprocess.ref();
 
 	process.on('exit', () => {

test/stdio-flowing.test.js

@@ -0,0 +1,13 @@
+import {test} from 'node:test';
+import assert from 'node:assert/strict';
+import phpServer from '../index.js';
+
+test('stdout/stderr are flowing to avoid blocking', async () => {
+	const server = await phpServer({base: 'test/fixtures/200'});
+	try {
+		assert.equal(server.stdout?.readableFlowing, true);
+		assert.equal(server.stderr?.readableFlowing, true);
+	} finally {
+		server.stop();
+	}
+});