Bny.php

一个简易的 PHP CLI 工具链，基于 V 语言 开发。

    __                        __
   / /_  ____  __  __  ____  / /_  ____
  / __ \/ __ \/ / / / / __ \/ __ \/ __ \
 / /_/ / / / / /_/ / / /_/ / / / / /_/ /
/_.___/_/ /_/\__, (_) .___/_/ /_/ .___/
            /____/ /_/         /_/

Bny: v0.0.0 PHP: 已安装 Composer: 已安装 XXXX-XX-XX XX:XX:XX

用法:
  bny <指令> [参数] [选项]


指令:
  run                   运行主程序
  php                   运行PHP
  composer              运行Composer
  compile               编译项目
  android               打包为Android apk
  add                   添加/选择php版本
  search                搜索php版本
  delete                删除php版本
  lists                 查看已安装的php
  clean                 清理缓存垃圾

选项:
  -h                      显示帮助信息
  -v                      显示版本信息

特性

• 轻量简洁，无需复杂配置
• PHP 版本管理，支持多版本切换
• 项目一键编译，将 PHP CLI 项目打包为单个可执行文件
• Android APK 打包，WebView 壳 + 内嵌 PHP 运行时
• 内置 Composer 支持

平台支持

平台	架构	状态
Windows	x86_64	已支持
Linux	x86_64, aarch64	已支持
macOS	arm64	已支持

快速开始

安装

下载对应平台的预编译版本，添加到系统 PATH 即可使用。

基本用法

# 查看帮助
bny -h

# 查看版本
bny -v

# 运行 PHP 脚本
bny run index.php

# 运行 Composer 命令
bny composer require package/name

# 添加 PHP 版本
bny add 8.4

# 切换 PHP 版本
bny add 8.5

# 查看已安装的 PHP 版本
bny lists

# 编译当前项目
bny compile .

# 编译为指定名称
bny compile index.php -o myapp

# 编译为指定名称并设置图标
bny compile index.php -o myapp -icon app.ico

编译配置

在项目根目录创建 bny.json 配置文件：

{
    "title": "我的应用",
    "name": "myapp",
    "main": "./index.php",
    "icon": "./icon.png",
    "ini": "./php.ini",
    "define": [
        "memory_limit=256M",
        "max_execution_time=300"
    ],
    "ignore": [
        "runtime/",
        ".git/",
        "test/"
    ]
}

配置说明

字段	类型	说明
title	string	项目显示名称，可中文（安卓应用名、Linux 桌面名），默认按 name
name	string	编译产物文件名 (默认: 按入口文件名，如 index.php -> index)
main	string	项目入口文件 (默认: ./index.php)
icon	string	应用程序图标路径
ini	string	PHP 配置文件路径
define	array	PHP 运行参数，与 php -d 相同
ignore	array	打包时忽略的文件或文件夹

Android 打包

bny android .                                # debug 包, 双架构(真机+模拟器)
bny android ./index.php                      # 指定入口文件, 以其所在目录为项目根
bny android . -arch aarch64                  # 仅真机(arm64-v8a)
bny android . -arch x86_64                   # 仅模拟器
bny android . -release                       # release 包(未签名)
bny android . -o myapp -icon icon.png        # 产物名与图标
bny android . -ver 2.0 -code 20              # 版本名/版本号

-arch / -ver / -code / -o / -icon 等命令行选项优先级高于 bny.json 配置。与 compile 一致：. 走当前目录（有 bny.json 则读取），指定入口文件则以入口所在目录为项目根（产物名默认按入口文件名推导）。

环境要求（需自行准备，环境变量方式配置）：

变量	要求
JAVA_HOME	JDK 17+
ANDROID_HOME	Android SDK（platform 34、build-tools 34）

字段	类型	默认	说明
port	int	8787	服务端口，App 内 WebView 访问 http://127.0.0.1:<port>
start	string	-S 127.0.0.1:8787 ./	启动命令。默认为 php 内置服务器；框架项目守护化（如 ./start.php start -d）
stop	string	空	停止命令。留空为前台模式（App 退出时直接结束进程）；框架项目填 ./start.php stop 优雅停止
arch	string	all	架构：aarch64（真机）/ x86_64（模拟器）/ all（双架构）
ver	string	1.0	版本名 (versionName)
code	int	1	版本号 (versionCode)

框架项目示例：

{
    "title": "我的应用",
    "name": "myapp",
    "main": "./start.php",
    "android": {
        "port": 8787,
        "start": "./start.php start -d",
        "stop": "./start.php stop",
        "arch": "aarch64",
        "ver": "1.0",
        "code": 1
    }
}

内置服务器自定义示例（纯 PHP 项目，无需 stop）：

{
    "name": "myapp",
    "main": "./index.php",
    "android": {
        "port": 8787,
        "start": "-S 127.0.0.1:8787 -t ./"
    }
}

说明：

• 适用常驻服务型 PHP 项目：框架项目（webman/workerman 等）start 守护化、配 stop 优雅停止；内置服务器（php -S）start 填 php 选项、不配 stop，App 打开自动启动、退出自动停止
• ignore 与 compile 一致：命中的文件/文件夹不会打包进 apk（如 runtime/、.git/，默认已含）
• 产物：<name>-v<版本>-<debug|release>.apk，adb install -r 安装
• 真机为 arm64-v8a，模拟器（如 MuMu）为 x86_64

编译说明

• Windows 是采用 EVB 进行封包, 内存运行 ，安全指数：⭐⭐⭐⭐
• Linux 是采用 AppImage 进行封包, 解压运行 ，安全指数：无
• MacOs 仅封装为 .app 目录结构，open/双击 运行, 安全指数：无
• Android 是采用 Gradle 打包 WebView壳+内嵌PHP 的 APK，App打开即启动 ，安全指数：⭐⭐

Linux compile 运行/打包要求

apt install -y file
export APPIMAGE_EXTRACT_AND_RUN=1

许可证

MIT License