¿Por qué la API de WP Filesystem no puede leer googlefonts.json?

No es necesario usar WP_Filesystem para cada pequeña cosa, y en este caso, la solución correcta es usar la función normal file_get_contents.

WP_Filesystem es un envoltorio alrededor de varias formas de interactuar con el sistema de archivos de manera segura... pero no está destinado para todo.

Fundamentalmente, el código WP_Filesystem fue creado para permitir que WordPress se actualice a sí mismo.

Al hacer algo así, la propiedad de los archivos es un asunto bastante importante. Muchos servidores se ejecutan como "www" (por ejemplo) en lugar de como el propietario real de los archivos PHP. Si WordPress escribiera un archivo directamente en tal caso, el archivo resultante sería propiedad de "www" también, no del verdadero y correcto propietario. Esto puede llevar a problemas de seguridad, especialmente en alojamientos compartidos.

Por lo tanto, WP_Filesystem abstrae las operaciones de archivos. Puede leer y escribir archivos de maneras que preservarán la propiedad de los archivos. Si puede escribir directamente y la propiedad se mantiene, lo hará, pero si no puede, entonces necesitará credenciales para algún método como FTP. Al usar credenciales, puede iniciar sesión a través de esa ruta y escribir archivos utilizando el propietario adecuado.

Lo que esto significa es que antes de usar WP_Filesystem, debe configurarse. Se debe realizar una prueba, y si la prueba falla, se deben obtener credenciales del usuario. Sin esas credenciales, no puede funcionar.

En tu caso, dado que "cambiar la propiedad de todo el directorio de WordPress a _www:_www" resolvió el problema, esto es lo que te está sucediendo. La prueba de intentar escribir un archivo y obtener la propiedad correcta falla. Al cambiar el propietario de los archivos existentes, estás cambiando las condiciones para esa prueba.

Ahora, la verdad es que, en este caso, no hay razón para usar WP_Filesystem en absoluto. Está leyendo un archivo. Puede leer ese archivo directamente. La propiedad no importa aquí. Entonces, realmente, solo usa file_get_contents. Usar WP_Filesystem para esto no tiene sentido.

Más sobre WP_Filesystem, desde una perspectiva de cómo usarlo: http://ottopress.com/2011/tutorial-using-the-wp_filesystem/

@codecowboy, ¿qué versión de Redux estás usando? En las versiones más recientes ni siquiera usamos el googlefonts.json de esta manera.

Te sugiero que simplemente instales Redux Framework desde el repositorio de plugins de WordPress (http://wordpress.org/plugins/redux-framework/), y este problema se resolverá para ti ya que el plugin anulará la versión de Redux integrada en tu tema.

Después de depurar un poco, parece que lo que realmente está sucediendo aquí es que WP_Filesystem intenta abrir una conexión FTP al archivo temporal mientras realiza sus verificaciones:

public function get_contents( $file ) {
        $tempfile = wp_tempnam($file);
        $temp = fopen($tempfile, 'w+');

        if ( ! $temp )
            return false;

        if ( ! @ftp_fget($this->link, $temp, $file, FTP_BINARY ) )
            return false; // Se devuelve false y termino con un array vacío de fuentes de Google

        fseek( $temp, 0 ); // Retrocede al inicio del archivo que se está escribiendo
        $contents = '';

        while ( ! feof($temp) )
            $contents .= fread($temp, 8192);

        fclose($temp);
        unlink($tempfile);
        return $contents;
    }

En mi máquina local con OSX esto falla, mientras que en el servidor destino funciona. No estoy seguro de por qué cambiar la propiedad de todo el directorio de WordPress a _www:_www permite que este ftp_fget funcione, dado que está intentando leer un archivo temporal en /var/tmp.

Para que conste, la versión más reciente de Redux ya no utiliza este método en particular para cargar fuentes de Google. Y en segundo lugar, Otto tiene cierta aversión por la gente de Redux, así que toma lo que dice aquí con pinzas. Constantemente vemos errores en las revisiones de temas que dicen:

ADVERTENCIA: se encontró file_put_contents en el archivo class.redux_filesystem.php. Las operaciones con archivos deberían usar los métodos WP_Filesystem en lugar de llamadas directas al sistema de archivos de PHP.

¿En serio? Entonces, ¿Otto? ¿Estás inventando estándares y pautas sobre la marcha? Tiene sentido, realmente, ya que toda la base de $wp_filesystem parece haber sido ensamblada a trozos por niños que no tenían idea de lo que estaban haciendo. ¡Estándares, por supuesto!