¿Cuál es la diferencia entre get_home_path() y ABSPATH?

Ellos deberían hacer lo mismo, pero bajo ciertas condiciones, puede que no.

Primero, ten en cuenta:

• que la descripción en la codex es engañosa
• que wp-admin/includes/file.php debe estar incluido en el contexto, de lo contrario, llamar a get_home_path() resultará en llamar a una función no definida.

Respecto a la entrada en el codex,

Descripción

Obtiene la ruta absoluta del sistema de archivos hasta la raíz de la instalación de WordPress.

Valor devuelto

Ruta completa del sistema de archivos hasta la raíz de la instalación de WordPress. Si instalas WordPress en un subdirectorio, mostrará la ubicación del subdirectorio.

Ejemplos

$path = get_home_path();
print "Path: ".$path; // Devuelve "Path: /var/www/htdocs/" o "Path: /var/www/htdocs/wordpress/" si es un subdirectorio

Indica que el valor devuelto será la ruta del subdirectorio si has instalado WordPress en un subdirectorio. Esto es, de hecho, incorrecto.

get_home_path() devolverá el directorio raíz de tu instalación de WordPress, incluso si está instalado en un subdirectorio. Ese es el propósito de la función.

Supongamos que tu instalación de WordPress está dentro de un subdirectorio llamado /dev,

• http://www.example.com/dev (site_url) (ej. /var/www/htdocs/dev)
• http://www.example.com/ (home_url)

Si registras una llamada a ABSPATH, el resultado será /var/www/htdocs/dev, que no es la raíz de tu instalación. La raíz de tu instalación es /var/www/htdocs.

ABSPATH se define primero en wp-load.php, que estará ubicado en /var/www/htdocs/dev/wp-load.php, por lo que aquí es donde ABSPATH tomará su definición.

Si inspeccionas get_home_path() más a fondo, notarás que si site_url y home_url difieren, entonces se toma una subcadena de la ruta gobernada por la posición (primera ocurrencia) del subdirectorio encontrado dentro de la cadena.

function get_home_path() {
    $home    = set_url_scheme( get_option( 'home' ), 'http' );
    $siteurl = set_url_scheme( get_option( 'siteurl' ), 'http' );

    if ( ! empty( $home ) && 0 !== strcasecmp( $home, $siteurl ) ) {
        $wp_path_rel_to_home = str_ireplace( $home, '', $siteurl ); /* $siteurl - $home */
        $pos = strripos( str_replace( '\\', '/', $_SERVER['SCRIPT_FILENAME'] ), trailingslashit( $wp_path_rel_to_home ) );
        $home_path = substr( $_SERVER['SCRIPT_FILENAME'], 0, $pos );
        $home_path = trailingslashit( $home_path );
    } else {
        $home_path = ABSPATH;
    }

    return str_replace( '\\', '/', $home_path );
}

Por lo tanto, como resultado de esto, get_home_path() y ABSPATH pueden devolver resultados diferentes si tienes WordPress instalado en un subdirectorio.

En segundo lugar, llamar a get_home_path() debe hacerse en un contexto donde el mencionado wp-admin/includes/file.php ya haya sido incluido.

Por ejemplo, usar get_home_path() dentro del hook admin_init está bien, mientras que usarlo dentro de init no lo está.

Dado que este archivo solo se incluye desde el contexto del administrador (panel de control), si realmente lo necesitas fuera de este contexto, tendrás que incluir el archivo tú mismo antes de llamar a la función,

require_once(ABSPATH . 'wp-admin/includes/file.php');

Irónicamente (o no), lo cual usa ABSPATH :D