Recientemente he trabajado en un proyecto web en WordPress en que la web tenia que dar acceso a fuentes de informaci\u00f3n \u00abexternas\u00bb, en concreto:<\/p>\n
Implementar esto con WordPress no es muy complicado porque detr\u00e1s no hay m\u00e1s que PHP, pero quiero dejar anotadas algunas cosas.<\/p>\n
Para empezar el consumo de estos dos servicios lo desarrolle como plugins de WordPress, de manera que quedaban independientes de los ficheros propios del theme, esta es una practica recomendable, ya que\u00a0Wordpress no contempla el patr\u00f3n MVC, pero eso no quita que separemos las cosas de una manera razonable para facilitar mantenimiento y escabilidad y en eso los plugins son parte vital.<\/p>\n
Por otra parte cada uno de estos casos tenia un tratamiento diferente para WordPress, mientras que en el caso del API REST podemos usar directamente la funci\u00f3n wp_remote_request()<\/a> del API de WordPress ya que vamos a realizar una llamada GET. Para el caso de una conexi\u00f3n SOAP se implementa todo con la t\u00edpica<\/em> SoapClient<\/a> de PHP.<\/p>\n Usando wp_remote_request()<\/em> primero definimos los parametros de conexi\u00f3n. Se trata de un API REST que espera autentificar la conexi\u00f3n mediante un API KEY que nos habran asignado y (en este caso particular) una URL de referencia. Si alguno de estos parametros no es correcto no tendremos acceso.<\/p>\n Esto lo hacemos asi:<\/p>\n Luego a la URL que tenemos asignada para conectarnos a la API le a\u00f1adimos los par\u00e1metros deseados\u00a0de la\u00a0conexi\u00f3n tipo\u00a0GET\u00a0que realizamos, esto es lo que hacemos aqu\u00ed, evidentemente en este caso es solo un ejemplo:<\/p>\n Con la URL de conexi\u00f3n a la API y los parametros para autentificarnos, lanzamos la conexi\u00f3n:<\/p>\n La funci\u00f3n wp_remote_request()<\/em> nos devuelve un array con el resultado de la conexi\u00f3n, en el item ‘body’<\/em> de ese array (en este caso) esta todo el resultado recibido desde la API. Solo nos queda tratarlo como necesitemos, en este ejemplo paso los datos recibidos en formato JSON a un array $info para su posterior uso en el WordPress:<\/p>\n Aqu\u00ed la cosa es diferente y usamos la class SoapClient.<\/em> Primero instanciamos el objeto y la conexi\u00f3n:<\/p>\n Luego con el objeto creado, en este ejemplo\u00a0$Soap_Object, accedemos a las funciones propias que implemente esa API, como m\u00e9todos del objeto que hemos instanciado, por ejemplo:<\/p>\n Donde el metodo existeContacto()<\/em> estar\u00e1 definido para esa API SOAP en concreto, que estemos usando. Las llamadas a los m\u00e9todos siempre (si se han hecho las cosas bien) devuelven una respuesta que podemos poner en una variable y mostrar o evaluar para saber si todo has salido ok. En este ejemplo esto ocurre en $objResponse, que luego puede, por ejemplo, usarse as\u00ed:<\/p>\n Donde la propiedad \u00abc\u00f3digo\u00bb tambi\u00e9n es en este caso una propiedad definida por la API SOAP usada, pero que en otra sera diferente.<\/p>\n Por otra parte la class SoapClient tiene otros m\u00e9todos y propiedades que nos pueden ser de ayuda en fase de desarrollo o debug,<\/em> por ejemplo si una vez establecida la conexi\u00f3n ejecutamos un:<\/p>\n Obtendremos un array con todas los m\u00e9todos que tiene definida la API SOAP con la que estamos conectando, esto nos ayuda a ver que acciones podemos realizar. En la API SOAP del proyecto que comento, esta llamada produc\u00eda un array as\u00ed:<\/p>\n Aunque esta claro que no debemos esperar a realizar esto para conocer que nos ofrece la API, ya que se supone que el cliente nos ha facilitado la documentaci\u00f3n necesaria, pero es un ejemplo de las posibilidades que nos ofrece SoapClient.<\/p>\n Todo esto funciona sin m\u00e1s problemas, pero si la web donde se realiza esta funcionando\u00a0detr\u00e1s<\/em> de un proxy, las conexiones deben contemplarlo y \u00a0deben a\u00f1adir la configuraci\u00f3n de paso de tal proxy.<\/p>\n En el caso de la conexi\u00f3n a la API SOAP debemos sustituir:<\/p>\n Por:<\/p>\n Donde 192.0.0.0 es evidentement una IP de ejemplo, en definitiva en ‘proxy_host’ a\u00f1adimos la IP del proxy y en ‘proxy_port’ el puerto<\/p>\n Para el caso de la API REST y como la llamada es mediante wp_remote_request()<\/em> bastara con tener en el wp-config.php de WordPress la configuraci\u00f3n para paso por el proxy.<\/p>\n Estos solo son dos ejemplos consumiendo servicios web en un WordPress. Para ambos casos (REST y SOAP) aun hay m\u00e1s posibilidades como tambien la de ser servidor de estos servicios, pero ese ya es otro tema.<\/p>\nConectar a una API REST<\/h2>\n
$args_api = array('headers' => array('X-API-KEY' => $_EL_API_KEY_ASIGNADO,\r\n 'URL_BASE' => $_SERVER[\"HTTP_HOST\"]) );<\/pre>\n$url_api.='\/publicaciones_descargas\/limit\/1';<\/pre>\n
$losdatos = wp_remote_request($url_api,$args_api);<\/pre>\n
$info = json_decode($losdatos['body'],true);<\/pre>\n
\u00a0Conectar a una API SOAP<\/h2>\n
$Soap_Object = new SoapClient(\"URL DE ACCESO SOAP A LA API -aqui va el tuyo-\",\r\n array('trace' => true)\r\n );<\/pre>\n$objResponse = $Soap_Object->existeContacto(array('email' => 'un email de ejemplo'));<\/pre>\nif( $objResponse->return->codigo == 4 )<\/pre>\n
$objResponse = $Soap_Object->__getFunctions();\r\nprint_r($objResponse);<\/pre>\n
Array\r\n (\r\n [0] => borrarContactoResponse borrarContacto(borrarContacto $parameters)\r\n [1] => altaContactoResponse altaContacto(altaContacto $parameters)\r\n [2] => actualizarCorreoResponse actualizarCorreo(actualizarCorreo $parameters)\r\n [3] => existeContactoResponse existeContacto(existeContacto $parameters)\r\n [4] => borrarContactoResponse borrarContacto(borrarContacto $parameters)\r\n [5] => altaContactoResponse altaContacto(altaContacto $parameters)\r\n [6] => actualizarCorreoResponse actualizarCorreo(actualizarCorreo $parameters)\r\n [7] => existeContactoResponse existeContacto(existeContacto $parameters)\r\n )<\/pre>\n
Nuestro amigo el Proxy<\/h2>\n
$Soap_Object = new SoapClient(\"URL DE ACCESO SOAP A LA API -aqui va el tuyo-\",\r\n array('trace' => true)\r\n );<\/pre>\n$Soap_Object = new SoapClient(\"URL DE ACCESO SOAP A LA API -aqui va el tuyo-\",\r\n array('trace' => true, 'proxy_host' => '192.0.0.0', 'proxy_port' => '8080' )\r\n );<\/pre>\n