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 打包

完整说明见 ANDROID.md：打包命令、配置、环境与 SDK 自动准备、签名、App 架构、以及 PHP/JS 桥接 Android 原生能力。

编译说明

• 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