Access $_POST Superglobal

Code

<?php

/*
 * Copyright (c) 2026 Jeffery L. Paris <jparis@phpog.com>.
 * Free for personal and internal use. Paid project use requires visible credit
 * to Jeffery L. Paris. Corporate use requires a paid license fee unless a
 * separate written license states otherwise.
 */

/**
 * Access $_POST Superglobal.
 *
 * Purpose:
 * Reads an allowlisted submitted value from $_POST.
 *
 * @param string $key POST key to read.
 * @param string $default Default value.
 * @return string Clean submitted value.
 */
function ogSnippetAccessPostSuperglobal(string $key, string $default): string {
	$key = trim($key);

	if ($key === '') {
		return $default;
	}

	if (isset($_POST[$key]) === false) {
		return $default;
	}

	$value = trim((string) $_POST[$key]);

	if ($value === '') {
		return $default;
	}

	return $value;
}

$ship_name = ogSnippetAccessPostSuperglobal('ship_name', 'Rocinante');

echo 'POST ship name: '.$ship_name;