Skip to content

Commit bcfe505

Browse files
author
Tinywan
committed
docs: restructure characteristics and dockerfile sections in README
1 parent e9dc467 commit bcfe505

1 file changed

Lines changed: 23 additions & 11 deletions

File tree

‎README.md‎

Lines changed: 23 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -100,16 +100,23 @@ dist/
100100
└── runtime/ # 运行时缓存与日志目录 (logs, views)
101101
```
102102

103-
> **特点**:
104-
> - **无动态依赖**:不需要 `libphp.so`,不需要 `ext/*.so`,不需要 `lib/` 动态库目录,也不需要外部 `php.ini`。
105-
> - **超轻量容器**:可直接使用 5MB 的 `alpine:latest` 或 `scratch` 基础镜像制作 20MB 左右的生产级超轻镜像:
106-
> ```dockerfile
107-
> FROM alpine:latest
108-
> COPY dist /app
109-
> WORKDIR /app
110-
> EXPOSE 8787
111-
> CMD ["./webman-server", "start"]
112-
> ```
103+
#### 核心优势
104+
* **零外部依赖**:单文件全静态内嵌,无需 `libphp.so`、`ext/*.so`、`lib/` 动态库目录或外部 `php.ini`。
105+
* **跨发行版通用**:兼容任意 Linux x86_64 环境(Alpine, Ubuntu, Debian, CentOS, BusyBox 等)。
106+
* **开箱即用**:直接运行可执行文件即可启动,免去环境搭建与运维依赖。
107+
108+
#### 极简容器化示例(可选)
109+
得益于纯静态链接,可直接基于仅 5MB 的官方 Alpine 基础镜像构建约 20MB 的超轻量生产镜像:
110+
111+
```dockerfile
112+
FROM alpine:latest
113+
114+
WORKDIR /app
115+
COPY dist /app
116+
117+
EXPOSE 8787
118+
CMD ["./webman-server", "start"]
119+
```
113120

114121
---
115122

@@ -136,7 +143,12 @@ dist/
136143
└── runtime/ # 运行时缓存与日志目录 (logs, views)
137144
```
138145

139-
`lib/` 携带构建及扩展所需的所有动态依赖库;glibc、动态加载器由目标系统提供。`build-manifest.json` 用于追踪构建,不应写入密钥、令牌或其他敏感信息。
146+
#### 核心优势
147+
* **扩展生态丰富**:可使用 Linux 发行版通过 apt/包管理器预编译的海量 `.so` 扩展,适合依赖特殊外部动态库的项目。
148+
* **分发维护灵活**:二进制与底层依赖库(`libphp.so` / `ext/*.so`)物理解耦,方便针对性更新。
149+
* **标准 glibc 兼容**:兼容 glibc 2.31+ 的任何常见 Linux 发行版(Ubuntu 20.04+, Debian 11+, RHEL 9+ 等)。
150+
151+
---
140152

141153
## 🛠️ 命令
142154

0 commit comments

Comments
 (0)