Skip to content

Commit 1a3a421

Browse files
committed
update readmes
1 parent b7878ba commit 1a3a421

2 files changed

Lines changed: 12 additions & 12 deletions

File tree

Readme.EN.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -7,11 +7,11 @@
77

88
micro self-executable SAPI makes PHP self-executable.
99

10-
Just concatenate micro.sfx and random php source file or phar into a single file to use it.
10+
Just concatenate micro.sfx and a random PHP source file or PHAR into a single file to use it.
1111

1212
## Compatibility
1313

14-
Yet only support PHP8+; Windows, Linux, macOS.
14+
Currently, it only supports PHP8+ on Windows, Linux, and macOS (and maybe some BSDs).
1515

1616
## Fetch and Usage
1717

@@ -98,7 +98,7 @@ Options for reference:
9898

9999
`--disable-phpdbg --disable-cgi --disable-cli --disable-all --enable-micro --enable-phar --with-ffi --enable-zlib`
100100

101-
At Linux libc compatibility can be a problem, micro provides two kinds of `configure` arguments:
101+
On Linux, libc compatibility can be a problem. To address this, micro provides two kinds of `configure` arguments:
102102

103103
- `--enable-micro=yes`or`--enable-micro`: this will make PIE shared ELF micro sfx, this kind of binary cannot be invoked cross libc (i.e. you cannot run such a binary which was built on alpine with musl on any glibc-based CentOS), but the binary can do ffi and PHP `dl()` function.
104104
- `--enable-micro=all-static`: this will make full static ELF micro sfx, this kind of binary can even run barely on top of any linux kernel, but ffi/`dl()` is not supported.
@@ -110,13 +110,13 @@ At Linux libc compatibility can be a problem, micro provides two kinds of `confi
110110
make micro
111111
```
112112

113-
(`make all`(aka. `make`) may work also, but build only the micro SAPI is recommended.)
113+
(`make all`(aka. `make`) may work also, but it is recommended to only build the micro SAPI.)
114114

115115
The built file will be located at sapi/micro/micro.sfx.
116116

117117
### Windows Build
118118

119-
0.Prepare the build environment according to [the official PHP documents](https://wiki.php.net/internals/windows/stepbystepbuild_sdk_2).
119+
0.Prepare the build environment according to [the official PHP documents](https://wiki.php.net/internals/windows/stepbystepbuild_sdk_2), you may also try [my scripts](https://github.com/dixyes/php-dev-windows-tool)
120120

121121
1.buildconf
122122

@@ -137,7 +137,7 @@ Options for reference:
137137
`--disable-all --disable-zts --enable-micro --enable-phar --with-ffi --enable-zlib`
138138

139139
3.make
140-
Due to PHP build system on Windows lack of the ability to statically build PHP binary, you cannot build micro with `nmake`
140+
Due to the PHP build system's inability to statically build PHP binaries on Windows, you cannot build micro with `nmake` command.
141141

142142
```batch
143143
# at PHP source dir
@@ -148,9 +148,9 @@ That built file is at `<arch name like x64>\\<configuration like Release>\\micro
148148

149149
## Optimizations
150150

151-
Hugepages optimization for Linux in the PHP build system results in a huge size of sfx, if you do not take advantage of hugepages, use `disable_huge_page.patch` to shrink the sfx size.
151+
The Hugepages optimization for Linux in the PHP build system results in a large sfx size. If you do not take advantage of Hugepages, use `disable_huge_page.patch` to reduce the sfx size.
152152

153-
Statically build under Linux needs libc, the most common glibc may be large, musl is recommended instead. manually installed musl or some distros provided musl will provide `musl-gcc` or `musl-clang` wrapper, use one of them before configure by specify CC/CXX environs, for example
153+
A static build under Linux requires libc. The most common libc, glibc, may be large, so musl is recommended instead. Manually installed musl or some distros provided musl will provide `musl-gcc` or `musl-clang` wrapper, use one of them before configure by specify CC/CXX environs, for example
154154

155155
```bash
156156
# ./buildconf things...
@@ -160,7 +160,7 @@ export CXX=musl-gcc
160160
# make things
161161
```
162162

163-
We hope all dependencies are statically linked into sfx. However, some distro does not provide static versions of them. We may manually build them.
163+
We aim to have all dependencies statically linked into sfx. However, some distro does not provide static versions of them. We may manually build them.
164164

165165
libffi for example (note that the ffi extension is not supported in `all-static` builds):
166166

@@ -201,7 +201,7 @@ See wiki:[INI-settings](https://github.com/easysoft/phpmicro/wiki/INI-settings
201201

202202
### PHP_BINARY constant
203203

204-
In micro, `PHP_BINARY` is an empty string. You can modify it using an ini setting: `micro.php_binary=somestring`
204+
In micro, the `PHP_BINARY` constant is an empty string. You can modify it using an ini setting: `micro.php_binary=somestring`
205205

206206
## OSS License
207207

Readme.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,11 +7,11 @@
77

88
micro自执行SAPI提供了php“自执行文件”的可能性
99

10-
你只需要将构建的micro.sfx文件与任意php文件或者phar包拼接(cat或者copy /b)为一个文件就可以直接执行这个php文件
10+
你只需要将构建的micro.sfx文件与任意php文件或者phar包拼接(`cat`或者`copy /b`)为一个文件就可以直接执行这个php文件
1111

1212
## 兼容性
1313

14-
目前兼容PHP8+;兼容Windows、Linux、macOS。
14+
目前兼容PHP8+;兼容Windows、Linux、macOS (可能也支持一些BSDs)
1515

1616
## 获取与使用
1717

0 commit comments

Comments
 (0)