Project Overview

PyAMPP is an advanced orchestration utility that automates the lifecycle of a WAMP stack. It eliminates the friction of manual configuration by dynamically generating environment-specific parameters at runtime, ensuring a "it just works" experience for local web development.

This software is developed for personal use and internal development purposes. The source code is not available for public distribution or external contribution.

Download

The latest stable version of PyAMPP is available as a standalone executable. You can download it directly from our official releases page on GitHub.

View All Releases

Detailed Features

Version Preset Selection

Choose from a curated list of verified component versions. From legacy PHP 7.4 to the latest 8.4, PyAMPP handles the complex configuration automatically.

Hardened Process Isolation

Improved execution logic prevents DLL conflicts (like VCRUNTIME140.dll mismatches) by running services in a strictly isolated environment.

Smart Reinstallation

Perform clean updates of binaries while strictly preserving your MySQL data directories, preventing "version soup" and ensuring environment stability.

Intelligent Module Mapping

Dynamically detects and maps the correct PHP module (e.g., php7_module vs php_module) based on the active version selection.

Intelligent PHP Configuration

Auto-generates php.ini with pre-configured extensions (mysqli, mbstring, openssl, curl, pdo_mysql, zip, gd, fileinfo, intl, exif, etc.) mapped to absolute local paths.

Global PATH Integration

Integrated PowerShell automation to register the portable PHP binary within the Windows System PATH, enabling CLI usage (composer, artisan, etc.) globally.

LAN Exposure Toggle

Switch between private loopback (localhost) and local network visibility. Automatically detects subnet masks to configure Apache access controls safely.

Real-time Log Aggregator

Captures and streams stdout and stderr from underlying service processes into a centralized dashboard for rapid diagnostic troubleshooting.

Supported Versions (Presets)

PyAMPP v1.0.3 supports a wide range of verified component versions out of the box. For transparency, all official binary download URLs are documented in the presets.json file within the repository.

  • PHP: 8.4.20 (VS17), 8.3.30, 8.2.30, 8.1.34, 8.0.30, 7.4.33
  • Apache: 2.4.66 (VS17)
  • MySQL: 8.4.4 (LTS), 8.0.40, 5.7.44
  • phpMyAdmin: 5.2.3, 5.2.2, 5.2.1

Technical Specifications

  • Core Logic: Python 3.x utilizing the subprocess API for detached process execution.
  • GUI Framework: CustomTkinter for a modern, High-DPI aware Windows 10/11 native look.
  • Networking: Synchronous socket-based port monitoring and automated subnet detection.
  • Architecture: 64-bit optimized (VS17 Runtimes) with hardened isolation logic.
  • Process Isolation: Detached process trees to ensure services remain stable independently of the GUI state.

System Architecture

Designed with a strict separation of concerns:

  • Core Layer: Encapsulates binary management, configuration templating (Apache httpd.conf, MySQL my.ini, PHP php.ini), and low-level process control.
  • GUI Layer: Modular interface components (Dashboard, Setup Wizard, Settings, Global PHP Setup, and Log Aggregator).
  • Automation Layer: PowerShell scripts for system-level integrations and automated environment pathing.

Frequently Asked Questions

Why use PyAMPP instead of a modern Docker-based setup?

While Docker is extremely powerful, it can feel resource-heavy and consume significant storage, especially when building and maintaining multiple containers. PyAMPP provides a lightweight, portable alternative that is much faster to initialize and easier to manage for standard PHP development without the overhead of virtualization.

Is PyAMPP really portable?

Yes. Everything—including binaries, databases, and configurations—is stored within the application's root directory. You can move the entire folder to a USB drive or another machine, and it will work without needing to reinstall dependencies.

Can I add my own custom PHP or MySQL versions?

Currently, PyAMPP uses verified presets defined in presets.json to ensure compatibility and automated configuration. Manual additions are possible by modifying the presets file, though official support is limited to the versions listed.

Does it require Administrator privileges?

Admin privileges are generally not required for basic operation, though they may be needed for specific automation tasks like registering PHP to the System PATH or toggling certain network firewall rules.