ddev-openlitespeed

Replaces DDEV’s default web server (nginx/apache-fpm) with OpenLiteSpeed running lsphp (the LiteSpeed SAPI PHP), so you can develop and test against a real OpenLiteSpeed stack locally.

Built on DDEV’s webserver_type: generic mechanism (the add-on needs DDEV v1.24.10+), the same one the official ddev-frankenphp add-on uses.

What you get

• OpenLiteSpeed serving your project over the normal https://<project>.ddev.site URL.
• lsphp as the PHP runtime (real LiteSpeed SAPI, not php-fpm behind a proxy) — the LiteSpeed SAPI of DDEV’s own PHP build, so it has the same extensions, php.ini, .ddev/php/*.ini overrides, timezone, ddev xdebug and ddev xhprof as nginx-fpm / apache-fpm (see docs/php-parity.md).
• Correct HTTPS for PHP behind the DDEV router: $_SERVER['HTTPS'], SERVER_PORT and REQUEST_SCHEME reflect the real scheme, so is_ssl() / isSecure(), redirects and absolute-URL generation work (no mixed-content or redirect loops).
• LSCache advertised to the LiteSpeed Cache plugin (X-LSCACHE), so the plugin detects the server and can drive page caching.
• PHP version follows DDEV (ddev config --php-version=… && ddev restart).
• Project .htaccess is honoured for front-controller rewrites (WordPress, Drupal, Laravel, …), like apache-fpm.
• DDEV’s own 404 and 403 (directory without an index file) pages, like nginx-fpm / apache-fpm (DDEV v1.25.4+); your app’s own error responses pass through.
• OLS logs stream to ddev logs -f.

Install

ddev add-on get morvy/ddev-openlitespeed
ddev restart

PHP versions

Every PHP version DDEV supports (5.6–8.5). Set one with ddev config --php-version=<version> && ddev restart.

lsphp is php<version>-litespeed from the same repository as DDEV’s php<version>-fpm, installed in the web container. Installing it may move the image’s php<version>-* packages to that repository’s current patch release (all together).

PHP 8.6 needs a DDEV release newer than v1.25.4 (DDEV refuses to start it before that); the add-on needs no change for it.

How it works

Inside the web container, two supervised daemons run as the project’s (non-root, code-owning) user:

Request flow: ddev-router terminates public TLS and forwards plain HTTP to OLS on :80 (with X-Forwarded-Proto); OLS restores the HTTPS server vars and proxies PHP over LSAPI to lsphp on 127.0.0.1:9000.

Why lsphp is a separate process: this OLS build has no working suEXEC/cgid helper, so OLS cannot fork lsphp itself (cgidSuEXEC failed). lsphp runs as its own daemon and the external app uses autoStart 0 (connect-only).

Known limitations

• No WebAdmin console. OpenLiteSpeed’s admin console runs its own PHP as an internal worker that needs the same (broken) suEXEC helper, so it can’t run in this container. It’s disabled; configure OpenLiteSpeed by editing the files under .ddev/web-build/openlitespeed/ and running ddev restart.

Uninstall

ddev add-on remove openlitespeed
ddev restart

Removes the #ddev-generated files and reverts webserver_type to your project’s previous value. Upgrading from v1.0.x removes its lsphp sidecar files.

Releasing

Push a version tag; the release workflow runs the full PHP matrix against it and publishes a GitHub release only if every job passes:

git tag v1.1.0
git push origin v1.1.0

License

Apache-2.0 — see LICENSE.