Features
Wenv does one job on Windows: a PHP site environment in one folder, with components, sites and configuration managed from one interface.
Sites
Sites are the main entry point: domains, ports, certificates and URL rewriting are configured on one page, and the result lands in real Nginx files.
- Domains, IPs or IP + port; up to 100 domains, 20 HTTP ports and 1 HTTPS port per site, with globally unique ports.
- HTTPS accepts a pasted PEM or selected files; the certificate must match the private key and cover every domain via SAN.
- If a domain change leaves the certificate mismatched, HTTPS is disabled and TLS and redirects are removed, but the certificate is kept.
- URL rewriting uses rule text; Wenv generates the config, which you can also edit directly.
- Deleting a site removes its record and Nginx config, keeping site files and certificates.
- Writing to the local hosts file is optional and off by default.
Runtime
Nginx and PHP live under Runtime; MySQL stays in its own section to avoid duplicate entry points.
- One Nginx instance: install, start, stop, configure, logs, uninstall, import another version.
- Multiple PHP versions coexist; sites on the same version share PHP config and processes.
- Extensions: enable or disable bundled ones; import an external DLL as an extension and choose whether to enable it.
- Each component has its own configuration and log entry.
Databases
MySQL is its own module, managed apart from sites and runtime.
- One MySQL instance: install from ZIP or import another version, then initialize the data directory and administrator account.
- Database list, accounts and privileges, configuration, logs, uninstall.
- If initialization fails, the dialog stays open with a readable reason and the original error code.
Software catalog
The catalog is delivered by the cloud; the client only displays, downloads, verifies and installs.
- Queried by three categories: database, language runtime and web server.
- Entries are direct links to official ZIPs; the client downloads in the background, verifies the ZIP structure and extracts it.
- If an older version of the same family exists, confirm the replacement first and review the affected sites; multiple older versions must be uninstalled manually first.
- Uninstall shows the impact before anything is removed.
Import a ZIP
Local import covers three cases: a build not in the catalog, a pinned version, or an offline machine.
- Supports local ZIP archives for Nginx, PHP and MySQL.
- Checks: ZIP structure, per-entry CRC, path traversal, symlinks, encrypted entries, empty packages and total extracted size.
- Conflicts: Nginx and MySQL are single-version; confirm to replace one existing version, and reject multiple versions. PHP allows multiple versions.
- Failures remove the temporary directory and never write into
softs\; retries start from the original archive.
Portable
The program, components, sites and data share one folder; migration and backup are file operations.
| Path | Contents | When moved |
|---|---|---|
| Wenv.exe + resources\ | Program and resources | Copied with the folder |
| softs\ | Nginx / PHP / MySQL / software | Relative paths relocate |
| sites\ | Default site root | Relative paths relocate |
| userdata\ | Config, records, certificates, update history | Copied with the folder |
| download\ | Download cache | Safe to delete |
- Default site roots and software records use paths relative to the component root; copying the folder relocates them.
- Sites with a custom absolute directory keep their original path.
- The built-in updater replaces program files only and leaves
softs\,sites\,download\anduserdata\untouched. - Uninstalling a component deletes its folder and data; deleting the whole Wenv folder also deletes sites and databases, so back up first.
- If the install folder is not writable, the first launch requests permission once to create the data folders; cancelling blocks startup.
Tray, startup and languages
Closing the window does not quit; quitting goes through the tray. Interface language and tray text switch together.
- Closing the main window hides it to the tray; pages, drafts and tasks are kept.
- Quit from the tray; running runtime processes continue, while Wenv maintenance pauses.
- Start at Windows sign-in is off by default and starts Wenv only, not the runtime components.
- Interface languages: English, 简体中文 and 繁體中文; switching applies immediately without a restart or task interruption.
Requirements
| Item | Requirement |
|---|---|
| System | Windows 10 / 11 x64; Windows Server 2019 or later x64 |
| Rights | A standard user is enough; one elevation is needed if the install folder is not writable |
| Disk | Depends on the components you install |
| License | A license key is required; one online activation |
Download the Windows x64 build
Unzip into a writable folder and run Wenv.exe.