NativePHP:让 PHP 开发桌面应用程序更轻松

什么是 NativePHP？

NativePHP 是一种技术，通过将 PHP 代码编译成原生二进制代码，使开发者能够使用 PHP 语言来构建原生应用程序。与传统的 PHP 脚本不同，NativePHP 应用程序可以直接在操作系统的本机环境中运行，无需依赖 Web 服务器或解释器。

NativePHP 的优势

• 性能提升：由于 NativePHP 应用程序是以原生二进制形式运行的，相比传统的 PHP 脚本，它们通常具有更高的执行速度和更低的资源消耗，从而提供更好的性能体验。

• 跨平台支持：NativePHP 可以在多个操作系统上运行，包括 Windows、macOS、Linux 等。这使得开发者可以使用相同的代码库构建跨平台的原生应用，节省了开发资源和时间。

• 访问系统功能：NativePHP 应用程序可以直接访问操作系统的本机功能和 API，如文件系统、网络、图形界面等。这为开发者提供了更多的灵活性和功能扩展的可能性。

• 现有 PHP 生态系统：NativePHP 可以利用庞大的 PHP 生态系统和第三方库，这意味着开发者可以重用现有的 PHP 代码和工具，加速应用开发过程。

NativePHP 应用开发实践

为了深入研究 NativePHP，我决定将一个 Laravel 应用程序转换为桌面应用程序。为了让您更好地理解，让我们从基本设置开始。以下是应用程序的基本设置：后端由 Laravel 提供，前端由 React 提供，数据库由 MySQL 提供。

NativePHP 的注意事项

在深入研究 NativePHP 之前，请注意以下事项：

• Alpha 阶段：NativePHP 仍处于 alpha 阶段，因此可能存在缺陷或不稳定性。
• Laravel 框架：NativePHP 专为 Laravel 设计，虽然与其他 PHP 框架兼容，但可能存在兼容性问题。
• 数据库限制：NativePHP 仅支持本地 SQLite 数据库，在构建时将替换现有的数据库设置。
• 交叉编译限制：NativePHP 支持针对不同操作系统进行构建，但不支持跨架构构建。例如，在 Apple M1上构建的二进制文件无法在大多数 Linux 和 - Windows 机器上运行。解决方法是使用不同的机器或 CI/CD 管道进行构建。

如何安装NativePHP

首先，我们使用 Composer 安装 NativePHP：

composer require nativephp/electron

这会将 NativePHP 添加到您的 Laravel 应用程序中，并通过一组新的 NativePHP 特定命令扩展 Laravel 的 artisan 工具。例如，您可以使用 php artisan native 命令来查看用于构建和管理本机应用程序的命令列表。

接下来，运行 php artisan native:install 命令会建立基本结构。

其中两个文件特别值得注意：

开发构建

设置应用程序后，我们就可以开始开发构建了。

php artisan native:serve &npm run dev &

这将启动 PHP 和 UI 的开发服务器。在本例中，npm 使用 Vite 构建 UI 组件并将其提供给 Electron 窗口。

NativePHP 将应用程序与 Electron 捆绑在一起，并嵌入了 PHP 解释器。在开发过程中，它将后端切换到本地 SQLite 数据库。因此，我们需要运行迁移命令 php artisan native:migrate 来设置新数据库。

添加本机功能

为了增强桌面体验，NativePHP 支持集成本机元素，例如通知、菜单栏和热键。您可以在文档页面中查看完整的元素列表。

我通过编辑 app/Providers/NativeAppServiceProvider.php，在应用程序启动时添加了一个简单的通知。这有助于我们为应用程序提供原生感觉。

首先，我们添加通知外观：

use Native\Laravel\Facades\Notification;

然后，在 boot() 函数中，我添加以下行，在窗口打开后显示通知：

Notification::title('Application Started')
->message('This message is coming from NativePHP running on Electron')
->show();

保存后，热重载功能应该重新启动应用程序并显示通知。如果您没有看到通知，请检查您是否已启用来自 Electron 的通知。

构建发布

对于生产环境的构建，您需要在 config/nativephp.php 文件中填写发布详细信息。请注意，环境文件 (.env) 将被捆绑在构建中，因此您需要使用 cleanup_env_keys 方法来清理敏感数据。

要为您的操作系统构建版本，请运行以下命令：

php artisan native:build

此过程将生成各种捆绑包，包括 DMG、Zip 文件和应用程序的二进制文件。

我们还可以使用以下命令来构建 Windows 和 Linux 捆绑包：

php artisan native:build winphp artisan native:build linux

构建过程完成后，您将获得以下文件：

• setup.exe（Windows 安装程序）
• AppImage（Linux 应用程序）
• .deb（Linux 软件包）

总结