Si alguna vez has necesitado consultar un servicio web, subir un fichero a un sitio web o simplemente descargar una determinada página, vCurl es tu mejor compañía.vCurl implementa algunas de las funciones incluídas dentro de la famosa librería libcurl, y que nos permite realizar muchos tipos de llamadas a servicios web.
Consideraciones previas
En esta nueva versión 2.0, hemos añadido además la versión para Mac. De todas maneras, recuerda que en Windows debes descargar la librería libcurl y copiar todas las dlls que vienen en el fichero zip, dentro de la carpeta bin, al directorio windows del equipo.En Mac no es necesario instalar nada adicional.En linux, depende de la versión, quizás sea necesario instalar el siguiente paquete (usando apt-get o similar):sudo apt-get install libcurl4-openssl-dev:i386
Usando el componente
Un ejemplo muy sencillo de uso del componente es si queremos descargar el contenido de una página web o de un servicio web para procesarlo. Suponiendo que la variable URL en el siguiente ejemplo tenga el valor "http://www.velneo.es", obtendremos en la variable DATO el contenido html de esa página
Esta es la forma más sencilla, junto con la función EASYPOST de utilizar este componente. Es muy importante la llamada a EASYFREE para que se libere la memoria usada por la librería. De todas maneras si queremos más configuración podemos hacer uso del resto de funciones.En este otro ejemplo vemos como estamos haciendo una llamada tipo POST a una página web que además necesita validación con usuario y password y una serie de datos en formato utf8.
Vemos la utilización de varias funciones extra incluidas en el componente:
- Contamos con ENCODE_UTF8 y DECODE_UTF8, para codificar y decodificar una cadena a y desde UTF8
- Contamos con la función ESCAPE y UNESCAPE para codificar y decodificar urls (se sustituyen determinados caracteres por su equivalente en Hexadecimal)
- La función SETOPT_S nos permite asignar opciones de tipo cadena. Junto con la función GETCURLOPT, podemos asignar por ejemplo la URL o USERPWD
- la función STRERR nos retorna un mensaje correspondiente al último error ocurrido
En este último ejemplo vemos la utilización de las nuevas funciones introducidas. En este caso en esta llamada estamos añadiendo un valor específico a la cabecera usando ADDHEADER.
Otra función interesante añadida a partir de la versión 2.0.1 es FILEUPLOAD. De esta manera podemos subir un fichero a una determinada página web o servicio.Un saludo.