preg_replace_callback no PHP: substituir cada match com uma função

O preg_replace troca padrão por texto fixo. Quando o texto novo precisa ser calculado a partir do que foi encontrado, ele não serve, e o modificador /e que fazia essa gambiarra foi removido no PHP 7.0. O que sobrou, e é melhor mesmo, é o preg_replace_callback.

Caso concreto: pegar uma descrição de produto e baixar 10% em todo preço que aparecer no meio do texto.

<?php
$texto = 'Camiseta por R$ 89,90 e boné por R$ 45,00 até domingo.';

$comDesconto = preg_replace_callback(
    '/R$s*(d{1,3}(?:.d{3})*),(d{2})/u',
    static function (array $m): string {
        $valor = (float) (str_replace('.', '', $m[1]) . '.' . $m[2]);
        return 'R$ ' . number_format($valor * 0.9, 2, ',', '.');
    },
    $texto
);

echo $comDesconto;
// Camiseta por R$ 80,91 e boné por R$ 40,50 até domingo.

A função recebe um array: $m[0] é o trecho inteiro que casou, $m[1] e $m[2] são os parênteses. Ela roda uma vez por ocorrência, e o que você devolver entra no lugar. Repare que eu tiro o ponto de milhar antes de converter para float, porque (float) '1.299' em PHP dá 1.299, e não mil duzentos e noventa e nove.

As duas pegadinhas

A primeira: devolva string já formatada. O PHP converte o retorno sem reclamar, então um float 80.91 entra no seu texto em português com ponto decimal, e valor grande ainda pode sair em notação científica. O number_format dentro do callback resolve.

A segunda: quando a regex estoura em tempo de execução — backtracking demais num texto longo, ou /u num texto que não é UTF-8 válido — a função devolve null em vez de lançar erro. Você acha que limpou a string e na verdade zerou ela. Com texto vindo do usuário, teste o retorno e caia no original se vier nulo; o preg_last_error_msg() diz o que aconteceu, tipo Backtrack limit exhausted.

Para aplicar padrões diferentes com funções diferentes na mesma string, existe o preg_replace_callback_array, que recebe um mapa de regex para função e deixa o código bem mais limpo que três chamadas encadeadas.