Skip to content

Commit dedea8b

Browse files
committed
remove musl from chinese docs
1 parent 841db28 commit dedea8b

File tree

1 file changed

+4
-140
lines changed

1 file changed

+4
-140
lines changed

docs/zh/develop/system-build-tools.md

Lines changed: 4 additions & 140 deletions
Original file line numberDiff line numberDiff line change
@@ -24,36 +24,10 @@ glibc 环境指的是系统底层的 `libc` 库(即所有 C 语言编写的程
2424

2525
而 glibc 环境下,我们使用的包管理、编译器都是默认指向 glibc 的,glibc 不能被良好地静态链接。它不能被静态链接的原因之一是它的网络库 `nss` 无法静态编译。
2626

27-
对于 glibc 环境,在 2.0 RC8 及以后的 static-php-cli 及 spc 中,你可以选择两种方式来构建静态 PHP:
27+
对于 glibc 环境,在 static-php-cli 及 spc 中,你可以选择两种方式来构建静态 PHP:
2828

29-
1. 使用 Docker 构建,这是最简单的方式,你可以使用 `bin/spc-alpine-docker` 来构建,它会在 Alpine Linux 环境下构建。
30-
2. 使用 `bin/spc doctor` 安装 musl-wrapper 和 musl-cross-make 套件,然后直接正常构建。([相关源码](https://github.com/crazywhalecc/static-php-cli/blob/main/src/SPC/doctor/item/LinuxMuslCheck.php)
31-
32-
一般来说,这两种构建方式的构建结果是一致的,你可以根据实际需求选择。
33-
34-
在 doctor 模块中,static-php-cli 会先检测当前的 Linux 发行版。如果当前发行版是 glibc 环境,会提示需要安装 musl-wrapper 和 musl-cross-make 套件。
35-
36-
在 glibc 环境下安装 musl-wrapper 的过程如下:
37-
38-
1. 从 musl 官网下载特定版本的 [musl-wrapper 源码](https://musl.libc.org/releases/)
39-
2. 使用从包管理安装的 `gcc` 编译 musl-wrapper 源码,生成 `musl-libc` 等库:`./configure --disable-gcc-wrapper && make -j && sudo make install`
40-
3. musl-wrapper 相关库将被安装在 `/usr/local/musl` 目录。
41-
42-
在 glibc 环境下安装 musl-cross-make 的过程如下:
43-
44-
1. 从 dl.static-php.dev 下载预编译好的 [musl-cross-make](https://dl.static-php.dev/static-php-cli/deps/musl-toolchain/) 压缩包。
45-
2. 解压到 `/usr/local/musl` 目录。
46-
47-
::: tip
48-
在 glibc 环境下,静态编译可以通过直接安装 musl-wrapper 来实现,但是 musl-wrapper 仅包含了 `musl-gcc`,而没有 `musl-g++`,这也就意味着无法编译 C++ 代码。
49-
所以我们需要 musl-cross-make 来提供 `musl-g++`
50-
51-
而 musl-cross-make 套件无法在本地直接编译的原因是它的编译环境要求比较高(需要 36GB 以上内存,Alpine Linux 下编译),所以我们提供了预编译好的二进制包,可用于所有 Linux 发行版。
52-
53-
同时,部分发行版的包管理提供了 musl-wrapper,但 musl-cross-make 需要匹配对应的 musl-wrapper 版本,所以我们不使用包管理安装 musl-wrapper。
54-
55-
对于如何编译 musl-cross-make,将在本章节内的 **编译 musl-cross-make** 小节中介绍。
56-
:::
29+
1. 使用 Docker 构建,你可以使用 `bin/spc-alpine-docker``bin/spc-gnu-docker` 来构建。
30+
2. 使用 `bin/spc doctor --auto-fix` 然后直接构建 glibc。)
5731

5832
### musl 环境
5933

@@ -63,124 +37,14 @@ musl 环境指的是系统底层的 `libc` 库使用的是 `musl`,这是一种
6337

6438
对于其他发行版,如果你的发行版使用的是 musl 环境,那么你也可以在安装必要的编译工具后直接使用 static-php-cli 构建静态 PHP。
6539

66-
::: tip
67-
在 musl 环境下,static-php-cli 会自动跳过 musl-wrapper 和 musl-cross-make 的安装。
68-
:::
69-
7040
### Docker 环境
7141

72-
Docker 环境指的是使用 Docker 容器来构建静态 PHP,你可以使用 `bin/spc-alpine-docker` 来构建。
42+
Docker 环境指的是使用 Docker 容器来构建静态 PHP,你可以使用 `bin/spc-alpine-docker` `bin/spc-gnu-docker` 来构建。
7343
执行这个命令前需要先安装 Docker,然后在项目根目录执行 `bin/spc-alpine-docker` 即可。
7444

7545
在执行 `bin/spc-alpine-docker` 后,static-php-cli 会自动下载 Alpine Linux 镜像,然后构建一个 `cwcc-spc-x86_64``cwcc-spc-aarch64` 的镜像。
7646
然后一切的构建都在这个镜像内进行,相当于在 Alpine Linux 内编译。总的来说,Docker 环境就是 musl 环境。
7747

78-
## musl-cross-make 工具链编译
79-
80-
在 Linux 中,尽管你不需要手动编译 musl-cross-make 工具,但是如果你想了解它的编译过程,可以参考这里。
81-
还有一个重要的原因就是,这个可能无法使用 CI、Actions 等自动化工具编译,因为现有的 CI 服务编译环境不满足 musl-cross-make 的编译要求,满足要求的配置价格太高。
82-
83-
musl-cross-make 的编译过程如下:
84-
85-
准备一个 Alpine Linux 环境(直接安装或使用 Docker 均可),编译的过程需要 36GB 以上内存,所以你需要在内存较大的机器上编译。如果没有这么多内存,可能会导致编译失败。
86-
87-
然后将以下内容写入 `config.mak` 文件内:
88-
89-
```makefile
90-
STAT = -static --static
91-
FLAG = -g0 -Os -Wno-error
92-
93-
ifneq ($(NATIVE),)
94-
COMMON_CONFIG += CC="$(HOST)-gcc ${STAT}" CXX="$(HOST)-g++ ${STAT}"
95-
else
96-
COMMON_CONFIG += CC="gcc ${STAT}" CXX="g++ ${STAT}"
97-
endif
98-
99-
COMMON_CONFIG += CFLAGS="${FLAG}" CXXFLAGS="${FLAG}" LDFLAGS="${STAT}"
100-
101-
BINUTILS_CONFIG += --enable-gold=yes --enable-gprofng=no
102-
GCC_CONFIG += --enable-static-pie --disable-cet --enable-default-pie
103-
#--enable-default-pie
104-
105-
CONFIG_SUB_REV = 888c8e3d5f7b
106-
GCC_VER = 13.2.0
107-
BINUTILS_VER = 2.40
108-
MUSL_VER = 1.2.4
109-
GMP_VER = 6.2.1
110-
MPC_VER = 1.2.1
111-
MPFR_VER = 4.2.0
112-
LINUX_VER = 6.1.36
113-
```
114-
115-
同时,你需要新建一个 `gcc-13.2.0.tar.xz.sha1` 文件,文件内容如下:
116-
117-
```
118-
5f95b6d042fb37d45c6cbebfc91decfbc4fb493c gcc-13.2.0.tar.xz
119-
```
120-
121-
如果你使用的是 Docker 构建,新建一个 `Dockerfile` 文件,写入以下内容:
122-
123-
```dockerfile
124-
FROM alpine:edge
125-
126-
RUN apk add --no-cache \
127-
gcc g++ git make curl perl \
128-
rsync patch wget libtool \
129-
texinfo autoconf automake \
130-
bison tar xz bzip2 zlib \
131-
file binutils flex \
132-
linux-headers libintl \
133-
gettext gettext-dev icu-libs pkgconf \
134-
pkgconfig icu-dev bash \
135-
ccache libarchive-tools zip
136-
137-
WORKDIR /opt
138-
139-
RUN git clone https://git.zv.io/toolchains/musl-cross-make.git
140-
WORKDIR /opt/musl-cross-make
141-
COPY config.mak /opt/musl-cross-make
142-
COPY gcc-13.2.0.tar.xz.sha1 /opt/musl-cross-make/hashes
143-
144-
RUN make TARGET=x86_64-linux-musl -j || :
145-
RUN sed -i 's/poison calloc/poison/g' ./gcc-13.2.0/gcc/system.h
146-
RUN make TARGET=x86_64-linux-musl -j
147-
RUN make TARGET=x86_64-linux-musl install -j
148-
RUN tar cvzf x86_64-musl-toolchain.tgz output/*
149-
```
150-
151-
如果你使用的是非 Docker 环境的 Alpine Linux,可以直接执行 Dockerfile 中的命令,例如:
152-
153-
```bash
154-
apk add --no-cache \
155-
gcc g++ git make curl perl \
156-
rsync patch wget libtool \
157-
texinfo autoconf automake \
158-
bison tar xz bzip2 zlib \
159-
file binutils flex \
160-
linux-headers libintl \
161-
gettext gettext-dev icu-libs pkgconf \
162-
pkgconfig icu-dev bash \
163-
ccache libarchive-tools zip
164-
165-
git clone https://git.zv.io/toolchains/musl-cross-make.git
166-
# 将 config.mak 拷贝到 musl-cross-make 的工作目录内,你需要将 /path/to/config.mak 替换为你的 config.mak 文件路径
167-
cp /path/to/config.mak musl-cross-make/
168-
cp /path/to/gcc-13.2.0.tar.xz.sha1 musl-cross-make/hashes
169-
170-
make TARGET=x86_64-linux-musl -j || :
171-
sed -i 's/poison calloc/poison/g' ./gcc-13.2.0/gcc/system.h
172-
make TARGET=x86_64-linux-musl -j
173-
make TARGET=x86_64-linux-musl install -j
174-
tar cvzf x86_64-musl-toolchain.tgz output/*
175-
```
176-
177-
::: tip
178-
以上所有脚本都适用于 x86_64 架构的 Linux。如果你需要构建 ARM 环境的 musl-cross-make,只需要将上方所有 `x86_64` 替换为 `aarch64` 即可。
179-
:::
180-
181-
这个编译过程可能会因为内存不足、网络问题等原因导致编译失败,你可以多尝试几次,或者使用更大内存的机器来编译。
182-
如果遇到了问题,或者你有更好的改进方案,可以在 [讨论](https://github.com/crazywhalecc/static-php-cli-hosted/issues/1) 中提出。
183-
18448
## macOS 环境编译工具
18549

18650
对于 macOS 系统来说,我们使用的编译工具主要是 `clang`,它是 macOS 系统默认的编译器,同时也是 Xcode 的编译器。

0 commit comments

Comments
 (0)