Order Number Collision Check

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

/**
 * Order Number Collision Check.
 *
 * Purpose:
 * Checks a generated order number against known identifiers and prepares retry guidance when collisions exist.
 *
 * @param string $candidate_order_number Candidate order number.
 * @param array $existing_order_numbers Existing identifiers.
 * @return array Collision decision.
 */
function ogSnippetOrderNumberCollisionCheck(string $candidate_order_number, array $existing_order_numbers): array {
	$collision = in_array($candidate_order_number, $existing_order_numbers, true);
	$next_action = 'accept';
	if ($collision === true) {
		$next_action = 'regenerate';
	}
	return array('order_number' => $candidate_order_number, 'collision' => $collision, 'next_action' => $next_action);
}

$order_check = ogSnippetOrderNumberCollisionCheck('ORDER-NCC-1701', array('ORDER-NCC-1701', 'ORDER-DS9-009'));
echo $order_check['next_action'];