Skip to content

WINDOWS.md

Latest commit

 

History

History
189 lines (134 loc) · 7.94 KB

WINDOWS.md

File metadata and controls

189 lines (134 loc) · 7.94 KB
Raw

phpup on Windows

Bare-metal PHP development environment for Windows 10/11 x64. Apache, PHP, MariaDB, and phpMyAdmin — installed, configured, and ready to use.

Prerequisites

  • Windows 10 or 11 (x64 only — Intel/AMD 64-bit; ARM64 is not supported)
  • Run as Administrator (required for port 80 binding and service registration)
  • Visual C++ Redistributable — VC++ 2015–2022 x64, minimum version 14.51.36231. phpup checks on startup and offers a one-click upgrade if needed.

Quick Start

Right-click PowerShell → Run as Administrator, then:

irm https://raw.githubusercontent.com/DaFa66/phpup/HEAD/phpup.ps1 | iex

After launching, press I to install. On subsequent runs the script remembers your setup and goes straight to the dashboard.

PowerShell Alias (Optional)

Add this to your PowerShell profile for a quick phpup command:

function phpup {
    $command = "irm https://raw.githubusercontent.com/DaFa66/phpup/HEAD/phpup.ps1 | iex"
    Start-Process pwsh `
        -Verb RunAs `
        -ArgumentList "-NoProfile", "-ExecutionPolicy", "Bypass", "-Command", $command
}

Note: pwsh is PowerShell 7+. For Windows PowerShell 5.1, replace with powershell.

Directory Layout

All components install to C:\phpup\ by default:

C:\phpup\
├── apache\          # Apache Lounge (VS18, port 80)
├── php\             # PHP 8.x thread-safe x64
├── mariadb\         # MariaDB
├── www\             # ← Your websites go here
│   └── phpinfo.php  # (auto-created test file)
├── phpmyadmin\      # phpMyAdmin (at stack root)
├── downloads\       # Cached component zips
├── logs\            # All log files
│   ├── apache_error.log
│   ├── apache_access.log
│   ├── php_errors.log
│   └── mariadb_error.log
├── data_backup\     # (created on delete — databases preserved)
└── config_backup\   # (created on delete — config files preserved)

Component Sources

Component Source
Apache Apache Lounge
PHP windows.php.net
MariaDB mariadb.org
phpMyAdmin phpmyadmin.net

Version Resolution

phpup doesn't hardcode version numbers. Every install and update dynamically resolves the latest stable release:

Component Source Method
Apache Apache Lounge Scrapes download page, picks highest VS version × Apache version
PHP windows.php.net Queries releases.json, filters for 8.x TS x64, prefers VS17
MariaDB mariadb.org REST API, sorts by support policy (Rolling > LTS), then version
phpMyAdmin phpmyadmin.net Scrapes downloads page for latest stable all-languages.zip

What the Installer Configures

Apache

  • Port 80, ServerName localhost:80
  • DocumentRoot with Options Indexes FollowSymLinks
  • mod_rewrite enabled with AllowOverride All — .htaccess rewrites work out of the box
  • PHP module loaded automatically
  • phpMyAdmin alias at /phpmyadmin
  • Error and access logs written to logs/

PHP

  • Extensions: curl, fileinfo, gd, intl, mbstring, mysqli, openssl, pdo_mysql, pdo_sqlite, sodium, sqlite3
  • display_errors = On
  • Error log routed to logs/php_errors.log
  • OPCache enabled with 256 MB memory, JIT tracing, 100 MB buffer
  • PHP dependency DLLs copied to Apache bin/ for clean extension loading
  • Added to user PATH

SQLite3 DLL Fix

VS17 PHP builds bundle an incompatible libsqlite3.dll that causes "Entry Point Not Found" popups. The installer downloads a compatible DLL from sqlite.org and replaces it in both the PHP root and Apache bin/.

MariaDB

  • Data directory initialized with blank root password
  • my.ini with error log routed to logs/mariadb_error.log
  • Latest stable release resolved via REST API
  • Added to user PATH

phpMyAdmin

  • Auto-generated config.inc.php with blowfish secret and blank-password root login
  • Version check disabled (no phoning home on login)
  • 4-hour session timeout
  • Template cache directory configured
  • Configuration storage database (pma) with bookmark, history, and designer support

Offline Mode & Version Switching

Run with -Offline to skip all network activity:

.\phpup.ps1 -Offline

Requires pre-downloaded zips in C:\phpup\downloads\. Run the script online once to populate the cache, then all subsequent installs skip downloads entirely.

Once multiple versions are cached, the hidden fu command lets you switch between them interactively — upgrades, downgrades, or snapshots — without touching the network. MariaDB databases are automatically backed up and restored across version changes.

Service Registration

During install, you're prompted to register Apache and MariaDB as Windows services for auto-start on boot. If you skip it, the S toggle will offer registration later. Services are named phpup_Apache and phpup_MariaDB. The dashboard shows current registration state and the S command works in both directions — it can also unregister services when they're no longer needed.

Safe Delete

Pressing D stops services, backs up your config files (httpd.conf, php.ini, my.ini, config.inc.php) to config_backup\ and MariaDB data to data_backup\, then removes Apache, PHP, MariaDB, and phpMyAdmin. Your website files in www\ are untouched.

On reinstall, the script detects both backups and offers to restore your databases and config files — MariaDB picks up the restored data without re-initialisation, and your Apache, PHP, and phpMyAdmin settings are preserved.

Persistent Config

The script saves state to %APPDATA%\phpup\config.json:

  • Install path — prompted once, remembered thereafter
  • Component versions — tracked after each install/update
  • Service registration state — persisted between runs
  • PATH entries — tracked for clean uninstall

Example:

{
  "install_path": "C:\\phpup",
  "installed_at": "2026-06-05T20:45:00",
  "services_registered": true,
  "versions": {
    "apache": "2.4.67",
    "php": "8.5.7",
    "mariadb": "12.3.2",
    "phpmyadmin": "5.2.3"
  }
}

Config is cleared when you delete the stack. The next run prompts for a fresh install path.

After Installation

Question Answer
Where to put website files? C:\phpup\www
Test your PHP setup? http://localhost/phpinfo.php
Access phpMyAdmin? http://localhost/phpmyadmin
Login to phpMyAdmin? Username: root / Password: (blank)
PHP from terminal? php and mysql available in PATH

Uninstalling

Press D to delete the stack. Your website files in www\ and databases in data_backup\ are preserved. PATH entries are removed and config is cleared.

For a complete wipe, delete C:\phpup\ and %APPDATA%\phpup\ manually after running Delete.

Known Limitations

  • Windows ARM64 not supported. Apache Lounge and MariaDB do not provide native ARM64 Windows binaries. The script detects ARM64 at startup and exits.

Support

Open an issue or submit a pull request.