플러그인에 사용 된 함수를 더 이상 사용하지 않는 방법은 무엇입니까?

플러그인에서 사용하는 함수 중 하나는 다른 함수 (다른 플러그인에서 사용)와 충돌 할 수있는 이름으로 전역 범위를 오염시키는 것입니다. 따라서 더 이상 사용하지 않아야한다고 생각합니다. 하지만 어떻게해야합니까?

function foo() {
    echo 'bar';
}

나는 알고 _deprecate_function()있지만 플러그인 코어에서 함수를 제거하기 위해 취해야 할 모든 단계를 보여주는 예제에 감사 할 것입니다.

참조 : https://developer.wordpress.org/reference/functions/_deprecated_function/

@Welcher의 답변 외에도 :

핵심 에는 몇 가지 좋은 " 묘지 "예제가 있으며, 여기서 " 기능이 죽게됩니다 ".

문서와 같은 지침으로 사용할 수 있습니다.

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를 변경하고이를 "소규모의 다른 업그레이드"로 취급하려고하는 것보다 더 성가신 것은 없습니다. 사용자가 실제로 영향을받지 않는 문제로 인해 사이트를 중단 할 이유가 없습니다.

나는 다음과 같은 것을 제안 할 것이다 :

/**
 * @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 핵심 전용이기 때문입니다. 해당 함수에 대한 코드 참조에서

이 기능의 액세스는 비공개로 표시됩니다. 이는 플러그인이나 테마 개발자가 다른 핵심 기능에서만 사용할 수 없음을 의미합니다. 완전성을 위해 여기에 나열되어 있습니다.