Encoding Guide for PHPX Compiler

Problem

When using Chinese characters in source code, you may encounter garbled text (乱码) like:

Win32 Hello World 绋嬪簭
鏄剧ず娑堟伅妗?..

This happens because:

Windows console uses code page 936 (GBK) by default
Source files are saved as UTF-8
The mismatch causes encoding issues

Solution

Option 1: Use English (Recommended) ✅

All example files now use English to avoid encoding issues:

Before:

echo "显示消息框...\n";

After:

echo "Showing message box...\n";

Option 2: Set Console to UTF-8

If you must use Chinese, set the console code page to UTF-8 before running:

chcp 65001
.\win32_hello.exe

Or in your PHP code, set it programmatically:

function main() {
    // Set console to UTF-8
    exec('chcp 65001 > nul');
    
    echo "显示消息框...\n";
}

Option 3: Use Windows API for Unicode

For message boxes and Windows GUI, use wide character functions:

// In C++ file
Int php_messagebox(Int hWnd, String text, String caption, Int uType) {
    // Convert UTF-8 to UTF-16 for Windows API
    int wtext_len = MultiByteToWideChar(CP_UTF8, 0, text.data(), -1, NULL, 0);
    wchar_t* wtext = new wchar_t[wtext_len];
    MultiByteToWideChar(CP_UTF8, 0, text.data(), -1, wtext, wtext_len);
    
    int wcaption_len = MultiByteToWideChar(CP_UTF8, 0, caption.data(), -1, NULL, 0);
    wchar_t* wcaption = new wchar_t[wcaption_len];
    MultiByteToWideChar(CP_UTF8, 0, caption.data(), -1, wcaption, wcaption_len);
    
    int result = MessageBoxW((HWND)hWnd, wtext, wcaption, (UINT)uType);
    
    delete[] wtext;
    delete[] wcaption;
    return result;
}

Best Practices

Use English for code comments and strings - Most portable solution
Save all files as UTF-8 without BOM - Standard for modern development
Avoid mixing encodings - Keep consistency across all files
Test on target systems - Different Windows versions may have different defaults

Current Status

All files in examples/win32-hello/ now use English:

✅ hello-win.php
✅ main.php
✅ window.php
✅ cpp-src/winapi.cc
✅ cpp-src/winapi.stub.php

Rebuild to see the changes:

php bin\compiler.php examples\win32-hello\project.yml
.\build\win32_hello.exe

Expected output:

========================================
  Win32 Hello World Program
========================================

Showing message box...
Message box return value: 1

Note: To create a full window, you need to implement window procedure and message loop.
This requires WNDCLASS registration and message pump in C++ layer.

Program ended. Press any key to exit...

2.7 KiB Raw Blame History