NativePHP桌面版篇〡新手必学入门实践指南

概述

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

环境要求

  1. PHP 8.3+
  2. Laravel 11或者更高
  3. Node 22+
  4. Windows 10+ / macOS 12+ / Linux

NativePHP 的最佳开发体验是直接在开发计算机上运行 PHP 和 Node。

“请注意，虽然可以从虚拟化环境或容器开发和运行应用程序，但您可能会遇到更多意外问题，并且需要更多手动步骤来创建工作版本。

示例项目

克隆示例代码

官方仓库：

代码语言：javascript代码运行次数：0运行复制
git clone git@github:NativePHP/kitchen-sink.git

安装后端依赖

通过composer工具安装依赖

代码语言：javascript代码运行次数：0运行复制
composer install

出现以下界面表示安装成功，否则请自行根据错误提示解决环境和依赖包冲突问题

代码语言：javascript代码运行次数：0运行复制
> Illuminate\Foundation\ComposerScripts::postAutoloadDump
>@phpartisanpackage:discover--ansi

   INFODiscoveringpackages.

laravel/dusk.......................................DONE
laravel/tinker.....................................DONE
livewire/livewire.....................................DONE
nativephp/electron.....................................DONE
nativephp/laravel.....................................DONE
nesbot/carbon.....................................DONE
nunomaduro/collision.....................................DONE
nunomaduro/termwind.....................................DONE

安装前端依赖

代码语言：javascript代码运行次数：0运行复制
npm i

启动开发模式

代码语言：javascript代码运行次数：0运行复制
composer native:dev

请确保命令全部执行完成出现以下界面

代码语言：javascript代码运行次数：0运行复制
> Composer\Config::disableProcessTimeout
> npx concurrently -c "#93c5fd,#fb7185" -k "php artisan native:serve --no-interaction""npm run dev" --names=app,vite
[vite] 
[vite] > dev
[vite] > vite
[vite]
[vite] 
[vite]   VITE v6.2.5  ready in563 ms
[vite]
[vite]   ➜  Local:   http://localhost:5173/
[vite]   ➜  Network: use --host to expose
[app]
[app]   Starting NativePHP dev server... 
[app]
[app]  Fetching latest dependencies...
[app]
[app]  Installing NPM dependencies (This may take a while)...
[app]
[app]  Installing NPM dependencies using the npm package manager...
[app]
[app]  Fetching latest dependencies...
[app]
[vite] 
[vite]   LARAVEL v12.8.1  plugin v1.2.0
[vite]
[vite]   ➜  APP_URL: 
[app] 
[app]  Starting NativePHP app
[app]
[app]   Copying latest CA Certificate... 
[app]
[app]  Running the dev script with npm...
[app]
[app]  Fetching latest dependencies...
[app]

就是这样！您现在应该看到您的 Laravel 应用程序在本机桌面窗口中运行。