php-server-cli 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +30 -2
  2. package/bin/server.js +169 -0
  3. package/package.json +34 -4
package/README.md CHANGED
@@ -1,3 +1,31 @@
1
- # Temporary Holding Version
1
+ # CLI Server PHP
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Aplikasi CLI Node.js ringan untuk menjalankan PHP built-in server secara instan dengan alokasi port acak otomatis dan langsung membuka browser bawaan.
4
+
5
+ ## Penggunaan
6
+
7
+ 1. Menjalankan server pada direktori saat ini:
8
+ ```bash
9
+ server
10
+ ```
11
+ Menjalankan: `php -S localhost:[portAcak]` lalu membuka browser ke alamat tersebut.
12
+
13
+ 2. Menjalankan server pada sub-folder tertentu:
14
+ ```bash
15
+ server public
16
+ ```
17
+ Menjalankan: `php -S localhost:[portAcak] -t public` lalu membuka browser ke alamat tersebut.
18
+
19
+ ## Instalasi Lokal (Development)
20
+
21
+ Untuk mengaktifkan perintah `server` di terminal Anda secara langsung dari repository lokal:
22
+ ```bash
23
+ npm link
24
+ ```
25
+
26
+ ## Publish ke NPM Registry
27
+
28
+ ```bash
29
+ npm login
30
+ npm publish --access public
31
+ ```
package/bin/server.js ADDED
@@ -0,0 +1,169 @@
1
+ #!/usr/bin/env node
2
+
3
+ import { spawn } from 'node:child_process';
4
+ import net from 'node:net';
5
+ import http from 'node:http';
6
+ import fs from 'node:fs';
7
+ import path from 'node:path';
8
+
9
+ // Periksa ketersediaan port
10
+ function checkPortAvailable(port) {
11
+ return new Promise((resolve) => {
12
+ const srv = net.createServer();
13
+ srv.once('error', () => resolve(false));
14
+ srv.once('listening', () => {
15
+ srv.close(() => resolve(true));
16
+ });
17
+ srv.listen(port, '127.0.0.1');
18
+ });
19
+ }
20
+
21
+ // Dapatkan port acak yang belum terpakai
22
+ async function getAvailablePort() {
23
+ for (let i = 0; i < 30; i++) {
24
+ const randomPort = Math.floor(Math.random() * (9999 - 3000 + 1)) + 3000;
25
+ if (await checkPortAvailable(randomPort)) {
26
+ return randomPort;
27
+ }
28
+ }
29
+
30
+ return new Promise((resolve, reject) => {
31
+ const srv = net.createServer();
32
+ srv.listen(0, '127.0.0.1', () => {
33
+ const port = srv.address().port;
34
+ srv.close(() => resolve(port));
35
+ });
36
+ srv.on('error', reject);
37
+ });
38
+ }
39
+
40
+ // Buka browser bawaan sistem operasi
41
+ function openBrowser(targetUrl) {
42
+ const osType = process.platform;
43
+ try {
44
+ if (osType === 'win32') {
45
+ spawn('cmd.exe', ['/c', 'start', '', targetUrl], { detached: true, stdio: 'ignore' }).unref();
46
+ } else if (osType === 'darwin') {
47
+ spawn('open', [targetUrl], { detached: true, stdio: 'ignore' }).unref();
48
+ } else {
49
+ spawn('xdg-open', [targetUrl], { detached: true, stdio: 'ignore' }).unref();
50
+ }
51
+ } catch (err) {
52
+ console.error(`Gagal membuka browser secara otomatis: ${err.message}`);
53
+ }
54
+ }
55
+
56
+ // Tunggu server PHP siap menerima request, lalu buka browser
57
+ function waitAndOpenBrowser(url, port) {
58
+ let isOpened = false;
59
+ const launch = () => {
60
+ if (!isOpened) {
61
+ isOpened = true;
62
+ openBrowser(url);
63
+ }
64
+ };
65
+
66
+ const startTime = Date.now();
67
+ const timer = setInterval(() => {
68
+ if (Date.now() - startTime > 3500) {
69
+ clearInterval(timer);
70
+ launch();
71
+ return;
72
+ }
73
+
74
+ const req = http.get(url, () => {
75
+ clearInterval(timer);
76
+ launch();
77
+ });
78
+
79
+ req.on('error', () => {
80
+ // Server belum siap, tunggu interval berikutnya
81
+ });
82
+
83
+ req.setTimeout(400, () => {
84
+ req.destroy();
85
+ });
86
+ }, 150);
87
+ }
88
+
89
+ // Eksekusi utama
90
+ async function main() {
91
+ const args = process.argv.slice(2);
92
+
93
+ if (args.includes('--help') || args.includes('-h')) {
94
+ console.log(`
95
+ Penggunaan:
96
+ server Menjalankan server di direktori saat ini
97
+ server <folder> Menjalankan server dengan root direktori tertentu
98
+ server --help, -h Menampilkan bantuan
99
+ `);
100
+ process.exit(0);
101
+ }
102
+
103
+ let targetDirectory = null;
104
+ for (const item of args) {
105
+ if (!item.startsWith('-')) {
106
+ targetDirectory = item;
107
+ break;
108
+ }
109
+ }
110
+
111
+ if (targetDirectory) {
112
+ const fullPath = path.resolve(process.cwd(), targetDirectory);
113
+ if (!fs.existsSync(fullPath)) {
114
+ console.error(`\x1b[31m[Error] Folder "${targetDirectory}" tidak ditemukan.\x1b[0m`);
115
+ process.exit(1);
116
+ }
117
+ const stat = fs.statSync(fullPath);
118
+ if (!stat.isDirectory()) {
119
+ console.error(`\x1b[31m[Error] "${targetDirectory}" bukan merupakan folder.\x1b[0m`);
120
+ process.exit(1);
121
+ }
122
+ }
123
+
124
+ const port = await getAvailablePort();
125
+ const url = `http://localhost:${port}`;
126
+
127
+ const phpArgs = ['-S', `localhost:${port}`];
128
+ if (targetDirectory) {
129
+ phpArgs.push('-t', targetDirectory);
130
+ }
131
+
132
+ console.log('\x1b[36m%s\x1b[0m', '--------------------------------------------------');
133
+ console.log('\x1b[32m%s\x1b[0m', '⚡ PHP Development Server');
134
+ console.log(`🔗 URL : \x1b[34m${url}\x1b[0m`);
135
+ console.log(`📂 Folder : \x1b[33m${targetDirectory ? targetDirectory : process.cwd()}\x1b[0m`);
136
+ console.log(`🌐 Membuka browser default...`);
137
+ console.log('Tekan Ctrl+C untuk menghentikan server.');
138
+ console.log('\x1b[36m%s\x1b[0m', '--------------------------------------------------\n');
139
+
140
+ waitAndOpenBrowser(url, port);
141
+
142
+ const phpProcess = spawn('php', phpArgs, {
143
+ stdio: 'inherit',
144
+ shell: process.platform === 'win32'
145
+ });
146
+
147
+ phpProcess.on('error', (err) => {
148
+ if (err.code === 'ENOENT') {
149
+ console.error('\x1b[31m[Error] Perintah "php" tidak ditemukan.\x1b[0m');
150
+ console.error('Pastikan PHP telah terpasang dan terdaftar di Environment PATH.');
151
+ } else {
152
+ console.error(`\x1b[31m[Error] Gagal menjalankan PHP: ${err.message}\x1b[0m`);
153
+ }
154
+ process.exit(1);
155
+ });
156
+
157
+ const cleanExit = () => {
158
+ phpProcess.kill();
159
+ process.exit(0);
160
+ };
161
+
162
+ process.on('SIGINT', cleanExit);
163
+ process.on('SIGTERM', cleanExit);
164
+ }
165
+
166
+ main().catch((err) => {
167
+ console.error(`Terjadi kesalahan: ${err.message}`);
168
+ process.exit(1);
169
+ });
package/package.json CHANGED
@@ -1,6 +1,36 @@
1
1
  {
2
2
  "name": "php-server-cli",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "1.0.0",
4
+ "description": "CLI cepat untuk menjalankan PHP built-in server dengan port acak dan otomatis membuka browser.",
5
+ "type": "module",
6
+ "bin": {
7
+ "server": "bin/server.js"
8
+ },
9
+ "files": [
10
+ "bin",
11
+ "README.md"
12
+ ],
13
+ "repository": {
14
+ "type": "git",
15
+ "url": "git+https://github.com/mzaini30/php-server-cli.git"
16
+ },
17
+ "keywords": [
18
+ "php",
19
+ "server",
20
+ "cli",
21
+ "development",
22
+ "localhost"
23
+ ],
24
+ "author": "mzaini30",
25
+ "license": "MIT",
26
+ "bugs": {
27
+ "url": "https://github.com/mzaini30/php-server-cli/issues"
28
+ },
29
+ "homepage": "https://github.com/mzaini30/php-server-cli#readme",
30
+ "engines": {
31
+ "node": ">=18.0.0"
32
+ },
33
+ "publishConfig": {
34
+ "access": "public"
35
+ }
36
+ }