skoro/tkui

使用 Tk gui 工具包创建桌面应用程序

维护者

详细信息

github.com/skoro/php-tkui

源代码

问题

安装: 94

依赖项: 1

建议者: 1

安全性: 0

星标: 488

关注者: 18

分支: 18

开放问题: 11

v0.2.3 2023-03-06 19:31 UTC

Requires

Requires (Dev)

MIT ed2199cfa524c9142f0d9769613e709a1592e901

  • Oleksii Skorobogatko <skorobogatko.oleksii.woop@gmail.com>

uitoolkitguiwidgetdesktopTktcltk

This package is auto-updated.

Last update: 2024-09-16 19:52:03 UTC

README

php-tkui

php-tkui 允许您仅使用 PHP 构建桌面 UI 应用程序。它利用 FFI 扩展和 Tcl/Tk 来实现这一点，因此您不需要编译或安装任何外部扩展。

要求

  • PHP >= 8.2
  • ffi 扩展必须启用
  • Tcl/Tk >= 8.6

入门指南

确保您的操作系统已安装 Tcl/Tk。对于基于 Debian/Ubuntu 的发行版，您可以使用 apt 安装它

sudo apt install tcl tk

接下来，检查 FFI 扩展是否已启用

php --ri ffi

克隆此存储库并尝试演示

git clone https://github.com/skoro/php-tkui.git php-tkui
cd php-tkui
composer install
php demos/buttons.php

配置

您可以启用一些应用程序功能，例如

  • 调试模式
  • 外观

将提供的 .env.example 复制到 .env 并自定义选项。

调试模式允许您找出由 Tcl 引擎执行的哪些命令。要启用调试模式，请设置

DEBUG=true
DEBUG_LOG=php://stdout

所有调试消息都将输出到控制台。您也可以指定一个文件名而不是控制台。

要更改应用程序的外观，取消注释 THEME 选项并设置以下之一： clam、alt、default、classic。Windows 的附加主题： winnative、xpnative、vista。默认情况下使用 auto，根据操作系统设置主题

THEME=auto

Windows

您需要安装 Tcl/Tk 二进制发行版 之一，并在 .env 文件中设置 dlls 的路径，如下所示

WINDOWS_LIB_TCL=c:\\tcltk\\bin\\tcl86t.dll
WINDOWS_LIB_TK=c:\\tcltk\\bin\\tk86t.dll

此外，您还可以构建自己的 Tcl/Tk 发行版，请参阅 BUILD-WIN.md 文档了解如何操作。

macOS

您需要安装与 Windows 相同的 Tcl/Tk 二进制发行版。最简单的方法是使用 brew 安装它

brew install tcl-tk

然后您需要在 .env 文件中设置 dylibs 的路径

DARWIN_LIB_TCL=/usr/local/Cellar/tcl-tk/[installed_version]/lib/libtcl8.6.dylib
DARWIN_LIB_TK=/usr/local/Cellar/tcl-tk/[installed_version]/lib/libtk8.6.dylib