@@ -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