modX.deprecated

Последнее обновление Oct 11th, 2026 | История страницы | Улучшить эту страницу | Сообщить о проблеме

Support the team building MODX with a monthly donation.

The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.

Backers

Budget

$194 per month—let's make that $500!

Learn more

modX::deprecated¶

Пишет уведомление об устаревании метода, который будет удалён. Вызывайте его первой строкой такого метода: по трассировке определяются и устаревшее описание, и код, который его вызвал.

Вызов пропускается, когда опция log_deprecated выключена; по умолчанию она включена.

Уведомления живут в памяти: по одному на описание, вызывающие накапливаются. При завершении запроса они становятся строками modDeprecatedMethod. В менеджере они перечислены в разделе Reports → Error Log, панель Deprecations Log.

Синтаксис¶

void deprecated (string $since, [string $recommendation = ''], [string $deprecatedDef = ''])

$since (string) версия, в которой функция стала устаревшей
$recommendation (string) совет по замене, по умолчанию ''
$deprecatedDef (string) имя для записи; по умолчанию '' оно выводится из трассировки

Пример¶

function legacy_lookup($modx, $id)
{
    $modx->deprecated('3.1.0', 'Use $modx->getObject instead');

    return $modx->getObject(modResource::class, $id);
}

Смотрите также¶