2021-06-06 11:42:21 +08:00
|
|
|
# static-php-cli
|
2023-03-18 14:19:45 +08:00
|
|
|
Compile A Statically Linked PHP With Swoole and other Extensions.
|
2022-06-27 11:13:56 +08:00
|
|
|
|
2023-03-18 14:19:45 +08:00
|
|
|
Compile a purely static PHP binary file with various extensions to make PHP-cli applications more portable!
|
2021-05-07 09:33:06 +08:00
|
|
|
|
2023-03-18 14:19:45 +08:00
|
|
|
You can also use the micro binary file to package PHP source code and binary files into one for distribution!
|
2021-05-07 09:33:06 +08:00
|
|
|
|
2023-03-18 14:19:45 +08:00
|
|
|
Note: only support cli SAPI, not support fpm, cgi.
|
2021-05-07 09:33:06 +08:00
|
|
|
|
2021-07-28 14:27:18 +08:00
|
|
|
## Compilation Requirements
|
2022-05-16 17:02:57 +08:00
|
|
|
|
2023-03-18 14:19:45 +08:00
|
|
|
Yes, this project is written in PHP, pretty funny.
|
|
|
|
|
But php-static-cli only requires an environment above PHP 8.0.
|
2022-05-16 17:02:57 +08:00
|
|
|
|
2023-03-18 14:19:45 +08:00
|
|
|
- Linux
|
|
|
|
|
- Supported arch: aarch64, amd64
|
|
|
|
|
- Supported distributions: alpine, ubuntu, centos
|
|
|
|
|
- Requirements: (TODO)
|
|
|
|
|
- macOS
|
|
|
|
|
- Supported arch: arm64, x86_64
|
|
|
|
|
- Requirements: make, bison, flex, pkg-config, git, autoconf, automake, tar, unzip, xz, gzip, bzip2, cmake
|
|
|
|
|
- Windows
|
|
|
|
|
- Supported arch: x86_64
|
|
|
|
|
- Requirements: (TODO)
|
|
|
|
|
- PHP
|
|
|
|
|
- Supported version: 8.0, 8.1, 8.2
|
2022-05-16 17:02:57 +08:00
|
|
|
|
2023-03-18 14:19:45 +08:00
|
|
|
## Usage (WIP)
|
2022-05-16 17:02:57 +08:00
|
|
|
|
2023-03-18 14:19:45 +08:00
|
|
|
After stable release for this project, a single phar and single binary for this tool will be published.
|
2021-06-06 11:41:55 +08:00
|
|
|
|
2023-03-18 14:19:45 +08:00
|
|
|
And currently you may need to clone this branch and edit GitHub Action to build.
|
2022-05-15 01:41:58 +08:00
|
|
|
|
|
|
|
|
```bash
|
2023-03-18 17:34:25 +08:00
|
|
|
chmod +x spc
|
|
|
|
|
# fetch all libraries
|
|
|
|
|
./spc fetch --all
|
|
|
|
|
# with bcmath,openssl,swoole extension, build both CLI and phpmicro SAPI
|
|
|
|
|
./spc build "bcmath,openssl,swoole" --build-all
|
2022-05-15 01:41:58 +08:00
|
|
|
```
|
|
|
|
|
|
2023-03-18 14:19:45 +08:00
|
|
|
## Current Status
|
|
|
|
|
|
|
|
|
|
- [X] Basic CLI framework (by symfony/console)
|
|
|
|
|
- [ ] Linux support
|
2023-03-18 17:34:25 +08:00
|
|
|
- [X] macOS support
|
2023-03-18 14:19:45 +08:00
|
|
|
- [X] Exception handler
|
|
|
|
|
- [ ] Windows support
|
|
|
|
|
- [ ] PHP 7.4 support
|
|
|
|
|
|
2023-03-18 17:34:25 +08:00
|
|
|
## Supported Extensions (WIP)
|
|
|
|
|
|
|
|
|
|
[Support Extension List](/ext-support.md)
|
2023-03-18 14:19:45 +08:00
|
|
|
|
|
|
|
|
## Open-Source LICENSE
|
|
|
|
|
|
|
|
|
|
This project is based on the tradition of using the MIT License for old versions,
|
|
|
|
|
while the new version references source code from some other projects.
|
|
|
|
|
Special thanks to:
|
|
|
|
|
|
2023-03-18 17:44:23 +08:00
|
|
|
- [dixyes/lwmbs](https://github.com/dixyes/lwmbs) (Mulun Permissive License)
|
|
|
|
|
- [swoole/swoole-cli](https://github.com/swoole/swoole-cli) (Apache 2.0 LICENSE+SWOOLE-CLI LICENSE)
|
|
|
|
|
|
2023-03-18 14:19:45 +08:00
|
|
|
Due to the special nature of this project,
|
|
|
|
|
many other open source projects such as curl and protobuf will be used during the project compilation process,
|
|
|
|
|
and they all have their own open source licenses.
|
|
|
|
|
|
2023-03-18 17:34:25 +08:00
|
|
|
Please use the `dump-license`(TODO) command to export the open source licenses used in the project after compilation,
|
2023-03-18 14:19:45 +08:00
|
|
|
and comply with the corresponding project's LICENSE.
|
