Konwertuj PHP na EXE

Program Windows, kiosk lub dystrybucja offline może wymagać pliku .exe zamiast serwera webowego i przeglądarki. Spakowanie aplikacji PHP jako pliku wykonywalnego pozwala użytkownikom uruchamiać ją w systemie Windows bez osobnego instalowania i konfigurowania PHP, Apache lub Nginx.

Czym jest format PHP

.php identyfikuje plik źródłowy PHP, a nie samodzielną aplikację. Zawiera kod PHP wykonywany po stronie serwera i może również zawierać szablony HTML; interfejs może zależeć od oddzielnych plików CSS, JavaScript, obrazów, plików konfiguracyjnych, pakietów Composer, baz danych i rozszerzeń PHP.

Apache, Nginx lub inny kompatybilny serwer zwykle przekazuje pliki PHP do interpretera PHP. Dlatego aplikacje utworzone za pomocą Laravel, Symfony, WordPress i podobnych frameworków wymagają kompletnego środowiska projektu, a nie tylko jednego pliku .php. Programiści edytują PHP w Visual Studio Code, PhpStorm lub innym edytorze tekstu.

Czym jest format EXE

.exe to plik wykonywalny systemu Windows, zazwyczaj korzystający z formatu Portable Executable. Windows może uruchamiać go jako program desktopowy lub wiersza poleceń, z uwzględnieniem architektury, uprawnień i zasad bezpieczeństwa.

W przypadku projektów PHP plik EXE jest zazwyczaj spakowanym środowiskiem uruchomieniowym i launcherem, a nie kodem PHP przekonwertowanym na natywny kod maszynowy. Pakiet może zawierać interpreter PHP dla Windows, pliki aplikacji, lokalny serwer webowy i osadzony silnik przeglądarki. Umożliwia to tworzenie narzędzi offline, wewnętrznych programów narzędziowych, kiosków i interfejsów w stylu aplikacji desktopowych na komputerach z systemem Windows bez osobno skonfigurowanego serwera PHP.

Jak spakować PHP jako EXE

Użycie ExeOutput for PHP

ExeOutput for PHP to komercyjne narzędzie do pakowania dla systemu Windows, przeznaczone do przekształcania aplikacji webowych PHP w aplikacje desktopowe. Osadza środowisko uruchomieniowe PHP i interfejs przeglądarki; sprawdź, czy bieżące wydanie obsługuje wersję PHP i rozszerzenia używane przez projekt.

1. Najpierw uruchom aplikację w zwykłym środowisku lokalnym i sprawdź routing, dostęp do bazy danych, przesyłanie plików, uwierzytelnianie oraz wymagane rozszerzenia PHP.
2. Utwórz projekt w ExeOutput for PHP i wybierz główny katalog dokumentów aplikacji oraz stronę początkową, na przykład index.php.
3. Dodaj kod źródłowy PHP, szablony, CSS, JavaScript, obrazy, zależności Composer, pliki konfiguracyjne i inne zasoby wymagane w czasie działania. Wyklucz pliki używane wyłącznie podczas programowania, takie jak .git, testy, pamięci podręczne i lokalne dane uwierzytelniające.
4. Wybierz osadzoną wersję PHP i włącz wszystkie wymagane rozszerzenia dla systemu Windows, takie jak mbstring lub pdo_mysql. Używaj wersji rozszerzeń zgodnych z systemem Windows, odpowiadających wersji PHP oraz architekturze 32-bitowej lub 64-bitowej.
5. Skonfiguruj początkowy URL, nazwę aplikacji, ikonę, zachowanie okna, katalogi z prawem zapisu, ustawienia bazy danych i opcje instalatora, a następnie użyj polecenia build lub compile projektu.
6. Przetestuj wygenerowany plik wykonywalny w czystym systemie Windows. Przed dystrybucją sprawdź obsługę ścieżek, przepisywanie URL, uprawnienia do plików, drukowanie, certyfikaty, zewnętrzne API, połączenia z bazą danych oraz działanie programu antywirusowego lub SmartScreen.

Użycie PHP Desktop

PHP Desktop to alternatywa open source, która łączy środowisko uruchomieniowe PHP, lokalny serwer webowy i okno przeglądarki oparte na Chromium. Poszczególne wydania różnią się obsługiwanymi wersjami PHP, Chromium i Windows, dlatego wybierz utrzymywane wydanie zgodne z aplikacją.

1. Pobierz odpowiednie wydanie PHP Desktop i skopiuj aplikację do jego katalogu głównego serwera webowego.
2. Ustaw główny katalog dokumentów, stronę początkową, taką jak index.php, opcje okna i inne ustawienia w pliku settings.json.
3. Skopiuj pakiety Composer, zasoby i kompatybilne rozszerzenia PHP do pakietu, a następnie przetestuj go w czystej instalacji systemu Windows.
4. Rozpowszechniaj kompletny katalog aplikacji lub utwórz instalator za pomocą narzędzia takiego jak Inno Setup. PHP Desktop nie jest koniecznie kompilatorem EXE tworzącym pojedynczy plik.

Starsze narzędzia, takie jak Bambalam PHP EXE Compiler, są przeznaczone dla przestarzałych wydań PHP. Używaj ich wyłącznie w przypadku starszego kodu, który został przetestowany z dokładnie tym środowiskiem uruchomieniowym; nie są odpowiednim wyborem domyślnym dla PHP 8, współczesnych frameworków i aplikacji wymagających nowoczesnych rozszerzeń.

Konwertery online i alternatywy

Nie istnieje renomowany konwerter online ogólnego przeznaczenia, który niezawodnie przekształcałby aplikację webową PHP w działający plik EXE dla systemu Windows. Taka usługa musiałaby otrzymać kompletne drzewo kodu źródłowego, zależności Composer, rozszerzenia PHP, konfigurację serwera i być może dane bazy danych; przesłanie tych materiałów ujawnia również kod źródłowy i dane uwierzytelniające.

Usługi online do uruchamiania lub kompilowania PHP są przydatne podczas testowania małych przykładów kodu, ale nie do tworzenia dystrybuowalnej aplikacji desktopowej. Zamiast tego użyj lokalnego narzędzia do pakowania dla systemu Windows i usuń dane uwierzytelniające z plików konfiguracyjnych przed kompilacją.

Ograniczenia zgodności

Ta konwersja oznacza pakowanie, a nie kompilację natywną. Interpreter PHP nadal działa w czasie wykonywania, a rezultat pozostaje zależny od systemu Windows. Moduły Apache, reguły przepisywania Nginx, zadania cron, usługi Docker, polecenia powłoki Linux, obserwatory plików i zarządzane przez serwer procesy działające w tle mogą wymagać przeprojektowania.

Zależności Composer i rozszerzenia muszą odpowiadać dołączonej wersji PHP oraz architekturze systemu Windows. Rozszerzeń Linux nie można skopiować do pakietu dla systemu Windows. Zastąp zakodowane na stałe ścieżki webowe, separatory ścieżek Linux, niedostępne zmienne środowiskowe, założenia dotyczące przepisywania po stronie serwera oraz nieodpowiednie ustawienia połączenia z bazą danych.

Dołączony plik EXE nie gwarantuje ochrony kodu źródłowego: pliki PHP i zasoby aplikacji mogą zostać wyodrębnione. Nie umieszczaj haseł do baz danych, kluczy API, kluczy prywatnych ani innych danych uwierzytelniających w plikach przeznaczonych do dystrybucji; w odpowiednich przypadkach używaj chronionej konfiguracji, usługi zdalnej lub magazynu poświadczeń systemu Windows.