@li880103/core

可选服务器层：一个纯 Node.js 的 HTTP 服务器，负责静态文件服务和 .php 请求处理，并动态加载已安装的 @li880103/php-* 版本包。配合 @li880103/php-* 使用，无需系统 PHP。

安装

# 全局安装（含一个 PHP 版本包）
npm install -g @li880103/core @li880103/php-8.1

要求 Node.js >= 20.10。

命令行用法

node-php                                # 默认端口 3000，根目录为当前目录，自动选最新已安装版本
node-php --port=8080 --php-version=8.1  # 指定端口与 PHP 版本
node-php --root=/var/www/html           # 指定网站根目录
node-php --help                         # 显示帮助

作为库使用

const { startServer } = require('@li880103/core');

const server = startServer({
  port: 8080,        // 监听端口
  version: '8.1',    // PHP 版本（不传则自动选已安装的最新版）
  rootDir: './public', // 网站根目录
});

可用版本包

| 版本包 | 说明 | | --- | --- | | @li880103/php-7.4 | PHP 7.4 WASM 引擎，npm install 后直接使用，详见同目录 README | | @li880103/php-8.0 | PHP 8.0 WASM 引擎，npm install 后直接使用，详见同目录 README | | @li880103/php-8.1 | PHP 8.1 WASM 引擎，npm install 后直接使用，详见同目录 README | | @li880103/php-8.2 | PHP 8.2 WASM 引擎，npm install 后直接使用，详见同目录 README | | @li880103/php-8.3 | PHP 8.3 WASM 引擎，npm install 后直接使用，详见同目录 README | | @li880103/php-8.4 | PHP 8.4 WASM 引擎，npm install 后直接使用，详见同目录 README |

各版本包作为本包的 optional peerDependencies，按需安装，缺哪个版本装哪个即可（npm install @li880103/php-8.1）。

说明

• 静态文件自动识别 MIME（基于 mime-types）；目录请求自动查找 index.html / index.htm
• .php 请求走 WASM 引擎执行（自动把文件所在目录挂载进 WASM），返回渲染后的 HTML
• 未指定版本时自动选择已安装的最新 PHP 版本，也可用 --php-version 或 version 显式指定
• 首次执行需编译 20MB+ WASM，耗时数秒，之后实例复用

许可

本包装配代码为 MIT；PHP 引擎本体来自 GPL-2.0-or-later 的 php-wasm（WordPress Playground）。