setup shutdown function

[simonLeary42]

This replaces the white screen of death with a generic error message with a unique error identifier. #292

[simonLeary42]

• TODO record demo video

uncaught exception

1 file changed, 2 insertions(+)
webroot/admin/user-mgmt.php | 2 ++

modified   webroot/admin/user-mgmt.php
@@ -85,3 +85,5 @@ require $LOC_HEADER;
 
 <?php
 require $LOC_FOOTER;
+
+throw new RuntimeError("deleteme");

Screen.Recording.2025-09-10.at.8.53.47.AM.mov

caught exception

1 file changed, 6 insertions(+)
resources/init.php | 6 ++++++

modified   resources/init.php
@@ -141,3 +141,9 @@ $LOC_HEADER = __DIR__ . "/templates/header.php";
 $LOC_FOOTER = __DIR__ . "/templates/footer.php";
 
 register_shutdown_function(array("UnityWebPortal\lib\UnitySite", "shutdown"));
+
+try {
+    throw new RuntimeException("deleteme");
+} catch(RuntimeException) {
+    echo "caught";
+}

Screen.Recording.2025-09-10.at.9.10.04.AM.mov

redirect

Screen.Recording.2025-09-10.at.9.16.48.AM.mov

[Copilot]

Pull Request Overview

This PR implements a generic error handling mechanism to replace the white screen of death with user-friendly error messages that include unique error identifiers for debugging purposes.

• Adds a shutdown function to catch fatal errors and display a generic error message
• Updates error handling methods to clear last error to prevent interference
• Simplifies SSO error handling by removing explicit try-catch and letting the shutdown function handle errors

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File	Description
resources/lib/UnitySite.php	Adds shutdown function for error handling and clears errors in badRequest/forbidden methods
resources/init.php	Registers the shutdown function and removes explicit SSO error handling
test/functional/InvalidEPPNTest.php	Updates test to expect SSOException instead of PhpUnitNoDieException

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[simonLeary42]

• TODO fix errors on front page in dev environment so that demo will work as intended

[bryank-cs]

Why not put the support email here like in the old message?

[simonLeary42]

because UnityConfig isn't exposed inside UnitySite

[bryank-cs]

Any reason it can't be?

[simonLeary42]

support email included:

[Copilot]

Pull Request Overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[simonLeary42]

UnitySite::forbidden works as expected with its error_clear_last():

[simonLeary42]

fcb5437

[simonLeary42]

d9e2ef9

[simonLeary42]

5c36b54