จะเลิกใช้ฟังก์ชั่นที่ใช้ในปลั๊กอินได้อย่างไร?

หนึ่งในฟังก์ชั่นที่ฉันใช้ในปลั๊กอินของฉันคือสร้างมลภาวะระดับโลกด้วยชื่อที่สามารถชนกับฟังก์ชั่นอื่น (ใช้ในปลั๊กอินอื่น) ดังนั้นฉันคิดว่าฉันควรเลิกใช้แล้ว แต่ฉันจะไปเกี่ยวกับเรื่องนั้นได้อย่างไร

function foo() {
    echo 'bar';
}

ฉันตระหนักถึง_deprecate_function()แต่จะขอบคุณสำหรับตัวอย่างที่แสดงขั้นตอนทั้งหมดที่ฉันควรทำเพื่อที่จะลบฟังก์ชั่นออกจากแกนหลักของปลั๊กอินของฉัน

Ref: 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.
 */

การตัดค่าเสื่อมราคาไม่เท่ากับการลบเสมอโดยปกติจะหมายถึงรายการนั้นถูกทำเครื่องหมายสำหรับการลบ EVENTUAL จาก API นี่เป็นวิธีการที่จะถูกเรียกจากภายนอก - เช่นเดียวกับปลั๊กอินหรือนักพัฒนาอื่น ๆ หรือไม่? หากวิธีการนี้ใช้โดยปลั๊กอินเท่านั้นภายในคุณสามารถลบออกได้อย่างปลอดภัยด้วยฟังก์ชันชื่อที่ดีกว่า

ถ้าไม่ฉันจะสร้างฟังก์ชั่นที่มีชื่อดีกว่าและมีหนึ่งชื่อที่ไม่ดีด้วยการ__doing_it_wrongโทร - อ่านเกี่ยวกับมันในcodexนี้จะให้เวลานักพัฒนาอื่น ๆ ที่จะปรับปรุงการอ้างอิงถึงวิธีการและคุณสามารถลบวิธีใน รุ่นที่ใหม่กว่า

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 หลักเท่านั้น จากการอ้างอิงรหัสในฟังก์ชั่นเหล่านั้น:

การเข้าถึงฟังก์ชั่นนี้ถูกทำเครื่องหมายเป็นส่วนตัว นี่หมายความว่ามันไม่ได้มีไว้สำหรับใช้โดยปลั๊กอินหรือผู้พัฒนาธีมเฉพาะในฟังก์ชั่นหลักอื่น ๆ มันอยู่ที่นี่เพื่อความสมบูรณ์