Convert String to Upper or Lower Case

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.
 */

/**
 * Convert String to Upper or Lower Case.
 *
 * Purpose:
 * Converts text to uppercase or lowercase with an explicit mode value.
 *
 * @param string $text Text to convert.
 * @param string $mode Allowed values: upper or lower.
 * @return array Converted string details.
 */
function ogSnippetConvertStringCase(string $text, string $mode): array {
	$mode = strtolower(trim($mode));
	$converted = $text;
	$applied_mode = 'none';

	if ($mode === 'upper') {
		$converted = strtoupper($text);
		$applied_mode = 'upper';
	} elseif ($mode === 'lower') {
		$converted = strtolower($text);
		$applied_mode = 'lower';
	}

	return array(
		'original' => $text,
		'converted' => $converted,
		'mode' => $applied_mode
	);
}

$case_report = ogSnippetConvertStringCase('Stargate Alpha Site', 'upper');

echo 'Converted text: '.$case_report['converted'];