php字符串只替换一次

<?php
/**
 * 字符串只替换一次
 * @param string $str 替换前的字符串
 * @param string $needle 需要替换的字符串
 * @param string $replace 替换后的字符串
 */
function str_replace_once($str, $needle, $replace) {
   $pos = strpos($str, $needle);
   if ($pos === false) {
      return $str;
   }
   return substr_replace($str, $replace, $pos, strlen($needle));
}