Převod souboru PHP do EXE

Program pro Windows, kiosk nebo offline distribuce může vyžadovat .exe namísto webového serveru a prohlížeče. Zabalení PHP aplikace jako spustitelného souboru umožňuje uživatelům spustit ji v systému Windows bez samostatné instalace a konfigurace PHP, Apache nebo Nginx.

Co je formát PHP

.php označuje zdrojový soubor PHP, nikoli samostatnou aplikaci. Obsahuje serverový kód PHP a může obsahovat také HTML šablony; rozhraní může záviset na samostatných souborech CSS, JavaScriptu, obrázcích, konfiguračních souborech, balíčcích Composer, databázích a rozšířeních PHP.

Apache, Nginx nebo jiný kompatibilní server obvykle předává soubory PHP interpretu PHP. Aplikace vytvořené pomocí Laravel, Symfony, WordPress a podobných frameworků proto vyžadují kompletní projektové prostředí, nikoli pouze jeden soubor .php. Vývojáři upravují PHP pomocí Visual Studio Code, PhpStorm nebo jiného textového editoru.

Co je formát EXE

.exe je spustitelný soubor systému Windows, který obecně používá formát Portable Executable. Windows jej může spustit jako desktopový program nebo program příkazového řádku v závislosti na architektuře, oprávněních a zásadách zabezpečení.

U projektů PHP je EXE obvykle zabalený runtime a spouštěč, nikoli PHP převedené do nativního strojového kódu. Balíček může obsahovat Windows interpreter PHP, soubory aplikace, místní webový server a vložený prohlížečový engine. To podporuje offline nástroje, interní utility, kiosky a rozhraní ve stylu desktopových aplikací na počítačích s Windows bez samostatně nakonfigurovaného serveru PHP.

Jak zabalit PHP jako EXE

Použití ExeOutput for PHP

ExeOutput for PHP je komerční nástroj pro balení v systému Windows určený k převodu webových aplikací PHP na desktopové aplikace. Vkládá runtime PHP a rozhraní prohlížeče; ověřte, že jeho aktuální vydání podporuje verzi PHP a rozšíření používaná projektem.

1. Nejprve spusťte aplikaci v běžném místním prostředí a ověřte směrování, přístup k databázi, nahrávání souborů, ověřování a požadovaná rozšíření PHP.
2. Vytvořte projekt v ExeOutput for PHP a vyberte kořenový adresář dokumentů aplikace a úvodní stránku, například index.php.
3. Přidejte zdrojový kód PHP, šablony, CSS, JavaScript, obrázky, závislosti Composer, konfigurační soubory a další prostředky potřebné za běhu. Vylučte soubory určené pouze pro vývoj, například .git, testy, mezipaměti a místní tajné údaje.
4. Vyberte vloženou verzi PHP a povolte všechna požadovaná rozšíření Windows, například mbstring nebo pdo_mysql. Použijte sestavení rozšíření kompatibilní s Windows, která odpovídají verzi PHP a 32bitové nebo 64bitové architektuře.
5. Nakonfigurujte úvodní URL, název aplikace, ikonu, chování okna, adresáře s možností zápisu, nastavení databáze a možnosti instalačního programu, poté použijte příkaz pro sestavení nebo kompilaci projektu.
6. Otestujte vygenerovaný spustitelný soubor v čistém systému Windows. Před distribucí zkontrolujte práci s cestami, přepisování URL, oprávnění k souborům, tisk, certifikáty, externí API, připojení k databázi a chování antiviru nebo SmartScreen.

Použití PHP Desktop

PHP Desktop je open-source alternativa, která kombinuje runtime PHP, místní webový server a okno prohlížeče založené na Chromiu. Jednotlivá vydání se liší podporovanými verzemi PHP, Chromia a Windows, proto vyberte udržované vydání kompatibilní s aplikací.

1. Stáhněte odpovídající vydání PHP Desktop a zkopírujte aplikaci do jeho kořenového adresáře webu.
2. Nastavte kořenový adresář dokumentů, úvodní stránku, například index.php, možnosti okna a další nastavení v souboru settings.json.
3. Zkopírujte balíčky Composer, prostředky a kompatibilní rozšíření PHP do balíčku a poté jej otestujte v čisté instalaci Windows.
4. Distribuujte kompletní adresář aplikace nebo vytvořte instalační program pomocí nástroje, jako je Inno Setup. PHP Desktop nemusí být kompilátor EXE vytvářející jediný soubor.

Starší utility, například Bambalam PHP EXE Compiler, cílí na zastaralá vydání PHP. Používejte je pouze pro starší kód, který byl otestován s jejich přesným runtime; pro PHP 8, aktuální frameworky a aplikace vyžadující moderní rozšíření nejsou vhodnou výchozí volbou.

Online převodníky a alternativy

Neexistuje žádný obecně použitelný renomovaný online převodník, který by dokázal spolehlivě převést webovou aplikaci PHP na funkční EXE pro Windows. Služba by potřebovala kompletní strom zdrojových souborů, závislosti Composer, rozšíření PHP, konfiguraci serveru a případně data databáze; nahrání tohoto materiálu navíc odhaluje zdrojový kód a přihlašovací údaje.

Online služby pro spouštění nebo kompilaci PHP jsou užitečné k testování malých ukázek kódu, nikoli k vytváření distribuovatelné desktopové aplikace. Místo toho použijte místní nástroj pro balení v systému Windows a před sestavením odstraňte z konfiguračních souborů tajné údaje.

Omezení kompatibility

Tato konverze představuje balení, nikoli nativní kompilaci. Interpreter PHP stále běží za běhu a výsledná aplikace zůstává specifická pro Windows. Moduly Apache, pravidla přepisování Nginx, úlohy cron, služby Docker, příkazy shellu Linuxu, sledování souborů a serverem spravované pracovní procesy na pozadí mohou vyžadovat přepracování.

Závislosti Composer a rozšíření musí odpovídat přibalené verzi PHP a architektuře Windows. Rozšíření Linuxu nelze zkopírovat do balíčku pro Windows. Nahraďte napevno zadané webové cesty, oddělovače cest Linuxu, nedostupné proměnné prostředí, předpoklady týkající se přepisování na serveru a nevhodná nastavení připojení k databázi.

Přibalený EXE nezaručuje ochranu zdrojového kódu: soubory PHP a prostředky aplikace mohou být extrahovány. Nevkládejte do distribuovatelných souborů hesla k databázi, tajné klíče API, soukromé klíče ani jiné přihlašovací údaje; podle potřeby použijte chráněnou konfiguraci, vzdálenou službu nebo úložiště přihlašovacích údajů Windows.