プラグインで使用される関数を廃止する方法は？

プラグインで使用している関数の1つは、（別のプラグインで使用されている）別の関数と衝突する可能性のある名前でグローバルスコープを汚染することです。だから、私はそれを廃止すべきだと思います。しかし、それについてどうすればよいですか？

function foo() {
    echo 'bar';
}

私は承知のだ_deprecate_function()が、私は私のプラグインのコアから機能を除去するために取るべきすべての手順を示す一例に感謝することでしょう。

参照：https : //developer.wordpress.org/reference/functions/_deprecated_function/

@Welcherによる答えに加えて：

コアにはいくつかの良い「墓地」の例があり、そこでは「機能が消滅する」。

これらは、ドキュメントなどに関するガイドラインとして使用できます。

ここに1つのそのような例だpermalink_link()下には、wp-includes/deprecated.php

/**
 * Print the permalink of the current post in the loop.
 *
 * @since 0.71
 * @deprecated 1.2.0 Use the_permalink()
 * @see the_permalink()
 */
function permalink_link() {
        _deprecated_function( __FUNCTION__, '1.2', 'the_permalink()' );
        the_permalink();
}

_deprecated_function入力引数を説明する関数のインラインドキュメントは次のとおりです。

/**
 * Mark a function as deprecated and inform when it has been used.
 *
 * There is a hook deprecated_function_run that will be called that can be used
 * to get the backtrace up to what file and function called the deprecated
 * function.
 *
 * The current behavior is to trigger a user error if WP_DEBUG is true.
 *
 * This function is to be used in every function that is deprecated.
 *
 * @since 2.5.0
 * @access private
 *
 * @param string $function    The function that was called.
 * @param string $version     The version of WordPress that deprecated the function.
 * @param string $replacement Optional. The function that should have been called. 
 *                            Default null.
 */

非推奨は必ずしも削除されることと同じではありません。通常、アイテムはAPIからのEVENTUAL削除のマークが付けられていることを意味します。これは、他のプラグインや開発者のように、外部から呼び出されるメソッドですか？このメソッドがプラグインによって内部でのみ使用されている場合は、おそらく安全に削除して、より良い名前の関数に置き換えてください。

そうでない場合、私はより良い名前の関数を作成し、コールでそれを呼び出す名前の悪い名前を持ってい__doing_it_wrongます- コーデックスでそれについて読んでくださいこれは他の開発者にメソッドへの参照を更新する時間を与え、メソッドを安全に削除できますそれ以降のバージョン。

function badly_named() {

    __doing_it_wrong( 'badly_named', 'This method has been deprecated in favor of better_named_function' );

    /**
     * Call the better named method
     */
     better_named_function();
}

お役に立てれば！

新しいプラグインを作成し、現在のプラグインがEOLであるため、それに移行するようユーザーにアドバイスします。

プラグインやテーマの作成者が公開APIを変更し、それを「もう1つの小さなアップグレード」として扱うことほど面倒なことはありません。ユーザーが実際に影響を受けていない問題のために、サイトを破壊する理由はありません。

私は次のようなものを提案します：

/**
 * @deprecated Please use good_function_name() instead
 * @since x.y.z Marked deprecated in favor of good_function_name()
 * @see good_function_name()
 */
function bad_function_name() {
    trigger_error(
        'The ' . __FUNCTION__ . ' function is deprecated. ' .
        'Please use good_function_name() instead.',
        defined( 'E_USER_DEPRECATED' ) ? E_USER_DEPRECATED : E_USER_WARNING
    );

    return good_function_name();
}

これには、スタックトレースとともにログに非推奨の警告を表示する効果があります。当然、これはWordPressでロギングが有効になっている場合にのみ機能します。

E_USER_DEPRECATED定数はPHP 5.3.0でのみ導入されたため、三項演算子があります。古いバージョンでは、代わりに単純なユーザー警告にフォールバックできます。

エラー定数に関するPHPマニュアルから：

E_DEPRECATEDランタイム通知。これを有効にすると、将来のバージョンでは機能しないコードに関する警告を受け取ることができます。

_doing_it_wrongまたは__deprecated_functionを使用したくないのは、これらの関数がWordPressコアのみを対象としているためです。これらの関数のコードリファレンスから：

この関数のアクセスはプライベートとしてマークされます。これは、プラグインやテーマ開発者による使用を目的としておらず、他のコア機能でのみ使用することを意味します。完全を期すためにここにリストされています。