cURL (Client URL) es una biblioteca y una herramienta de l\u00ednea de comandos que permite a los desarrolladores transferir datos a trav\u00e9s de distintos protocolos, como HTTP, HTTPS, FTP, entre otros. Es especialmente \u00fatil en el desarrollo web para realizar llamadas API, descargar archivos, y mucho m\u00e1s.<\/p>\n\n\n\n
A continuaci\u00f3n, detallamos los errores m\u00e1s frecuentes que pueden encontrar los usuarios de cURL, explicamos su significado y proporcionamos ejemplos de c\u00f3mo solucionarlos.<\/p>\n\n\n\n
Este error indica que cURL no pudo resolver el nombre de dominio proporcionado. Generalmente, esto se debe a fallas en la conexi\u00f3n de red o un error tipogr\u00e1fico en la URL.<\/p>\n\n\n\n
Soluci\u00f3n:<\/strong> Verifica la conexi\u00f3n a Internet y aseg\u00farate de que el nombre de dominio est\u00e9 escrito correctamente.<\/p>\n\n\n\n Este error ocurre cuando cURL no puede establecer una conexi\u00f3n con el servidor. Puede ser causado por un servidor ca\u00eddo o bloqueos de firewall.<\/p>\n\n\n\n Soluci\u00f3n:<\/strong> Comprueba si el servidor est\u00e1 activo y accesible desde tu ubicaci\u00f3n. Tambi\u00e9n, verifica configuraciones de firewall que puedan estar bloqueando la conexi\u00f3n.<\/p>\n\n\n\n Indica que la operaci\u00f3n realizada por cURL ha excedido el tiempo de espera. Esto puede suceder al intentar conectarse a un servicio que no responde.<\/p>\n\n\n\n Soluci\u00f3n:<\/strong> Aumenta el tiempo de espera utilizando la opci\u00f3n Este error se produce cuando cURL recibe un c\u00f3digo de estado HTTP no v\u00e1lido o inesperado al realizar una solicitud. Esto incluye c\u00f3digos 4xx y 5xx.<\/p>\n\n\n\n Soluci\u00f3n:<\/strong> Revisa la respuesta del servidor para identificar el c\u00f3digo de error. Puedes utilizar el siguiente ejemplo para obtener m\u00e1s informaci\u00f3n sobre el error:<\/p>\n\n\n\n Este error indica que hay un problema con el certificado SSL del servidor. Puede ser que el certificado sea auto-firmado o simplemente no est\u00e9 presente.<\/p>\n\n\n\n Soluci\u00f3n:<\/strong> Puedes omitir la verificaci\u00f3n del certificado SSL (aunque no se recomienda en producci\u00f3n) usando:<\/p>\n\n\n\n Este error se\u00f1ala que hay un problema al establecer una conexi\u00f3n SSL. Puede estar causado por versiones incompatibles de TLS o configuraciones inadecuadas en el servidor.<\/p>\n\n\n\n Soluci\u00f3n:<\/strong> Aseg\u00farate de que tanto tu servidor como cURL est\u00e9n actualizados y sean compatibles con las versiones m\u00e1s recientes de TLS.<\/p>\n\n\n\n Este error se produce cuando se intenta utilizar un protocolo que no est\u00e1 habilitado o no es soportado por la instalaci\u00f3n de cURL.<\/p>\n\n\n\n Soluci\u00f3n:<\/strong> Verifica las configuraciones de la instalaci\u00f3n de cURL y aseg\u00farate de que tienes habilitados los protocolos necesarios.<\/p>\n\n\n\n Para minimizar la aparici\u00f3n de errores al usar cURL, considera adoptar las siguientes pr\u00e1cticas recomendadas:<\/p>\n\n\n\n2. cURL error 7: Failed to connect to host<\/h3>\n\n\n\n
3. cURL error 28: Operation timed out<\/h3>\n\n\n\n
CURLOPT_TIMEOUT<\/code>, como se muestra a continuaci\u00f3n:<\/p>\n\n\n\n\ncurl_setopt($ch, CURLOPT_TIMEOUT, 30); \/\/ Establecer timeout a 30 segundos\n<\/code><\/pre>\n\n\n\n4. cURL error 22: HTTP error<\/h3>\n\n\n\n
\n$response = curl_exec($ch);\nif (curl_errno($ch)) {\n echo 'Error:' . curl_error($ch);\n} else {\n echo 'Respuesta: ' . $response;\n}\n<\/code><\/pre>\n\n\n\n5. cURL error 60: SSL certificate problem<\/h3>\n\n\n\n
\ncurl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);\n<\/code><\/pre>\n\n\n\n6. cURL error 35: SSL connect error<\/h3>\n\n\n\n
7. cURL error 1: Unsupported protocol<\/h3>\n\n\n\n
Pr\u00e1cticas recomendadas para usar cURL<\/h2>\n\n\n\n
\n
Listado de C\u00f3digos de Error de cURL<\/h2>\n\n\n\n
\n \n
\n \n C\u00f3digo<\/th>\n Nombre del Error<\/th>\n Descripci\u00f3n<\/th>\n <\/tr>\n <\/thead>\n \n 0<\/strong><\/td>\n Success<\/strong><\/td>\n La operaci\u00f3n se complet\u00f3 con \u00e9xito de acuerdo a las instrucciones.<\/td>\n <\/tr>\n \n 1<\/strong><\/td>\n Unsupported protocol<\/strong><\/td>\n Esta versi\u00f3n de curl no es compatible con el protocolo utilizado.<\/td>\n <\/tr>\n \n 2<\/strong><\/td>\n Failed to initialize<\/strong><\/td>\n Error al inicializar.<\/td>\n <\/tr>\n \n 3<\/strong><\/td>\n URL malformed<\/strong><\/td>\n La sintaxis de la URL no es correcta.<\/td>\n <\/tr>\n \n 4<\/strong><\/td>\n A required feature\/option was not enabled<\/strong><\/td>\n Una caracter\u00edstica u opci\u00f3n necesaria para la solicitud no estaba habilitada o fue deshabilitada expl\u00edcitamente en tiempo de compilaci\u00f3n.<\/td>\n <\/tr>\n \n 5<\/strong><\/td>\n Could not resolve proxy<\/strong><\/td>\n El host proxy especificado no pudo resolverse.<\/td>\n <\/tr>\n \n 6<\/strong><\/td>\n Could not resolve host<\/strong><\/td>\n El host remoto especificado no pudo resolverse.<\/td>\n <\/tr>\n \n 7<\/strong><\/td>\n Failed to connect to host<\/strong><\/td>\n Error al conectar con el host.<\/td>\n <\/tr>\n \n 8<\/strong><\/td>\n Weird server reply<\/strong><\/td>\n El servidor envi\u00f3 datos que curl no pudo analizar.<\/td>\n <\/tr>\n \n 9<\/strong><\/td>\n FTP access denied<\/strong><\/td>\n El servidor deneg\u00f3 el inicio de sesi\u00f3n o el acceso al recurso\/directorio. A menudo, se intent\u00f3 cambiar a un directorio que no existe.<\/td>\n <\/tr>\n \n 10<\/strong><\/td>\n FTP accept failed<\/strong><\/td>\n Mientras se esperaba la conexi\u00f3n del servidor en una sesi\u00f3n FTP activa, se envi\u00f3 un c\u00f3digo de error a trav\u00e9s de la conexi\u00f3n de control.<\/td>\n <\/tr>\n \n 11<\/strong><\/td>\n FTP weird PASS reply<\/strong><\/td>\n curl no pudo analizar la respuesta enviada al comando PASS.<\/td>\n <\/tr>\n \n 12<\/strong><\/td>\n FTP active transfer timeout<\/strong><\/td>\n Durante una sesi\u00f3n FTP activa, el tiempo de espera expir\u00f3 mientras se esperaba que el servidor se conectara de vuelta a curl.<\/td>\n <\/tr>\n \n 13<\/strong><\/td>\n FTP weird PASV reply<\/strong><\/td>\n curl no pudo analizar la respuesta enviada al comando PASV.<\/td>\n <\/tr>\n \n 14<\/strong><\/td>\n FTP weird 227 format<\/strong><\/td>\n curl no pudo analizar la l\u00ednea 227 enviada por el servidor.<\/td>\n <\/tr>\n \n 15<\/strong><\/td>\n FTP cannot use host<\/strong><\/td>\n No se pudo resolver la IP del host recibida en la l\u00ednea 227.<\/td>\n <\/tr>\n \n 16<\/strong><\/td>\n HTTP\/2 error<\/strong><\/td>\n Se detect\u00f3 un problema en la capa de framing<\/em> de HTTP\/2. Problema gen\u00e9rico; ver el mensaje de error para m\u00e1s detalles.<\/td>\n <\/tr>\n \n 17<\/strong><\/td>\n FTP could not set binary<\/strong><\/td>\n No se pudo cambiar el m\u00e9todo de transferencia a binario.<\/td>\n <\/tr>\n \n 18<\/strong><\/td>\n Partial file<\/strong><\/td>\n Solo se transfiri\u00f3 una parte del archivo.<\/td>\n <\/tr>\n \n 19<\/strong><\/td>\n FTP could not download\/access file<\/strong><\/td>\n El comando RETR<\/strong> (o similar) fall\u00f3 para descargar\/acceder al archivo.<\/td>\n <\/tr>\n \n 21<\/strong><\/td>\n FTP quote error<\/strong><\/td>\n Un comando quote<\/em> devolvi\u00f3 un error del servidor.<\/td>\n <\/tr>\n \n 22<\/strong><\/td>\n HTTP page not retrieved<\/strong><\/td>\n La URL solicitada no se encontr\u00f3 o devolvi\u00f3 otro error con c\u00f3digo HTTP 400 o superior<\/strong>. Este c\u00f3digo solo aparece si se usa --fail<\/code>.<\/td>\n <\/tr>\n \n 23<\/strong><\/td>\n Write error<\/strong><\/td>\n curl no pudo escribir datos en el sistema de archivos local o similar.<\/td>\n <\/tr>\n \n 25<\/strong><\/td>\n Failed starting the upload<\/strong><\/td>\n Fallo al iniciar la carga. Para FTP, el servidor normalmente deneg\u00f3 el comando STOR.<\/td>\n <\/tr>\n \n 26<\/strong><\/td>\n Read error<\/strong><\/td>\n Varios problemas de lectura.<\/td>\n <\/tr>\n \n 27<\/strong><\/td>\n Out of memory<\/strong><\/td>\n Fall\u00f3 una solicitud de asignaci\u00f3n de memoria.<\/td>\n <\/tr>\n \n 28<\/strong><\/td>\n Operation timeout<\/strong><\/td>\n Se alcanz\u00f3 el per\u00edodo de tiempo de espera especificado seg\u00fan las condiciones.<\/td>\n <\/tr>\n \n 30<\/strong><\/td>\n FTP PORT failed<\/strong><\/td>\n El comando PORT<\/strong> fall\u00f3. No todos los servidores FTP lo admiten; intente usar PASV<\/strong>.<\/td>\n <\/tr>\n \n 31<\/strong><\/td>\n FTP could not use REST<\/strong><\/td>\n El comando REST<\/strong> fall\u00f3. Se usa para reanudar transferencias FTP.<\/td>\n <\/tr>\n \n 33<\/strong><\/td>\n HTTP range error<\/strong><\/td>\n El comando de rango no funcion\u00f3.<\/td>\n <\/tr>\n \n 34<\/strong><\/td>\n HTTP post error<\/strong><\/td>\n Error interno de generaci\u00f3n de la solicitud POST.<\/td>\n <\/tr>\n \n 35<\/strong><\/td>\n SSL connect error<\/strong><\/td>\n Fall\u00f3 el handshaking<\/em> SSL.<\/td>\n <\/tr>\n \n 36<\/strong><\/td>\n Bad download resume<\/strong><\/td>\n No se pudo continuar una descarga abortada anteriormente.<\/td>\n <\/tr>\n \n 37<\/strong><\/td>\n FILE could not read file<\/strong><\/td>\n Error al abrir el archivo. \u00bfProblemas de permisos?<\/td>\n <\/tr>\n \n 38<\/strong><\/td>\n LDAP cannot bind<\/strong><\/td>\n Fall\u00f3 la operaci\u00f3n de enlace LDAP.<\/td>\n <\/tr>\n \n 39<\/strong><\/td>\n LDAP search failed<\/strong><\/td>\n Fall\u00f3 la b\u00fasqueda LDAP.<\/td>\n <\/tr>\n \n 41<\/strong><\/td>\n Function not found<\/strong><\/td>\n No se encontr\u00f3 una funci\u00f3n LDAP requerida.<\/td>\n <\/tr>\n \n 42<\/strong><\/td>\n Aborted by callback<\/strong><\/td>\n Una aplicaci\u00f3n le dijo a curl que abortara la operaci\u00f3n.<\/td>\n <\/tr>\n \n 43<\/strong><\/td>\n Internal error<\/strong><\/td>\n Una funci\u00f3n fue llamada con un par\u00e1metro incorrecto.<\/td>\n <\/tr>\n \n 45<\/strong><\/td>\n Interface error<\/strong><\/td>\n No se pudo utilizar una interfaz de salida especificada.<\/td>\n <\/tr>\n \n 47<\/strong><\/td>\n Too many redirects<\/strong><\/td>\n Al seguir redirecciones, curl alcanz\u00f3 la cantidad m\u00e1xima.<\/td>\n <\/tr>\n \n