v5

WebEngine v5 is a substantial refactor of the framework's core. If you've used previous versions, the philosophy will feel familiar and unchanged: start static-first, keep logic close to the URL it serves, and let the framework step aside as quickly as possible. What has changed in v5 is how much cleaner, more testable and more explicit the internals have become.

This release focuses on making the request-response lifecycle easier to reason about, improving support for non-HTML responses, and giving applications more control over redirects, errors and runtime behaviour. A lot of the work in this version is under the bonnet, but it should still be felt directly in day-to-day development.

Read the whole discussion here: https://github.com/orgs/phpgt/discussions/664

November 2023

What's Changed

• feature: domdocument extension by @g105b in #550
• Bump phpgt/dom from 4.0.0 to 4.0.1 by @dependabot in #552
• Bump phpgt/domtemplate from 3.1.0 to 3.1.3 by @dependabot in #555
• Bump phpgt/dom from 4.0.2 to 4.0.3 by @dependabot in #562
• maintenance: dependabot by @g105b in #569
• feature: send csrf tokens in the header by @g105b in #573
• build(deps): bump phpgt/dom from 4.0.3 to 4.1.0 by @dependabot in #574
• build(deps): bump phpgt/servicecontainer from 1.2.0 to 1.2.1 by @dependabot in #575
• Error handling by @g105b in #586
• handle globals in lifecycle by @g105b in #589
• Request handler uri by @g105b in #590
• <title> updates by @g105b in https://github.com//pull/594
• Component binder by @g105b in #641

Full Changelog: v4.0.6...v4.1.0

Simplification of default routing

All URLs now force a trailing slash at the end of the URL path - this is beneficial because it allows client side code and server side headers to reference paths relatively (e.g. Location: ./ for a refresh, Location: ../other-dir/ to redirect to a sibling directory.

The default router has had non-page matches removed for simplicity, until the Router package has documented examples of non-page responses.

PHP 8.1 compatibility

This patch release bumps internal dependencies and resolves PHP 8.1 deprecation notices.

Hotfix for default routing

This hotfix is fixing a typo where *.* was being matched instead of */* in the accept header.

Upgrade internal dependencies

v4.0.3

build: bump dependencies

Default router matches page-route by default

This minor patch change adjusts the behaviour of WebEngine's default router when there isn't an Accept header in the request - it now matches the page-route by default.

v4 release

v4.0.1

build: remove behat dependencies

Upgraded webpack default compilation

This minor patch release updates the way Webpack compilation is performed for ES6 scripts, so that it defaults to a more sensible production mode and specifies the entry script to script/main.es6.

Modularise components

This major release has modularised the components that make up WebEngine. All components are hosted within their own separate PHP.Gt repositories and included using Composer.

This is the first major change to architecture, making the transition to a dependency injected WebEngine in V4 much easier.