Convertir PHP a EXE

Un programa de Windows, un kiosco o una distribución sin conexión puede requerir un .exe en lugar de un servidor web y un navegador. Empaquetar la aplicación PHP como un ejecutable permite a los usuarios iniciarla en Windows sin instalar ni configurar PHP, Apache o Nginx por separado.

Qué es el formato PHP

.php identifica un archivo de código fuente PHP, no una aplicación independiente. Contiene código PHP del lado del servidor y también puede contener plantillas HTML; la interfaz puede depender de CSS, JavaScript, imágenes, archivos de configuración, paquetes de Composer, bases de datos y extensiones de PHP independientes.

Apache, Nginx u otro servidor compatible normalmente pasa los archivos PHP al intérprete de PHP. Por lo tanto, las aplicaciones creadas con Laravel, Symfony, WordPress y frameworks similares requieren su entorno completo del proyecto, no solo un archivo .php. Los desarrolladores editan PHP con Visual Studio Code, PhpStorm u otro editor de texto.

Qué es el formato EXE

.exe es un ejecutable de Windows que generalmente utiliza el formato Portable Executable. Windows puede iniciarlo como un programa de escritorio o de línea de comandos, sujeto a la arquitectura, los permisos y las políticas de seguridad.

En los proyectos PHP, un EXE normalmente es un runtime y launcher empaquetados, no PHP convertido en código máquina nativo. El paquete puede contener el intérprete de PHP para Windows, los archivos de la aplicación, un servidor web local y un motor de navegador integrado. Esto permite utilizar herramientas sin conexión, utilidades internas, kioscos e interfaces de tipo escritorio en equipos Windows sin un servidor PHP configurado por separado.

Cómo empaquetar PHP como un EXE

Usar ExeOutput for PHP

ExeOutput for PHP es una herramienta comercial de empaquetado para Windows diseñada para convertir aplicaciones web PHP en aplicaciones de escritorio. Integra el runtime de PHP y la interfaz del navegador; confirma que su versión actual sea compatible con la versión de PHP y las extensiones utilizadas por el proyecto.

1. Ejecuta primero la aplicación en un entorno local normal y verifica el enrutamiento, el acceso a la base de datos, las cargas de archivos, la autenticación y las extensiones de PHP necesarias.
2. Crea un proyecto en ExeOutput for PHP y selecciona la raíz de documentos de la aplicación y la página inicial, como index.php.
3. Añade el código fuente PHP, las plantillas, CSS, JavaScript, imágenes, dependencias de Composer, archivos de configuración y otros recursos del runtime. Excluye los archivos que solo se utilizan durante el desarrollo, como .git, las pruebas, las cachés y los secretos locales.
4. Selecciona la versión integrada de PHP y habilita todas las extensiones de Windows necesarias, como mbstring o pdo_mysql. Utiliza compilaciones de extensiones compatibles con Windows que coincidan con la versión de PHP y la arquitectura de 32 o 64 bits.
5. Configura la URL de inicio, el nombre de la aplicación, el icono, el comportamiento de la ventana, los directorios con permisos de escritura, la configuración de la base de datos y las opciones del instalador; después, utiliza el comando de compilación o build del proyecto.
6. Prueba el ejecutable generado en un sistema Windows limpio. Comprueba el manejo de rutas, la reescritura de URL, los permisos de archivos, la impresión, los certificados, las API externas, las conexiones a bases de datos y el comportamiento del antivirus o SmartScreen antes de distribuirlo.

Usar PHP Desktop

PHP Desktop es una alternativa de código abierto que combina un runtime de PHP, un servidor web local y una ventana de navegador basada en Chromium. Las versiones difieren en las versiones de PHP, Chromium y Windows compatibles, así que selecciona una versión mantenida que sea compatible con la aplicación.

1. Descarga la versión correspondiente de PHP Desktop y copia la aplicación en su directorio web-root.
2. Configura la raíz de documentos, la página de inicio, como index.php, las opciones de la ventana y otros ajustes en settings.json.
3. Copia los paquetes de Composer, los recursos y las extensiones de PHP compatibles en el paquete y, después, pruébalo en una instalación limpia de Windows.
4. Distribuye el directorio completo de la aplicación o crea un instalador con una herramienta como Inno Setup. PHP Desktop no es necesariamente un compilador de EXE de un solo archivo.

Las utilidades antiguas, como Bambalam PHP EXE Compiler, están destinadas a versiones obsoletas de PHP. Utilízalas únicamente para código heredado que haya sido probado con su runtime exacto; no son opciones predeterminadas adecuadas para PHP 8, frameworks actuales y aplicaciones que requieren extensiones modernas.

Convertidores online y alternativas

No existe un convertidor online general de buena reputación que pueda convertir de forma fiable una aplicación web PHP en un EXE funcional de Windows. Un servicio necesitaría el árbol de código fuente completo, las dependencias de Composer, las extensiones de PHP, la configuración del servidor y posiblemente los datos de la base de datos; además, cargar ese material expone el código fuente y las credenciales.

Los servicios online de ejecución o compilación de PHP son útiles para probar pequeños ejemplos de código, no para producir una aplicación de escritorio distribuible. Utiliza en su lugar una herramienta local de empaquetado para Windows y elimina los secretos de los archivos de configuración antes de realizar la compilación.

Limitaciones de compatibilidad

Esta conversión es empaquetado, no compilación nativa. El intérprete de PHP sigue ejecutándose en runtime y el resultado continúa siendo específico de Windows. Los módulos de Apache, las reglas de reescritura de Nginx, los trabajos de cron, los servicios de Docker, los comandos de shell de Linux, los observadores de archivos y los workers en segundo plano administrados por el servidor pueden requerir un rediseño.

Las dependencias de Composer y las extensiones deben coincidir con la versión integrada de PHP y la arquitectura de Windows. Las extensiones de Linux no se pueden copiar en un paquete de Windows. Sustituye las rutas web codificadas, los separadores de ruta de Linux, las variables de entorno no disponibles, las suposiciones sobre la reescritura del servidor y la configuración inadecuada de las conexiones a bases de datos.

Un EXE integrado no garantiza la protección del código fuente: los archivos PHP y los recursos de la aplicación pueden extraerse. No incrustes contraseñas de bases de datos, secretos de API, claves privadas ni otras credenciales en archivos distribuibles; utiliza una configuración protegida, un servicio remoto o un almacén de credenciales de Windows cuando corresponda.