TypePHP 编译器
https://swoole.com/aot/
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
120 lines
3.2 KiB
120 lines
3.2 KiB
# Win32 Hello World 示例
|
|
|
|
这是一个使用 PHPX 编译器创建的最简单 Windows 图形界面程序示例。
|
|
|
|
## 项目结构
|
|
|
|
```
|
|
win32-hello/
|
|
├── hello-win.php # 主程序（使用 C++ 辅助函数）
|
|
├── window.php # 纯 PHP 版本（需要 Windows API 声明）
|
|
├── main.php # 最简单的消息框示例
|
|
├── cpp-src/
|
|
│ └── winapi.cc # C++ 实现的 Windows API 封装
|
|
└── project.yml # 项目配置文件
|
|
```
|
|
|
|
## 编译和运行
|
|
|
|
### 方法 1: 使用项目配置（推荐）
|
|
|
|
```powershell
|
|
cd examples\win32-hello
|
|
php ..\..\bin\compiler.php project.yml
|
|
.\build\win32-hello.exe
|
|
```
|
|
|
|
### 方法 2: 直接编译单个文件
|
|
|
|
```powershell
|
|
# 编译最简单的版本
|
|
php bin\compiler.php examples\win32-hello\main.php
|
|
|
|
# 运行
|
|
.\main.exe
|
|
```
|
|
|
|
## 代码说明
|
|
|
|
### C++ 函数导出规范
|
|
|
|
要让 C++ 函数能被 PHP 调用，必须满足以下条件：
|
|
|
|
1. **函数名必须以 `php_` 为前缀**
|
|
- 例如：`php_messagebox()` 在 PHP 中调用时为 `messagebox()`
|
|
|
|
2. **只能使用 PHPX 类型作为参数和返回值**
|
|
- `Int`, `Bool`, `String`, `Double`, `Array`, `Object`, `Variant` 等
|
|
- 不能使用原生 C/C++ 类型（如 `int`, `char*` 等）
|
|
|
|
3. **必须在 `.stub.php` 文件中声明**
|
|
- stub 文件只包含函数签名（参数和返回值）
|
|
- 不包含具体实现代码
|
|
- 实现代码在对应的 `.cc` 或 `.cpp` 文件中
|
|
|
|
### 示例结构
|
|
|
|
**1. Stub 声明文件** (`cpp-src/winapi.stub.php`):
|
|
```php
|
|
<?php
|
|
// 只声明函数签名，不包含实现
|
|
function messagebox(int $hWnd, string $text, string $caption, int $uType): int {}
|
|
```
|
|
|
|
**2. C++ 实现文件** (`cpp-src/winapi.cc`):
|
|
```cpp
|
|
#include <phpx.h>
|
|
#include <windows.h>
|
|
|
|
using namespace php;
|
|
|
|
// 函数名必须以 php_ 为前缀
|
|
Int php_messagebox(Int hWnd, String text, String caption, Int uType) {
|
|
return MessageBox((HWND)hWnd, text.c_str(), caption.c_str(), (UINT)uType);
|
|
}
|
|
```
|
|
|
|
**3. PHP 调用文件** (`hello-win.php`):
|
|
```php
|
|
<?php
|
|
// 直接调用，无需额外声明
|
|
function main() {
|
|
$result = messagebox(0, "Hello!", "Title", 0);
|
|
}
|
|
```
|
|
|
|
### 最简单的版本 (main.php)
|
|
|
|
直接使用 Windows API（需要编译器支持原生函数声明）：
|
|
|
|
```php
|
|
#[NativeFunction]
|
|
function MessageBox(int $hWnd, string $lpText, string $lpCaption, int $uType): int {}
|
|
|
|
function main() {
|
|
MessageBox(0, "Hello World!", "标题", 0);
|
|
}
|
|
```
|
|
|
|
## 扩展：创建完整窗口
|
|
|
|
要创建真正的 Windows 窗口（而不是消息框），需要：
|
|
|
|
1. **注册窗口类** (WNDCLASS)
|
|
2. **实现窗口过程函数** (WindowProc)
|
|
3. **创建消息循环** (GetMessage/TranslateMessage/DispatchMessage)
|
|
|
|
这些功能需要在 C++ 层实现，因为涉及到回调函数和复杂的 Windows 数据结构。
|
|
|
|
## 注意事项
|
|
|
|
- Windows API 函数需要通过 `#[NativeFunction]` 声明
|
|
- 复杂的 Windows API 建议在 C++ 层封装
|
|
- 编译时需要链接 Windows 系统库（user32.lib, gdi32.lib 等）
|
|
- 程序必须是 `bin` 模式才能创建图形界面
|
|
|
|
## 参考
|
|
|
|
- [Windows API 文档](https://docs.microsoft.com/en-us/windows/win32/api/)
|
|
- [PHPX 编译器文档](../../docs/README.md)
|
|
- [examples/prime](../prime) - 混合 PHP 和 C++ 的示例
|
|
|