Bir eklentide kullanılan bir işlev nasıl kullanılmaz?

Eklentimde kullandığım işlevlerden biri, küresel kapsamı başka bir işlevle (başka bir eklentide kullanılan) çarpışabilecek bir adla kirletiyor. Yani, sanırım itiraz etmeliyim. Ama bunu nasıl yapmalıyım?

function foo() {
    echo 'bar';
}

Bildiğim _deprecate_function()ama benim eklentinin çekirdeğinden işlevini kaldırmak için almalıdır tüm adımları gösteren bir örnek için minnettar olacaktır.

Ref: https://developer.wordpress.org/reference/functions/_deprecated_function/

@Welcher'ın cevabına ek olarak:

Çekirdekte, " işlevlerin ölmeye başladığı" bazı iyi " mezarlık " örnekleri vardır .

Bunları, örneğin dokümantasyonla ilgili olarak kılavuz olarak kullanabilirsiniz.

İşte permalink_link()altında böyle bir örnekwp-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_functionGirdi bağımsız değişkenlerini açıklayan işlevin satır içi belgeleri şunlardır:

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

Kullanımdan kaldırılma her zaman kaldırılmaya eşit değildir, bu genellikle öğenin API'dan ETKİNLİKLE kaldırılmak üzere işaretlendiği anlamına gelir. Bu, diğer eklentiler veya geliştiriciler tarafından olduğu gibi harici olarak çağrılacak bir yöntem mi? Bu yöntem yalnızca eklenti tarafından dahili olarak kullanılıyorsa, muhtemelen daha iyi bir ad işleviyle değiştirmeyi güvenle kaldırabilirsiniz.

Eğer değilse, daha iyi adlandırılmış işlevi oluşturmak ve bir ile kötü adında bir çağrıyı sahip ediyorum __doing_it_wrongçağrısı - okumuştum kodeksine Bu yönteme kendi başvuruları güncelleştirmek için diğer geliştiricilerin zamanı verecektir ve güvenle yöntemini kaldırabilirsiniz sonraki bir sürüm.

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();
}

Bu yardımcı olur umarım!

Yeni bir eklenti oluşturursunuz ve kullanıcılarınıza mevcut olan EOL olduğu gibi geçiş yapmasını önerirsiniz.

Eklenti ve tema yazarlarının herkese açık API'larını değiştiren ve bunu "başka bir küçük yükseltme" olarak ele almaya çalışan daha can sıkıcı bir şey yok. Kullanıcılarınızın gerçekten etkilemediği bir sorun nedeniyle siteleri kırmak için hiçbir neden yoktur.

Şöyle bir şey önerebilirim:

/**
 * @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();
}

Bunun, yığın iziyle birlikte günlüklerde bir kullanımdan kaldırma uyarısı gösterme etkisi vardır. Doğal olarak bu, yalnızca WordPress'te günlüğe kaydetme etkinleştirildiyse çalışır.

Üçlü işleç oradadır çünkü E_USER_DEPRECATED sabiti yalnızca PHP 5.3.0'da kullanılmıştır. Eski sürümlerde bunun yerine basit bir kullanıcı uyarısına geri dönebiliriz.

Gönderen hata sabitleri PHP kılavuzu :

E_DEPRECATED Çalışma zamanı bildirimleri. Gelecek sürümlerde çalışmayacak kod hakkında uyarılar almak için bunu etkinleştirin.

_Doing_it_wrong veya __deprecated_function kullanmayı sevmememin nedeni , bu işlevlerin yalnızca WordPress çekirdeğine yönelik olmasıdır. Bu işlevler üzerindeki kod başvurusundan:

Bu işlevin erişimi özel olarak işaretlenmiştir. Bu, eklenti veya tema geliştiricileri tarafından yalnızca diğer temel işlevlerde kullanılmak üzere tasarlanmadığı anlamına gelir. Tamlık için burada listelenmiştir.