mirror of
https://github.com/crazywhalecc/static-php-cli.git
synced 2026-03-18 04:44:53 +08:00
171 lines
6.8 KiB
Markdown
Executable File
171 lines
6.8 KiB
Markdown
Executable File
# static-php-cli
|
|
|
|
Compile A Statically Linked PHP With Swoole and other Extensions.
|
|
|
|
Compile a purely static PHP binary file with various extensions to make PHP-cli applications more portable!
|
|
|
|
You can also use the micro binary file to package PHP source code and binary files into one for distribution!
|
|
This function is provided by [dixyes/phpmicro](https://github.com/dixyes/phpmicro).
|
|
|
|
Note: only support cli, not support fpm, cgi.
|
|
|
|
> This branch is new version, if you are looking for old bash version of static-php-cli, see [bash-version](https://github.com/crazywhalecc/static-php-cli/tree/bash-version).
|
|
|
|
[]()
|
|
[]()
|
|
[](https://github.com/crazywhalecc/static-php-cli/actions/workflows/build.yml)
|
|
|
|
## Compilation Requirements
|
|
|
|
Yes, this project is written in PHP, pretty funny.
|
|
But php-static-cli runtime only requires an environment above PHP 8.0 and tokenizer extension.
|
|
|
|
- Linux
|
|
- Supported arch: aarch64, amd64
|
|
- Supported distributions: alpine, ubuntu, centos
|
|
- Requirements: make, bison, flex, pkg-config, git, autoconf, automake, tar, unzip, gzip, bzip2, cmake
|
|
- 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 compile version: 7.4, 8.0, 8.1, 8.2
|
|
- Self required version: 8.0, 8.1, 8.2
|
|
|
|
## Usage
|
|
|
|
Please first select the extension you want to compile based on the extension list below.
|
|
|
|
### Supported Extensions
|
|
|
|
[Support Extension List](/ext-support.md)
|
|
|
|
### GitHub Actions Build
|
|
|
|
Use GitHub Action to easily build a statically compiled PHP and phpmicro,
|
|
and at the same time define the extensions to be compiled by yourself.
|
|
|
|
1. Fork me.
|
|
2. Go to the Actions of the project and select `CI`.
|
|
3. Select `Run workflow`, fill in the PHP version you want to compile, the target type, and the list of extensions.
|
|
4. After waiting for about a period of time, enter the corresponding task and get `Artifacts`.
|
|
|
|
If you enable `debug`, all logs will be output at build time, including compiled logs, for troubleshooting.
|
|
|
|
### Manual Build
|
|
|
|
```bash
|
|
# Clone first
|
|
git clone https://github.com/crazywhalecc/static-php-cli.git
|
|
cd static-php-cli
|
|
composer update
|
|
chmod +x bin/spc
|
|
# Check system tool dependencies, and show instructions for fixing (TODO)
|
|
# ./spc doctor
|
|
# fetch all libraries
|
|
./bin/spc fetch --all
|
|
# with bcmath,openssl,tokenizer,sqlite3,pdo_sqlite,ftp,curl extension, build both CLI and phpmicro SAPI
|
|
./bin/spc build bcmath,openssl,tokenizer,sqlite3,pdo_sqlite,ftp,curl --build-all
|
|
```
|
|
|
|
You can also use the parameter `--with-php=x.y` to specify the downloaded PHP version, currently supports 7.4 ~ 8.2:
|
|
|
|
```bash
|
|
./bin/spc fetch --with-php=8.2 --all
|
|
```
|
|
|
|
If anything goes wrong, use `--debug` option to display full terminal output:
|
|
|
|
```bash
|
|
./bin/spc build openssl --debug
|
|
./bin/spc fetch --all --debug
|
|
```
|
|
|
|
### php-cli Usage
|
|
|
|
> php-cli is a single static binary, which is similar with Go, Rust single-file binary.
|
|
|
|
When using the parameter `--build-all` or not adding the `--build-micro` parameter,
|
|
the final compilation result will output a binary file named `./php`,
|
|
which can be distributed and used directly.
|
|
This file will be located in the directory `source/php-src/sapi/cli/`, simply copy it out for use.
|
|
|
|
```bash
|
|
./php -v
|
|
./php -m
|
|
./php your_code.php
|
|
```
|
|
|
|
### micro.sfx Usage
|
|
|
|
> phpmicro is a Self-Extracted Executable SAPI module, provided by [dixyes/phpmicro](https://github.com/dixyes/phpmicro).
|
|
> This project is integrated with it.
|
|
|
|
When using the parameter `--build-all` or `--build-micro`,
|
|
the final compilation result will output a file named `./micro.sfx`,
|
|
which needs to be used with your PHP source code like `code.php`.
|
|
This file will be located in the path `buildroot/bin/micro.sfx`, simply copy it out for use.
|
|
|
|
Prepare your project source code, which can be a single PHP file or a Phar file, for use.
|
|
|
|
```bash
|
|
echo "<?php echo 'Hello world' . PHP_EOL;" > code.php
|
|
cat micro.sfx code.php > single-app && chmod +x single-app
|
|
./single-app
|
|
|
|
# If packing a PHAR file, simply replace code.php with the Phar file path.
|
|
```
|
|
|
|
> In some cases, PHAR files may not run in a micro environment.
|
|
|
|
## Current Status
|
|
|
|
- [X] Basic CLI framework (by `symfony/console`)
|
|
- [X] Linux support
|
|
- [X] macOS support
|
|
- [X] Exception handler
|
|
- [ ] Windows support
|
|
- [X] PHP 7.4 support
|
|
|
|
More functions and features are coming soon, Bugs and TODOs: https://github.com/crazywhalecc/static-php-cli/issues/32
|
|
|
|
## Contribution
|
|
|
|
Currently, there are only a few supported extensions.
|
|
If the extension you need is missing, you can create an issue.
|
|
If you are familiar with this project, you are also welcome to initiate a pull request.
|
|
|
|
The basic principles for contributing are as follows:
|
|
|
|
- This project uses php-cs-fixer and phpstan as code formatting tools. Before contributing, please run `composer analyze` and `composer cs-fix` on the updated code.
|
|
- If other open source libraries are involved, the corresponding licenses should be provided.
|
|
Also, configuration files should be sorted using the command `sort-config` after modification.
|
|
For more information about sorting commands, see the documentation.
|
|
- Naming conventions should be followed, such as using the extension name registered in PHP for the extension name itself,
|
|
and external library names should follow the project's own naming conventions. For internal logic functions, class names, variables, etc.,
|
|
camelCase and underscore formats should be followed, and mixing within the same module is prohibited.
|
|
- When compiling external libraries and creating patches, compatibility with different operating systems should be considered.
|
|
|
|
## 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:
|
|
|
|
- [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)
|
|
|
|
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.
|
|
|
|
Please use the `dump-license`(TODO) command to export the open source licenses used in the project after compilation,
|
|
and comply with the corresponding project's LICENSE.
|
|
|
|
## Advanced
|
|
|
|
This project is pure open source project, and some modules are separated for developing.
|
|
|
|
This section will be improved after refactor version released.
|