Converti PHP in EXE

Un programma Windows, un chiosco o una distribuzione offline può richiedere un .exe invece di un server web e un browser. Il packaging dell’applicazione PHP come eseguibile consente agli utenti di avviarla su Windows senza installare e configurare separatamente PHP, Apache o Nginx.

Cos'è il formato PHP

.php identifica un file sorgente PHP, non un’applicazione autonoma. Contiene codice PHP lato server e può contenere anche template HTML; l’interfaccia può dipendere da CSS, JavaScript, immagini, file di configurazione, pacchetti Composer, database ed estensioni PHP separati.

Apache, Nginx o un altro server compatibile normalmente passa i file PHP all’interprete PHP. Le applicazioni create con Laravel, Symfony, WordPress e framework simili richiedono quindi l’intero ambiente del progetto, non solo un file .php. Gli sviluppatori modificano PHP con Visual Studio Code, PhpStorm o un altro editor di testo.

Cos'è il formato EXE

.exe è un eseguibile Windows, generalmente basato sul formato Portable Executable. Windows può avviarlo come programma desktop o da riga di comando, in base all’architettura, alle autorizzazioni e ai criteri di sicurezza.

Per i progetti PHP, un EXE è normalmente un runtime e launcher raggruppati, non PHP convertito in codice macchina nativo. Il pacchetto può contenere l’interprete PHP per Windows, i file dell’applicazione, un server web locale e un motore browser incorporato. Ciò consente di utilizzare strumenti offline, utility interne, chioschi e interfacce in stile desktop su computer Windows senza un server PHP configurato separatamente.

Come creare un pacchetto PHP come EXE

Usare ExeOutput for PHP

ExeOutput for PHP è uno strumento commerciale di packaging per Windows progettato per trasformare le applicazioni web PHP in applicazioni desktop. Incorpora il runtime PHP e l’interfaccia browser; verificare che la versione attuale supporti la versione PHP e le estensioni utilizzate dal progetto.

1. Eseguire innanzitutto l’applicazione in un normale ambiente locale e verificare il routing, l’accesso al database, i caricamenti, l’autenticazione e le estensioni PHP richieste.
2. Creare un progetto in ExeOutput for PHP e selezionare la root dei documenti dell’applicazione e la pagina iniziale, ad esempio index.php.
3. Aggiungere il codice sorgente PHP, i template, CSS, JavaScript, immagini, dipendenze Composer, file di configurazione e altre risorse necessarie a runtime. Escludere i file utilizzati solo durante lo sviluppo, come .git, test, cache e credenziali locali.
4. Selezionare la versione PHP incorporata e abilitare tutte le estensioni Windows richieste, come mbstring o pdo_mysql. Utilizzare build delle estensioni compatibili con Windows e corrispondenti alla versione PHP e all’architettura a 32 o 64 bit.
5. Configurare l’URL di avvio, il nome dell’applicazione, l’icona, il comportamento della finestra, le directory scrivibili, le impostazioni del database e le opzioni del programma di installazione, quindi usare il comando di build o compilazione del progetto.
6. Testare l’eseguibile generato su un sistema Windows pulito. Verificare la gestione dei percorsi, la riscrittura degli URL, le autorizzazioni dei file, la stampa, i certificati, le API esterne, le connessioni al database e il comportamento dell’antivirus o di SmartScreen prima della distribuzione.

Usare PHP Desktop

PHP Desktop è un’alternativa open source che combina un runtime PHP, un server web locale e una finestra del browser basata su Chromium. Le versioni disponibili differiscono per le versioni supportate di PHP, Chromium e Windows; selezionare una versione mantenuta e compatibile con l’applicazione.

1. Scaricare la versione corrispondente di PHP Desktop e copiare l’applicazione nella relativa directory web-root.
2. Impostare la root dei documenti, la pagina di avvio come index.php, le opzioni della finestra e altre impostazioni in settings.json.
3. Copiare i pacchetti Composer, le risorse e le estensioni PHP compatibili nel bundle, quindi testarlo su un’installazione Windows pulita.
4. Distribuire la directory completa dell’applicazione oppure creare un programma di installazione con uno strumento come Inno Setup. PHP Desktop non è necessariamente un compilatore EXE a file singolo.

Le utility meno recenti come Bambalam PHP EXE Compiler sono destinate a versioni obsolete di PHP. Utilizzarle solo per codice legacy testato con il relativo runtime esatto; non sono una scelta predefinita adatta a PHP 8, ai framework attuali e alle applicazioni che richiedono estensioni moderne.

Convertitori online e alternative

Non esiste un convertitore online generico e affidabile in grado di trasformare un’applicazione web PHP funzionante in un EXE Windows. Un servizio dovrebbe ricevere l’intero albero dei sorgenti, le dipendenze Composer, le estensioni PHP, la configurazione del server ed eventualmente i dati del database; il caricamento di questo materiale espone inoltre il codice sorgente e le credenziali.

I servizi online per l’esecuzione o la compilazione di PHP sono utili per testare piccoli esempi di codice, non per produrre un’applicazione desktop distribuibile. Utilizzare invece uno strumento locale di packaging per Windows e rimuovere le informazioni riservate dai file di configurazione prima della build.

Limitazioni di compatibilità

Questa conversione è un packaging, non una compilazione nativa. L’interprete PHP continua a essere eseguito a runtime e il risultato rimane specifico per Windows. I moduli Apache, le regole di riscrittura Nginx, i cron job, i servizi Docker, i comandi della shell Linux, i file watcher e i worker in background gestiti dal server possono richiedere una riprogettazione.

Le dipendenze Composer e le estensioni devono corrispondere alla versione PHP incorporata e all’architettura Windows. Le estensioni Linux non possono essere copiate in un bundle Windows. Sostituire i percorsi web codificati staticamente, i separatori dei percorsi Linux, le variabili d’ambiente non disponibili, le ipotesi sulle regole di riscrittura del server e le impostazioni non adatte per la connessione al database.

Un EXE raggruppato non garantisce la protezione del codice sorgente: i file PHP e le risorse dell’applicazione possono essere estratti. Non incorporare password del database, segreti API, chiavi private o altre credenziali nei file distribuibili; utilizzare, ove appropriato, una configurazione protetta, un servizio remoto o un archivio delle credenziali Windows.