fix(examples): move nginx-zip to provided.al2023, drop the PHP examples (#832)

* fix(examples): use provided.al2023 runtime in nginx-zip

`provided.al2` was deprecated on 2026-07-31 (creation disabled 2027-02-01,
updates 2027-03-03), so `sam validate --lint` flags it as W2531 and the
examples workflow fails.

Verified the example still works on AL2023 by mounting the Nginx123X86:12
layer contents at /opt in public.ecr.aws/lambda/provided:al2023: nginx 1.23.3
starts, `GET /` returns 200 and `GET /images/space.jpeg` returns the 1.3 MB
binary response with no errors logged. The layer's only bundled library is
libcrypt.so.1, which resolves from /opt/lib on the default LD_LIBRARY_PATH.

* chore(examples): drop the PHP examples

Both PHP examples were built on artifacts frozen in March 2023 that are tied to
Amazon Linux 2, and neither can move to AL2023 without those artifacts being
rebuilt:

- `php-zip` used the `Php82FpmNginx{X86,Arm}:13` layers. On `provided.al2023`
  php-fpm still starts, but the extensions declared in `php/php.d/extensions.ini`
  fail to load because they link against AL2-only libraries: `openssl`, `curl`
  and `ftp` need `libssl.so.10`/`libcrypto.so.10` (OpenSSL 1.0.2), `awscrt` needs
  `libcrypto.so.10`, `gd` needs `libpng15.so.15`, and `imagick` needs
  `libfontconfig.so.1`. AL2023 ships OpenSSL 3.x, so a user extending the example
  would silently lose HTTPS/TLS support.
- `php` (Docker) is based on `public.ecr.aws/awsguru/php:82.2023.3.11.1`, the same
  AL2 build of PHP 8.2.

Rather than ship examples whose runtime is deprecated (`provided.al2`, creation
disabled 2027-02-01) or whose extension set is quietly broken, drop them. Neither
example was covered by the `test-image` or `test-zip` CI matrices, so no test
coverage is lost. `README.md` still points PHP users at Bref, and the guide still
lists Laravel on Lambda as a community example.

Author: bnusunny

.github/workflows/examples.yaml

@@ -79,7 +79,7 @@ jobs:
   # Docker-based examples verified with sam local start-api. Each matrix entry
   # asserts an exact status (and optional body substring) via verify-http.sh,
   # not just liveness.
-  # Excluded: nginx, php, flask, aspnet-mvc (web app hardcodes port 8080
+  # Excluded: nginx, flask, aspnet-mvc (web app hardcodes port 8080
   # which conflicts with SAM's Lambda Runtime Interface Emulator).
   test-image:
     needs: [build-layer]
@@ -175,7 +175,7 @@ jobs:
   # `port` is the app's listening port, passed through to the adapter via the
   # PORT parameter; it must differ from SAM's RIE port (8080).
   # Excluded: aspnet-*-zip (hardcode port 8080),
-  # bun/nginx/php-zip (need third-party layers), arm64 examples (javalin, rust-*),
+  # bun/nginx (need third-party layers), arm64 examples (javalin, rust-*),
   # nextjs-zip (Makefile produces a zip artifact incompatible with sam local).
   test-zip:
     needs: [build-layer]

README.md

@@ -96,7 +96,6 @@ The readiness check port/path and traffic port can be configured using environme
 - [SpringBoot in Zip](examples/springboot-zip)
 - [SpringBoot Response Streaming](examples/springboot-response-streaming-zip)
 - [Nginx](examples/nginx)
-- [PHP](examples/php)
 - [Rust Actix Web in Zip](examples/rust-actix-web-zip)
 - [Rust Axum in Zip](examples/rust-axum-zip)
 - [Golang Gin](examples/gin)

docs/guide/src/examples/overview.md

@@ -76,8 +76,6 @@ The repository includes working examples for many popular web frameworks, packag
 |---------|-----------|-----------|
 | [Nginx](https://github.com/aws/aws-lambda-web-adapter/tree/main/examples/nginx) | Docker | No |
 | [Nginx in Zip](https://github.com/aws/aws-lambda-web-adapter/tree/main/examples/nginx-zip) | Zip | No |
-| [PHP](https://github.com/aws/aws-lambda-web-adapter/tree/main/examples/php) | Docker | No |
-| [PHP in Zip](https://github.com/aws/aws-lambda-web-adapter/tree/main/examples/php-zip) | Zip | No |
 | [Deno Oak in Zip](https://github.com/aws/aws-lambda-web-adapter/tree/main/examples/deno-zip) | Zip | No |
 | [Ruby Sinatra](https://github.com/aws/aws-lambda-web-adapter/tree/main/examples/sinatra) | Docker | No |
 

examples/nginx-zip/template.yaml

@@ -18,7 +18,7 @@ Resources:
       Architectures:
         - x86_64
       Handler: bootstrap
-      Runtime: provided.al2
+      Runtime: provided.al2023
       Environment:
         Variables:
           RUST_LOG: debug