Replace first occurrence of the search string with the replacement string.

gistfile1.php

<?php

/**
 * Replace first occurrence of the search string with the replacement string.
 *
 * @param string $needle : The value being searched for.
 * @param string $replace : The replacement value that replaces found search  values.
 * @param string $haystack : The string being searched and replaced on.
 * @return string : The (modified) haystack.
 * @author tapken at engter dot de
 * @link http://theserverpages.com/php/manual/en/function.str-replace.php#21735
 */
function str_replace_once( $needle, $replace, $haystack )
{
	if ( ( $pos = strpos( $haystack, $needle ) ) === false )
		return $haystack;
	
	return substr_replace( $haystack, $replace, $pos, strlen( $needle ) );
} // End of str_replace_once