Estas constantes son definidas por esta extensión, y solo están disponibles si esta extensión ha sido compilada con PHP, o bien cargada en tiempo de ejecución.
Las descripciones así como los usos de estas constantes se describen en la documentación de las funciones curl_setopt(), curl_multi_setopt() y curl_getinfo().
| Constantes | Descripción |
|---|---|
CURLALTSVC_H1
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.64.1. |
CURLALTSVC_H2
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.64.1. |
CURLALTSVC_H3
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.64.1. |
CURLALTSVC_READONLYFILE
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.64.1. |
CURLAUTH_ANY
(int)
|
|
CURLAUTH_ANYSAFE
(int)
|
|
CURLAUTH_AWS_SIGV4
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.75.0. |
CURLAUTH_BASIC
(int)
|
|
CURLAUTH_BEARER
(int)
|
Disponible a partir de PHP 7.3.0 y cURL 7.61.0. |
CURLAUTH_DIGEST
(int)
|
|
CURLAUTH_DIGEST_IE
(int)
|
Utilizar la autenticación HTTP Digest con un navegador IE. Disponible a partir de cURL 7.19.3. |
CURLAUTH_GSSAPI
(int)
|
Disponible a partir de PHP 7.3.0 y cURL 7.54.1 |
CURLAUTH_GSSNEGOTIATE
(int)
|
|
CURLAUTH_NEGOTIATE
(int)
|
Disponible a partir de PHP 7.3.0 y cURL 7.61.0. |
CURLAUTH_NONE
(int)
|
Disponible a partir de cURL 7.10.6. |
CURLAUTH_NTLM
(int)
|
|
CURLAUTH_NTLM_WB
(int)
|
Disponible a partir de PHP 7.0.7 y cURL 7.22.0 |
CURLAUTH_ONLY
(int)
|
Este es un símbolo meta. Colocar este valor CON un solo valor de autenticación específico para forzar a libcurl a verificar la autenticación no restringida y si no, solo este algoritmo de autenticación es aceptable. Disponible a partir de cURL 7.21.3. |
CURLFTPAUTH_DEFAULT
(int)
|
|
CURLFTPAUTH_SSL
(int)
|
|
CURLFTPAUTH_TLS
(int)
|
|
CURLFTPMETHOD_DEFAULT
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.15.3. |
CURLFTPMETHOD_MULTICWD
(int)
|
Realiza una sola operación CWD
para cada parte del camino en la URL dada.
Disponible a partir de cURL 7.15.3.
|
CURLFTPMETHOD_NOCWD
(int)
|
libcurl no realiza CWD en absoluto.
libcurl realiza SIZE, RETR,
STOR etc.
y devuelve un camino completo al servidor para todas estas comandas.
Disponible a partir de cURL 7.15.3.
|
CURLFTPMETHOD_SINGLECWD
(int)
|
libcurl realiza un CWD con el directorio objetivo completo
luego opera sobre el fichero como en el caso multicwd.
Disponible a partir de cURL 7.15.3.
|
CURLFTPSSL_ALL
(int)
|
|
CURLFTPSSL_CCC_ACTIVE
(int)
|
Inicia el cierre de la conexión y espera una respuesta. Disponible a partir de cURL 7.16.2. |
CURLFTPSSL_CCC_NONE
(int)
|
No intenta usar CCC (Clear Command Channel). Disponible a partir de cURL 7.16.2. |
CURLFTPSSL_CCC_PASSIVE
(int)
|
No inicia el cierre de la conexión, pero espera que el servidor lo haga. No envía respuesta. Disponible a partir de cURL 7.16.2. |
CURLFTPSSL_CONTROL
(int)
|
|
CURLFTPSSL_NONE
(int)
|
|
CURLFTPSSL_TRY
(int)
|
|
CURLFTP_CREATE_DIR
(int)
|
Disponible a partir de PHP 7.0.7 y cURL 7.19.3 |
CURLFTP_CREATE_DIR_NONE
(int)
|
Disponible a partir de PHP 7.0.7 y cURL 7.19.3 |
CURLFTP_CREATE_DIR_RETRY
(int)
|
Disponible a partir de PHP 7.0.7 y cURL 7.19.3 |
CURLGSSAPI_DELEGATION_FLAG
(int)
|
Permite la delegación incondicional de las credenciales GSSAPI. Disponible a partir de cURL 7.22.0. |
CURLGSSAPI_DELEGATION_POLICY_FLAG
(int)
|
Delega únicamente si el flag OK-AS-DELEGATE está definido
en el ticket de servicio si esta funcionalidad es soportada por la implementación GSS-API
y que la definición de GSS_C_DELEG_POLICY_FLAG
estaba disponible en la compilación.
Disponible a partir de cURL 7.22.0.
|
CURLHEADER_SEPARATE
(int)
|
Disponible a partir de PHP 7.0.7 y cURL 7.37.0. |
CURLHEADER_UNIFIED
(int)
|
Disponible a partir de PHP 7.0.7 y cURL 7.37.0. |
CURLHSTS_ENABLE
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.74.0 |
CURLHSTS_READONLYFILE
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.74.0 |
CURLKHMATCH_LAST
(int)
|
Disponible a partir de PHP 8.3.0 y cURL 7.19.6 |
CURLKHMATCH_MISMATCH
(int)
|
Disponible a partir de PHP 8.3.0 y cURL 7.19.6 |
CURLKHMATCH_MISSING
(int)
|
Disponible a partir de PHP 8.3.0 y cURL 7.19.6 |
CURLKHMATCH_OK
(int)
|
Disponible a partir de PHP 8.3.0 y cURL 7.19.6 |
CURLMIMEOPT_FORMESCAPE
(int)
|
Disponible a partir de PHP 8.3.0 y cURL 7.81.0 |
CURLMSG_DONE
(int)
|
|
CURLPIPE_HTTP1
(int)
|
Disponible a partir de cURL 7.43.0. |
CURLPIPE_MULTIPLEX
(int)
|
Disponible a partir de cURL 7.43.0. |
CURLPIPE_NOTHING
(int)
|
Disponible a partir de cURL 7.43.0. |
CURLPROXY_HTTP
(int)
|
Disponible a partir de cURL 7.10. |
CURLPROXY_HTTPS
(int)
|
Disponible a partir de PHP 7.3.0 y cURL 7.52.0 |
CURLPROXY_HTTP_1_0
(int)
|
Disponible a partir de PHP 7.0.7 y cURL 7.19.3 |
CURLPROXY_SOCKS4
(int)
|
Disponible a partir de cURL 7.10. |
CURLPROXY_SOCKS4A
(int)
|
Disponible a partir de cURL 7.18.0. |
CURLPROXY_SOCKS5
(int)
|
Disponible a partir de cURL 7.10. |
CURLPROXY_SOCKS5_HOSTNAME
(int)
|
Disponible a partir de cURL 7.18.0. |
CURLPX_BAD_ADDRESS_TYPE
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_BAD_VERSION
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_CLOSED
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_GSSAPI
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_GSSAPI_PERMSG
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_GSSAPI_PROTECTION
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_IDENTD
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_IDENTD_DIFFER
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_LONG_HOSTNAME
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_LONG_PASSWD
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_LONG_USER
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_NO_AUTH
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_OK
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_RECV_ADDRESS
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_RECV_AUTH
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_RECV_CONNECT
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_RECV_REQACK
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_REPLY_ADDRESS_TYPE_NOT_SUPPORTED
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_REPLY_COMMAND_NOT_SUPPORTED
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_REPLY_CONNECTION_REFUSED
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_REPLY_GENERAL_SERVER_FAILURE
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_REPLY_HOST_UNREACHABLE
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_REPLY_NETWORK_UNREACHABLE
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_REPLY_NOT_ALLOWED
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_REPLY_TTL_EXPIRED
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_REPLY_UNASSIGNED
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_REQUEST_FAILED
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_RESOLVE_HOST
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_SEND_AUTH
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_SEND_CONNECT
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_SEND_REQUEST
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_UNKNOWN_FAIL
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_UNKNOWN_MODE
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLPX_USER_REJECTED
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.73.0 |
CURLSSH_AUTH_AGENT
(int)
|
Disponible a partir de PHP 7.0.7 y cURL 7.28.0 |
CURLSSH_AUTH_ANY
(int)
|
|
CURLSSH_AUTH_DEFAULT
(int)
|
|
CURLSSH_AUTH_GSSAPI
(int)
|
Disponible a partir de PHP 7.3.0 y cURL 7.58.0 |
CURLSSH_AUTH_HOST
(int)
|
|
CURLSSH_AUTH_KEYBOARD
(int)
|
|
CURLSSH_AUTH_NONE
(int)
|
|
CURLSSH_AUTH_PASSWORD
(int)
|
|
CURLSSH_AUTH_PUBLICKEY
(int)
|
|
CURLSSLOPT_ALLOW_BEAST
(int)
|
Disponible a partir de cURL 7.25.0 |
CURLSSLOPT_AUTO_CLIENT_CERT
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.77.0 |
CURLSSLOPT_NATIVE_CA
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.71.0 |
CURLSSLOPT_NO_PARTIALCHAIN
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.68.0 |
CURLSSLOPT_NO_REVOKE
(int)
|
Disponible a partir de PHP 7.0.7 y cURL 7.44.0 |
CURLSSLOPT_REVOKE_BEST_EFFORT
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.70.0 |
CURLUSESSL_ALL
(int)
|
Requiere SSL para todas las comunicaciones
o falla con CURLE_USE_SSL_FAILED.
Disponible a partir de cURL 7.17.0.
|
CURLUSESSL_CONTROL
(int)
|
Requiere SSL para la conexión de control
o falla con CURLE_USE_SSL_FAILED.
Disponible a partir de cURL 7.17.0.
|
CURLUSESSL_NONE
(int)
|
No intenta usar SSL. Disponible a partir de cURL 7.17.0. |
CURLUSESSL_TRY
(int)
|
Intenta usar SSL, sino continúa normalmente. Es de notar que el servidor puede cerrar la conexión si la negociación falla. Disponible a partir de cURL 7.17.0. |
CURLVERSION_NOW
(int)
|
|
CURLWS_RAW_MODE
(int)
|
Disponible a partir de PHP 8.3.0 y cURL 7.86.0 |
CURL_FNMATCHFUNC_FAIL
(int)
|
Devolvido por la función de devolución de llamada de coincidencia de caracteres genéricos si una error ha ocurrido. Disponible a partir de cURL 7.21.0. |
CURL_FNMATCHFUNC_MATCH
(int)
|
Devolvido por la función de devolución de llamada de coincidencia de caracteres genéricos si el patrón coincide con la cadena. Disponible a partir de cURL 7.21.0. |
CURL_FNMATCHFUNC_NOMATCH
(int)
|
Devolvido por la función de devolución de llamada de coincidencia de caracteres genéricos si el patrón no coincide con la cadena. Disponible a partir de cURL 7.21.0. |
CURL_HTTP_VERSION_1_0
(int)
|
|
CURL_HTTP_VERSION_1_1
(int)
|
|
CURL_HTTP_VERSION_2
(int)
|
Disponible a partir de PHP 7.0.7 y cURL 7.43.0 |
CURL_HTTP_VERSION_2TLS
(int)
|
Disponible a partir de PHP 7.0.7 y cURL 7.47.0 |
CURL_HTTP_VERSION_2_0
(int)
|
Disponible a partir de cURL 7.33.0 |
CURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE
(int)
|
Disponible a partir de PHP 7.0.7 y cURL 7.49.0 |
CURL_HTTP_VERSION_3
(int)
|
Disponible a partir de PHP 8.4.0 y cURL 7.66.0. |
CURL_HTTP_VERSION_3ONLY
(int)
|
Disponible a partir de PHP 8.4.0 y cURL 7.88.0. |
CURL_HTTP_VERSION_NONE
(int)
|
|
CURL_IPRESOLVE_V4
(int)
|
Utilizar únicamente direcciones IPv4 al establecer una conexión o al elegir una del pool de conexiones. Disponible a partir de cURL 7.10.8. |
CURL_IPRESOLVE_V6
(int)
|
Utilizar únicamente direcciones IPv6 al establecer una conexión o al elegir una del pool de conexiones. Disponible a partir de cURL 7.10.8. |
CURL_IPRESOLVE_WHATEVER
(int)
|
Utilizar direcciones de todas las versiones IP permitidas por el sistema. Disponible a partir de cURL 7.10.8. |
CURL_MAX_READ_SIZE
(int)
|
Disponible a partir de PHP 7.3.0 y cURL 7.53.0 |
CURL_NETRC_IGNORED
(int)
|
|
CURL_NETRC_OPTIONAL
(int)
|
|
CURL_NETRC_REQUIRED
(int)
|
|
CURL_PUSH_DENY
(int)
|
Disponible a partir de PHP 7.1.0 y cURL 7.44.0 |
CURL_PUSH_OK
(int)
|
Disponible a partir de PHP 7.1.0 y cURL 7.44.0 |
CURL_READFUNC_PAUSE
(int)
|
Disponible a partir de cURL 7.18.0 |
CURL_REDIR_POST_301
(int)
|
Disponible a partir de PHP 7.0.7 y cURL 7.18.2 |
CURL_REDIR_POST_302
(int)
|
Disponible a partir de PHP 7.0.7 y cURL 7.18.2 |
CURL_REDIR_POST_303
(int)
|
Disponible a partir de PHP 7.0.7 y cURL 7.25.1 |
CURL_REDIR_POST_ALL
(int)
|
Disponible a partir de PHP 7.0.7 y cURL 7.18.2 |
CURL_RTSPREQ_ANNOUNCE
(int)
|
Cuando enviado por un cliente, este método cambia la descripción de la sesión.
ANNOUNCE actúa como un HTTP PUT o POST
así como CURL_RTSPREQ_SET_PARAMETER.
Disponible a partir de cURL 7.20.0.
|
CURL_RTSPREQ_DESCRIBE
(int)
|
Utilizado para obtener la descripción de bajo nivel de un flujo.
La aplicación debe anotar los formatos que comprende
en el encabezado Accept:. A menos que esté definido manualmente,
libcurl añade automáticamente Accept: application/sdp.
Los encabezados de condición temporal son añadidos a las peticiones DESCRIBE
si la opción CURLOPT_TIMECONDITION es utilizada.
Disponible a partir de cURL 7.20.0.
|
CURL_RTSPREQ_GET_PARAMETER
(int)
|
Recupera un parámetro del servidor.
Por omisión, libcurl añade un encabezado Content-Type: text/parameters
a todas las peticiones no vacías a menos que un encabezado personalizado esté definido.
GET_PARAMETER actúa como un HTTP PUT o POST.
Las aplicaciones que deseen enviar un mensaje de latido
deben utilizar una petición GET_PARAMETER vacía.
Disponible a partir de cURL 7.20.0.
|
CURL_RTSPREQ_OPTIONS
(int)
|
Utilizado para obtener las opciones de la sesión. Disponible a partir de cURL 7.20.0. |
CURL_RTSPREQ_PAUSE
(int)
|
Envía un comando PAUSE al servidor.
Utilizar la opción CURLOPT_RANGE con un solo valor
para indicar cuándo el flujo debe ser detenido (por ejemplo npt=25).
Disponible a partir de cURL 7.20.0.
|
CURL_RTSPREQ_PLAY
(int)
|
Envía un comando PLAY al servidor.
Utilizar la opción CURLOPT_RANGE
para modificar el tiempo de lectura (por ejemplo npt=10-15).
Disponible a partir de cURL 7.20.0.
|
CURL_RTSPREQ_RECEIVE
(int)
|
Define el tipo de petición RTSP para recibir datos RTP entrelazados. Disponible a partir de cURL 7.20.0. |
CURL_RTSPREQ_RECORD
(int)
|
Utilizado para decirle al servidor que grabe una sesión.
Utilizar la opción CURLOPT_RANGE para modificar el tiempo de grabación.
Disponible a partir de cURL 7.20.0.
|
CURL_RTSPREQ_SETUP
(int)
|
Utilizado para inicializar la capa de transporte para la sesión. Disponible a partir de cURL 7.20.0. |
CURL_RTSPREQ_SET_PARAMETER
(int)
|
Define un parámetro en el servidor. Disponible a partir de cURL 7.20.0. |
CURL_RTSPREQ_TEARDOWN
(int)
|
Termina una sesión RTSP. Cerrar simplemente una conexión no termina la sesión RTSP ya que es válido controlar una sesión RTSP en diferentes conexiones. Disponible a partir de cURL 7.20.0. |
CURL_SSLVERSION_DEFAULT
(int)
|
|
CURL_SSLVERSION_MAX_DEFAULT
(int)
|
Disponible a partir de PHP 7.3.0 y cURL 7.54.0 |
CURL_SSLVERSION_MAX_NONE
(int)
|
Disponible a partir de PHP 7.3.0 y cURL 7.54.0 |
CURL_SSLVERSION_MAX_TLSv1_0
(int)
|
Disponible a partir de PHP 7.3.0 y cURL 7.54.0 |
CURL_SSLVERSION_MAX_TLSv1_1
(int)
|
Disponible a partir de PHP 7.3.0 y cURL 7.54.0 |
CURL_SSLVERSION_MAX_TLSv1_2
(int)
|
Disponible a partir de PHP 7.3.0 y cURL 7.54.0 |
CURL_SSLVERSION_MAX_TLSv1_3
(int)
|
Disponible a partir de PHP 7.3.0 y cURL 7.54.0 |
CURL_SSLVERSION_SSLv2
(int)
|
|
CURL_SSLVERSION_SSLv3
(int)
|
|
CURL_SSLVERSION_TLSv1
(int)
|
|
CURL_SSLVERSION_TLSv1_0
(int)
|
|
CURL_SSLVERSION_TLSv1_1
(int)
|
|
CURL_SSLVERSION_TLSv1_2
(int)
|
|
CURL_SSLVERSION_TLSv1_3
(int)
|
Disponible a partir de PHP 7.3.0 y cURL 7.52.0 |
CURL_TIMECOND_IFMODSINCE
(int)
|
|
CURL_TIMECOND_IFUNMODSINCE
(int)
|
|
CURL_TIMECOND_LASTMOD
(int)
|
|
CURL_TIMECOND_NONE
(int)
|
|
CURL_TLSAUTH_SRP
(int)
|
Disponible a partir de cURL 7.21.4. |
CURL_VERSION_ALTSVC
(int)
|
Disponible a partir de PHP 7.3.6 y cURL 7.64.1 |
CURL_VERSION_ASYNCHDNS
(int)
|
Resoluciones DNS asíncronas. Disponible a partir de PHP 7.3.0 y cURL 7.10.7 |
CURL_VERSION_BROTLI
(int)
|
Disponible a partir de PHP 7.3.0 y cURL 7.57.0 |
CURL_VERSION_CONV
(int)
|
Conversiones de caracteres soportadas. Disponible a partir de PHP 7.3.0 y cURL 7.15.4 |
CURL_VERSION_CURLDEBUG
(int)
|
Seguimiento de la memoria de depuración soportado. Disponible a partir de PHP 7.3.6 y cURL 7.19.6 |
CURL_VERSION_DEBUG
(int)
|
Construido con capacidades de depuración. Disponible a partir de PHP 7.3.0 y cURL 7.10.6 |
CURL_VERSION_GSASL
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.76.0 |
CURL_VERSION_GSSAPI
(int)
|
Construido contra una biblioteca GSS-API. Disponible a partir de PHP 7.3.0 y cURL 7.38.0 |
CURL_VERSION_GSSNEGOTIATE
(int)
|
La autenticación Negotiate es soportada. Disponible a partir de PHP 7.3.0 y cURL 7.10.6 (obsoleto a partir de cURL 7.38.0) |
CURL_VERSION_HSTS
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.74.0 |
CURL_VERSION_HTTP2
(int)
|
Soporte HTTP2 integrado. Disponible a partir de cURL 7.33.0 |
CURL_VERSION_HTTP3
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.66.0 |
CURL_VERSION_HTTPS_PROXY
(int)
|
Disponible a partir de PHP 7.3.0 y cURL 7.52.0 |
CURL_VERSION_IDN
(int)
|
Los nombres de dominio internacionalizados son soportados. Disponible a partir de PHP 7.3.0 y cURL 7.12.0 |
CURL_VERSION_IPV6
(int)
|
Soporte IPv6. |
CURL_VERSION_KERBEROS4
(int)
|
La autenticación Kerberos V4 es soportada. |
CURL_VERSION_KERBEROS5
(int)
|
La autenticación Kerberos V5 es soportada. Disponible a partir de PHP 7.0.7 y cURL 7.40.0 |
CURL_VERSION_LARGEFILE
(int)
|
Soporte para ficheros de más de 2 Go. Disponible a partir de cURL 7.33.0 |
CURL_VERSION_LIBZ
(int)
|
Las funcionalidades de libz están presentes. |
CURL_VERSION_MULTI_SSL
(int)
|
Disponible a partir de PHP 7.3.0 y cURL 7.56.0 |
CURL_VERSION_NTLM
(int)
|
La autenticación NTLM es soportada. Disponible a partir de PHP 7.3.0 y cURL 7.10.6 |
CURL_VERSION_NTLM_WB
(int)
|
La delegación NTLM al helper winbind es soportada. Disponible a partir de PHP 7.3.0 y cURL 7.22.0 |
CURL_VERSION_PSL
(int)
|
Lista de sufijos públicos de Mozilla, utilizada para la verificación de dominios de cookies. Disponible a partir de PHP 7.3.6 y cURL 7.47.0 |
CURL_VERSION_SPNEGO
(int)
|
La autenticación SPNEGO es soportada. Disponible a partir de PHP 7.3.0 y cURL 7.10.8 |
CURL_VERSION_SSL
(int)
|
Las opciones SSL están presentes. |
CURL_VERSION_SSPI
(int)
|
Construido contra Windows SSPI. Disponible a partir de PHP 7.3.0 y cURL 7.13.2 |
CURL_VERSION_TLSAUTH_SRP
(int)
|
La autenticación TLS-SRP es soportada. Disponible a partir de PHP 7.3.0 y cURL 7.21.4 |
CURL_VERSION_UNICODE
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.72.0 |
CURL_VERSION_UNIX_SOCKETS
(int)
|
Soporte para sockets de dominio Unix. Disponible a partir de PHP 7.0.7 y cURL 7.40.0 |
CURL_VERSION_ZSTD
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.72.0 |
CURL_WRITEFUNC_PAUSE
(int)
|
Disponible a partir de cURL 7.18.0 |
CURL_PREREQFUNC_OK
(int)
|
Disponible a partir de PHP 8.4.0 y cURL 7.80.0. |
CURL_PREREQFUNC_ABORT
(int)
|
Disponible a partir de PHP 8.4.0 y cURL 7.80.0. |
| Constantes | Descripción | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
CURLOPT_ABSTRACT_UNIX_SOCKET
(int)
|
Activa el uso de un socket Unix abstracto en lugar de
establecer una conexión TCP a un host y define la ruta dada
en string. Esta opción comparte las mismas semánticas
que |
||||||||||||||||
CURLOPT_ACCEPT_ENCODING
(int)
|
Define un string con el contenido
del encabezado |
||||||||||||||||
CURLOPT_ACCEPTTIMEOUT_MS
(int)
|
El número máximo de milisegundos a esperar para que un servidor
se reconecte a cURL cuando se usa una conexión FTP activa.
Por omisión a |
||||||||||||||||
CURLOPT_ADDRESS_SCOPE
(int)
|
El identificador de ámbito a usar al conectarse a una dirección IPv6.
Esta opción acepta cualquier valor que pueda ser convertido en un int válido.
Por omisión a |
||||||||||||||||
CURLOPT_ALTSVC
(int)
|
Pasar un string con el nombre de archivo para que cURL lo use como caché Alt-Svc para leer el contenido
de la caché existente
y eventualmente reescribirlo después de un transferencia, a menos que
|
||||||||||||||||
CURLOPT_ALTSVC_CTRL
(int)
|
Rellena el bitmask con el conjunto correcto de funcionalidades para indicar a cURL cómo manejar Alt-Svc para los
transferencias usando este manejador. cURL solo acepta los encabezados Alt-Svc en HTTPS. También completará
una solicitud a un origen alternativo solo si este origen está correctamente alojado en HTTPS.
Definir un bit activará el motor alt-svc.
Definido en una de las constantes
|
||||||||||||||||
CURLOPT_APPEND
(int)
|
Establecer esta opción a |
||||||||||||||||
CURLOPT_AUTOREFERER
(int)
|
|
||||||||||||||||
CURLOPT_AWS_SIGV4
(int)
|
Proporciona autenticación de firma AWS V4 en el encabezado HTTP(S) como string.
Esta opción reemplaza cualquier otro tipo de autenticación que haya sido definido en
|
||||||||||||||||
CURLOPT_BINARYTRANSFER
(int)
|
Esta constante ya no se usa a partir de PHP 5.5.0. Deprecado a partir de PHP 8.4.0. |
||||||||||||||||
CURLOPT_BUFFERSIZE
(int)
|
Un tamaño de búfer a usar para cada lectura. No hay garantía
de que esta solicitud será satisfecha, sin embargo.
Esta opción acepta cualquier valor que pueda ser convertido en un int válido.
Por omisión, el valor es |
||||||||||||||||
CURLOPT_CAINFO
(int)
|
Un string con el nombre de un archivo que contiene uno o varios certificados para verificar el
par con. Esto solo tiene sentido cuando se usa en combinación con
|
||||||||||||||||
CURLOPT_CAINFO_BLOB
(int)
|
Un string con el nombre de un archivo PEM que contiene uno o varios certificados para verificar el par
con.
Esta opción reemplaza |
||||||||||||||||
CURLOPT_CAPATH
(int)
|
Un string con un directorio que contiene varios certificados CA. Use esta opción
en combinación con |
||||||||||||||||
CURLOPT_CA_CACHE_TIMEOUT
(int)
|
Define el tiempo máximo en segundos durante el cual un almacén de certificados CA
almacenado en caché en memoria puede ser conservado y reutilizado para nuevas conexiones.
Esta opción acepta cualquier valor que pueda ser convertido en un int válido.
Por omisión, el valor es |
||||||||||||||||
CURLOPT_CERTINFO
(int)
|
|
||||||||||||||||
CURLOPT_CONNECTTIMEOUT
(int)
|
El número de segundos a esperar al intentar conectarse. Use 0 para
esperar indefinidamente.
Esta opción acepta cualquier valor que pueda ser convertido en un int válido.
Por omisión, el valor es |
||||||||||||||||
CURLOPT_CONNECTTIMEOUT_MS
(int)
|
El número de milisegundos a esperar al intentar conectarse.
Use |
||||||||||||||||
CURLOPT_CONNECT_ONLY
(int)
|
|
||||||||||||||||
CURLOPT_CONNECT_TO
(int)
|
Conecta a un host y puerto específicos en lugar del host y puerto de la URL.
Acepta un array de strings en el formato
|
||||||||||||||||
CURLOPT_COOKIE
(int)
|
Un string con el contenido del encabezado |
||||||||||||||||
CURLOPT_COOKIEFILE
(int)
|
Un string con el nombre del archivo que contiene los datos de las cookies. El archivo de cookies puede estar en formato Netscape, o simplemente encabezados HTTP clásicos volcados en un archivo. Si el nombre es una cadena vacía, no se cargan cookies, pero la gestión de cookies sigue activada. Disponible a partir de cURL 7.1.0. |
||||||||||||||||
CURLOPT_COOKIEJAR
(int)
|
Un string con el nombre del archivo para guardar todas las cookies internas cuando el destructor del manejador es llamado. Disponible a partir de cURL 7.9.0. Advertencia
a partir de PHP 8.0.0, curl_close() es una operación nula y no destruye ningún manejador. Si las cookies deben ser escritas antes de que el manejador sea destruido automáticamente, llame a unset() en el manejador. |
||||||||||||||||
CURLOPT_COOKIELIST
(int)
|
Un string de cookies (es decir, una sola línea en el formato Netscape/Mozilla, o un encabezado
Set-Cookie HTTP regular) añade esta única cookie al almacenamiento interno de cookies.
|
||||||||||||||||
CURLOPT_COOKIESESSION
(int)
|
|
||||||||||||||||
CURLOPT_CRLF
(int)
|
|
||||||||||||||||
CURLOPT_CRLFILE
(int)
|
Pasar un string nombrando un archivo con la concatenación de
la CRL (Certificate Revocation List) (en formato PEM)
para usar en la validación del certificado que ocurre durante el intercambio SSL.
Cuando cUrl está compilado para usar GnuTLS,
no hay manera de influir en el uso de CRL pasado
para ayudar en el proceso de verificación.
Cuando cUrl está compilado para usar OpenSSL,
|
||||||||||||||||
CURLOPT_CUSTOMREQUEST
(int)
|
Un método de solicitud personalizado a usar en lugar de
|
||||||||||||||||
CURLOPT_DEFAULT_PROTOCOL
(int)
|
Un string con el protocolo por defecto a usar si la URL carece de un nombre de esquema. Disponible a partir de PHP 7.0.7 y cURL 7.45.0. |
||||||||||||||||
CURLOPT_DIRLISTONLY
(int)
|
Definir esta opción a |
||||||||||||||||
CURLOPT_DISALLOW_USERNAME_IN_URL
(int)
|
|
||||||||||||||||
CURLOPT_DNS_CACHE_TIMEOUT
(int)
|
El número de segundos para mantener las entradas DNS en memoria. Esta
opción está definida por omisión a |
||||||||||||||||
CURLOPT_DNS_INTERFACE
(int)
|
Define el nombre de la interfaz de red a la que el resolutor DNS debe enlazarse.
Esto debe ser un nombre de interfaz (no una dirección).
Esta opción acepta un string o |
||||||||||||||||
CURLOPT_DNS_LOCAL_IP4
(int)
|
Define la dirección IPv4 local a la que el resolutor debe enlazarse.
El argumento debe contener una sola dirección IPv4 numérica.
Esta opción acepta un string o |
||||||||||||||||
CURLOPT_DNS_LOCAL_IP6
(int)
|
Define la dirección IPv6 local a la que el resolutor debe enlazarse.
El argumento debe contener una sola dirección IPv6 numérica.
Esta opción acepta un string o |
||||||||||||||||
CURLOPT_DNS_SERVERS
(int)
|
Pasar un string con una lista separada por comas de servidores DNS a usar
en lugar del sistema por defecto
(por ejemplo: |
||||||||||||||||
CURLOPT_DNS_SHUFFLE_ADDRESSES
(int)
|
|
||||||||||||||||
CURLOPT_DNS_USE_GLOBAL_CACHE
(int)
|
|
||||||||||||||||
CURLOPT_DOH_SSL_VERIFYHOST
(int)
|
Establecer en |
||||||||||||||||
CURLOPT_DOH_SSL_VERIFYPEER
(int)
|
Establecer en |
||||||||||||||||
CURLOPT_DOH_SSL_VERIFYSTATUS
(int)
|
Establecer en |
||||||||||||||||
CURLOPT_DOH_URL
(int)
|
Proporciona la URL DNS-over-HTTPS.
Esta opción acepta un string o |
||||||||||||||||
CURLOPT_EGDSOCKET
(int)
|
Como |
||||||||||||||||
CURLOPT_ENCODING
(int)
|
El contenido de los encabezados |
||||||||||||||||
CURLOPT_EXPECT_100_TIMEOUT_MS
(int)
|
El tiempo de espera para las respuestas |
||||||||||||||||
CURLOPT_FAILONERROR
(int)
|
|
||||||||||||||||
CURLOPT_FILE
(int)
|
Acepta un descriptor de fichero
resource
hacia el fichero en el que debe escribirse la transferencia.
El valor por omisión es |
||||||||||||||||
CURLOPT_FILETIME
(int)
|
Definir en |
||||||||||||||||
CURLOPT_FNMATCH_FUNCTION
(int)
|
Pasar un callable que será utilizado para la correspondencia de caracteres genéricos. La firma de la función de devolución de llamada debe ser:
CURL_FNMATCHFUNC_MATCH
si el patrón coincide con el string,
CURL_FNMATCHFUNC_NOMATCH
si no es así
o CURL_FNMATCHFUNC_FAIL si ha ocurrido un error.
Disponible a partir de cURL 7.21.0.
|
||||||||||||||||
CURLOPT_FOLLOWLOCATION
(int)
|
Definir en |
||||||||||||||||
CURLOPT_FORBID_REUSE
(int)
|
Definir en |
||||||||||||||||
CURLOPT_FRESH_CONNECT
(int)
|
Definir en |
||||||||||||||||
CURLOPT_FTPAPPEND
(int)
|
Definir en |
||||||||||||||||
CURLOPT_FTPASCII
(int)
|
Un alias de
|
||||||||||||||||
CURLOPT_FTPLISTONLY
(int)
|
Definir en |
||||||||||||||||
CURLOPT_FTPPORT
(int)
|
Una string que se utilizará para obtener la dirección IP a usar para el comando FTP |
||||||||||||||||
CURLOPT_FTPSSLAUTH
(int)
|
Definir el método de autenticación FTP sobre SSL (si está activado) en una de las
constantes
|
||||||||||||||||
CURLOPT_FTP_ACCOUNT
(int)
|
Pasar un string que será enviado como información de cuenta en FTP
(usando el comando |
||||||||||||||||
CURLOPT_FTP_ALTERNATIVE_TO_USER
(int)
|
Pasar un string que será utilizado para intentar autenticarse en FTP
si la negociación |
||||||||||||||||
CURLOPT_FTP_CREATE_MISSING_DIRS
(int)
|
Definir en |
||||||||||||||||
CURLOPT_FTP_FILEMETHOD
(int)
|
Indica a curl qué método usar para alcanzar un fichero en un servidor FTP(S).
Los valores posibles son
una de las constantes
|
||||||||||||||||
CURLOPT_FTP_RESPONSE_TIMEOUT
(int)
|
El tiempo de espera en segundos que cURL esperará para una respuesta de un servidor FTP
Esta opción reemplaza |
||||||||||||||||
CURLOPT_FTP_SKIP_PASV_IP
(int)
|
Si esta opción está definida en |
||||||||||||||||
CURLOPT_FTP_SSL
(int)
|
Disponible a partir de cURL 7.11.0 y obsoleto a partir de cURL 7.16.4. |
||||||||||||||||
CURLOPT_FTP_SSL_CCC
(int)
|
Esta opción hace que cURL use CCC (Clear Command Channel)
que detiene la capa SSL/TLS después de la autenticación
dejando el resto de la comunicación del canal de control sin cifrar.
Usar una de las constantes
|
||||||||||||||||
CURLOPT_FTP_USE_EPRT
(int)
|
Definir en |
||||||||||||||||
CURLOPT_FTP_USE_EPSV
(int)
|
Definir en |
||||||||||||||||
CURLOPT_FTP_USE_PRET
(int)
|
Definir en |
||||||||||||||||
CURLOPT_GSSAPI_DELEGATION
(int)
|
Definir en
|
||||||||||||||||
CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS
(int)
|
Un avance para IPv6 para el algoritmo Happy Eyeballs. Happy Eyeballs intenta
conectarse tanto a las direcciones IPv4 como IPv6 para los hosts de doble pila,
prefiriendo IPv6 primero para los milisegundos de tiempo de espera.
Por omisión en |
||||||||||||||||
CURLOPT_HAPROXYPROTOCOL
(int)
|
|
||||||||||||||||
CURLOPT_HEADER
(int)
|
Definir en |
||||||||||||||||
CURLOPT_HEADERFUNCTION
(int)
|
Un callable con la siguiente firma:
|
||||||||||||||||
CURLOPT_HEADEROPT
(int)
|
Enviar los encabezados HTTP tanto al proxy como al host o por separado.
Los valores posibles son cualquiera de las
constantes
|
||||||||||||||||
CURLOPT_HSTS
(int)
|
string
con el nombre del archivo de caché HSTS (HTTP Strict Transport Security)
o |
||||||||||||||||
CURLOPT_HSTS_CTRL
(int)
|
Acepta una máscara de bits de las características HSTS (HTTP Strict Transport Security)
definidas por las constantes
|
||||||||||||||||
CURLOPT_HTTP09_ALLOWED
(int)
|
Si se permiten las respuestas HTTP/0.9. Por omisión en |
||||||||||||||||
CURLOPT_HTTP200ALIASES
(int)
|
Un array de respuestas HTTP |
||||||||||||||||
CURLOPT_HTTPAUTH
(int)
|
Una máscara de bits de los métodos de autenticación HTTP a usar. Las opciones son:
|
||||||||||||||||
CURLOPT_HTTPGET
(int)
|
Definir en |
||||||||||||||||
CURLOPT_HTTPHEADER
(int)
|
Un array de campos de encabezado HTTP a definir. Este array debe estar en el formato
|
||||||||||||||||
CURLOPT_HTTPPROXYTUNNEL
(int)
|
|
||||||||||||||||
CURLOPT_HTTP_CONTENT_DECODING
(int)
|
|
||||||||||||||||
CURLOPT_HTTP_TRANSFER_DECODING
(int)
|
Si se define en |
||||||||||||||||
CURLOPT_HTTP_VERSION
(int)
|
Definir en una de las constantes
|
||||||||||||||||
CURLOPT_IGNORE_CONTENT_LENGTH
(int)
|
Si se define en |
||||||||||||||||
CURLOPT_INFILE
(int)
|
Acepta un manejador de fichero resource hacia el fichero desde el que debe leerse la transferencia
durante la descarga.
Disponible a partir de cURL 7.1.0 y deprecado a partir de cURL 7.9.7.
Use |
||||||||||||||||
CURLOPT_INFILESIZE
(int)
|
El tamaño esperado, en bytes, del fichero al enviar un fichero
a un sitio remoto. Es de notar que el uso de esta opción no evitará
que cURL envíe más datos, ya que lo que se envía depende exactamente de
|
||||||||||||||||
CURLOPT_INTERFACE
(int)
|
Definir en una string que contiene el nombre de la interfaz de red saliente a usar. Esto puede ser un nombre de interfaz, una dirección IP o un nombre de host. Disponible a partir de cURL 7.1.0. |
||||||||||||||||
CURLOPT_IPRESOLVE
(int)
|
Permite a una aplicación seleccionar el tipo de direcciones IP a utilizar durante
la resolución de nombres de host. Esto solo es interesante al utilizar nombres de host que
resuelven direcciones usando más de una versión de IP.
Definir en una de las constantes
|
||||||||||||||||
CURLOPT_ISSUERCERT
(int)
|
Si se define a un string que nombra un archivo que contiene un certificado CA en formato PEM,
se realiza una verificación adicional contra el certificado del par
para verificar que el emisor es el asociado
con el certificado proporcionado por la opción.
Para que el resultado de la verificación se considere un fracaso,
esta opción debe usarse en combinación con la opción
|
||||||||||||||||
CURLOPT_ISSUERCERT_BLOB
(int)
|
Pasar un string que contenga datos binarios de un certificado SSL CA en formato PEM. Si esta opción está definida, se realiza una verificación adicional del certificado de la entidad (peer) para verificar que el emisor es el asociado al certificado proporcionado por esta opción. Disponible a partir de PHP 8.1.0 y cURL 7.71.0. |
||||||||||||||||
CURLOPT_KEEP_SENDING_ON_ERROR
(int)
|
Definir en |
||||||||||||||||
CURLOPT_KEYPASSWD
(int)
|
Definir en un string con la contraseña requerida para usar el
|
||||||||||||||||
CURLOPT_KRB4LEVEL
(int)
|
La seguridad KRB4 (Kerberos 4). Cualquier valor string siguiente
(en orden del menos al más potente) es válido:
|
||||||||||||||||
CURLOPT_KRBLEVEL
(int)
|
Define el nivel de seguridad Kerberos para FTP y también activa el soporte de Kerberos.
Esto debe definirse en una de las strings siguientes:
|
||||||||||||||||
CURLOPT_LOCALPORT
(int)
|
Define el número de puerto local del socket usado para la conexión.
Esta opción acepta cualquier valor que pueda convertirse en un int válido.
Por omisión en |
||||||||||||||||
CURLOPT_LOCALPORTRANGE
(int)
|
El número de intentos que cURL hace para encontrar un número de puerto local funcional,
comenzando por el definido con |
||||||||||||||||
CURLOPT_LOGIN_OPTIONS
(int)
|
Puede usarse para definir opciones de conexión específicas del protocolo, tales como el
mecanismo de autenticación preferido vía |
||||||||||||||||
CURLOPT_LOW_SPEED_LIMIT
(int)
|
La velocidad de transferencia, en bytes por segundo, que la transferencia debe ser
inferior durante el conteo de
|
||||||||||||||||
CURLOPT_LOW_SPEED_TIME
(int)
|
El número de segundos que la velocidad de transferencia debe ser inferior
a |
||||||||||||||||
CURLOPT_MAIL_AUTH
(int)
|
Define un string con la dirección de autenticación (identidad)
de un mensaje enviado que es reenviado a otro servidor.
Esta dirección no debe especificarse entre paréntesis
( |
||||||||||||||||
CURLOPT_MAIL_FROM
(int)
|
Define un string con la dirección de correo electrónico del remitente al enviar un correo SMTP.
La dirección de correo electrónico debe especificarse con paréntesis
( |
||||||||||||||||
CURLOPT_MAIL_RCPT
(int)
|
Define un array de strings
con los destinatarios a enviar al servidor en una petición de correo SMTP.
Cada destinatario debe especificarse entre paréntesis
( |
||||||||||||||||
CURLOPT_MAIL_RCPT_ALLLOWFAILS
(int)
|
Definir en |
||||||||||||||||
CURLOPT_MAXAGE_CONN
(int)
|
El tiempo máximo de inactividad permitido para una conexión existente para ser considerada para reutilización.
Por omisión, el tiempo máximo es definido en |
||||||||||||||||
CURLOPT_MAXCONNECTS
(int)
|
El máximo de conexiones persistentes permitidas. Cuando se alcanza el límite, la más antigua en el caché es cerrada para evitar el aumento del número de conexiones abiertas. Esta opción acepta cualquier valor que pueda convertirse en un int válido. Disponible a partir de cURL 7.7.0. |
||||||||||||||||
CURLOPT_MAXFILESIZE
(int)
|
Define el tamaño máximo admitido (en bytes) de un archivo a descargar.
Si el archivo solicitado se encuentra más grande que este valor,
la transferencia es interrumpida
y |
||||||||||||||||
CURLOPT_MAXFILESIZE_LARGE
(int)
|
El tamaño máximo en bytes permitido para la descarga. Si el archivo solicitado se encuentra más grande que este
valor,
la transferencia no comenzará y |
||||||||||||||||
CURLOPT_MAXLIFETIME_CONN
(int)
|
El tiempo máximo en segundos, desde la creación de la conexión, permitido para una conexión
existente para ser considerada para reutilización. Si se encuentra una conexión en el caché que es más antigua
que este valor, será cerrada una vez que todas las transferencias en curso hayan terminado.
Por omisión en |
||||||||||||||||
CURLOPT_MAXREDIRS
(int)
|
La cantidad máxima de redirecciones HTTP a seguir. Usar esta opción junto con |
||||||||||||||||
CURLOPT_MAX_RECV_SPEED_LARGE
(int)
|
Si una descarga supera esta velocidad (contada en bytes por segundo) en promedio acumulativo durante la transferencia, la transferencia será pausada para mantener la velocidad promedio inferior o igual al valor del parámetro. El valor por omisión es una velocidad ilimitada. Esta opción acepta cualquier valor que pueda convertirse en un int válido. Disponible a partir de cURL 7.15.5. |
||||||||||||||||
CURLOPT_MAX_SEND_SPEED_LARGE
(int)
|
Si un envío supera esta velocidad (contada en bytes por segundo) en promedio acumulativo durante la transferencia, la transferencia será pausada para mantener la velocidad promedio inferior o igual al valor del parámetro. El valor por omisión es una velocidad ilimitada. Esta opción acepta cualquier valor que pueda convertirse en un int válido. Disponible a partir de cURL 7.15.5. |
||||||||||||||||
CURLOPT_MIME_OPTIONS
(int)
|
Definir un valor a una máscara de bits de las constantes
|
||||||||||||||||
CURLOPT_MUTE
(int)
|
Definir en |
||||||||||||||||
CURLOPT_NETRC
(int)
|
Definir en |
||||||||||||||||
CURLOPT_NETRC_FILE
(int)
|
Define un string que contiene el nombre completo del archivo .netrc.
Si esta opción es omitida y |
||||||||||||||||
CURLOPT_NEW_DIRECTORY_PERMS
(int)
|
Define el valor de los permisos (int) que son definidos en los directorios recién creados
en el servidor remoto. El valor por omisión es |
||||||||||||||||
CURLOPT_NEW_FILE_PERMS
(int)
|
Define el valor de los permisos (int) que son definidos en los archivos recién creados
en el servidor remoto. El valor por omisión es |
||||||||||||||||
CURLOPT_NOBODY
(int)
|
Definir en |
||||||||||||||||
CURLOPT_NOPROGRESS
(int)
|
Definir en Disponible a partir de cURL 7.1.0. |
||||||||||||||||
CURLOPT_NOPROXY
(int)
|
Define un string consistente en una lista separada por comas de nombres de host
que no requieren proxy para ser alcanzados.
Cada nombre en esta lista es comparado ya sea como un dominio
que contiene el nombre de host o el nombre de host mismo.
El único carácter genérico disponibles en el
string
es un simple carácter |
||||||||||||||||
CURLOPT_NOSIGNAL
(int)
|
|
||||||||||||||||
CURLOPT_PASSWDFUNCTION
(int)
|
Un callable con la siguiente firma:
|
||||||||||||||||
CURLOPT_PASSWORD
(int)
|
Definir en un string que contenga la contraseña a usar para la autenticación. Disponible a partir de cURL 7.19.1. |
||||||||||||||||
CURLOPT_PATH_AS_IS
(int)
|
Definir en |
||||||||||||||||
CURLOPT_PINNEDPUBLICKEY
(int)
|
Definir un string con la clave pública fijada.
El string puede ser el nombre del archivo de la clave pública fijada
en formato PEM o DER. El string también puede ser cualquier número de hachajes sha256 codificados en
base64 precedidos por |
||||||||||||||||
CURLOPT_PIPEWAIT
(int)
|
Establecer en |
||||||||||||||||
CURLOPT_PORT
(int)
|
Un int con un número de puerto alternativo para conectarse en lugar del especificado en la URL o del puerto por defecto para el protocolo utilizado. Disponible a partir de cURL 7.1.0. |
||||||||||||||||
CURLOPT_POST
(int)
|
Establecer en |
||||||||||||||||
CURLOPT_POSTFIELDS
(int)
|
Los datos completos a enviar en una operación HTTP |
||||||||||||||||
CURLOPT_POSTQUOTE
(int)
|
Un array de strings de comandos FTP a ejecutar en el servidor después de ejecutar la petición FTP. Disponible a partir de cURL 7.1.0. |
||||||||||||||||
CURLOPT_POSTREDIR
(int)
|
Establecer en un bitmask de |
||||||||||||||||
CURLOPT_PRE_PROXY
(int)
|
Establece una cadena string que contiene el nombre de host o la dirección IP numérica
a usar como preproxy al que cURL se conecta antes de
conectarse al proxy HTTP(S) especificado en la opción
|
||||||||||||||||
CURLOPT_PREQUOTE
(int)
|
Establece un array de comandos FTP a ejecutar en el servidor antes de la petición después de que la conexión FTP haya sido establecida. Estos comandos no se ejecutan cuando se solicita una lista de directorio, solo para las transferencias de archivos. Disponible a partir de cURL 7.9.5. |
||||||||||||||||
CURLOPT_PRIVATE
(int)
|
Cualquier dato que debería asociarse con este manejador cURL. Estos datos
pueden luego ser recuperados con la opción
|
||||||||||||||||
CURLOPT_PROGRESSFUNCTION
(int)
|
Un callable con la siguiente firma:
callback
(
resource $curlHandle
,int $bytesToDownload
,int $bytesDownloaded
,int $bytesToUpload
,int $bytesUploaded
): int
CURLE_ABORTED_BY_CALLBACK.
Disponible a partir de cURL 7.1.0 y obsoleto a partir de cURL 7.32.0. Usar CURLOPT_XFERINFOFUNCTION en su lugar.
|
||||||||||||||||
CURLOPT_PROTOCOLS
(int)
|
Un bitmask de valores
|
||||||||||||||||
CURLOPT_PROTOCOLS_STR
(int)
|
Establecer en un string que contiene una lista separada por comas
de nombres de protocolos insensibles a mayúsculas/minúsculas (esquemas de URL) permitidos en la transferencia.
Establecer en |
||||||||||||||||
CURLOPT_PROXY
(int)
|
Un string con el proxy HTTP a través del cual realizar las peticiones. Esto debe ser el nombre de host, la dirección IP numérica en notación decimal o una dirección IPv6 numérica escrita entre [corchetes]. Disponible a partir de cURL 7.1.0. |
||||||||||||||||
CURLOPT_PROXYAUTH
(int)
|
Un bitmask de los métodos de autenticación HTTP
(
|
||||||||||||||||
CURLOPT_PROXYHEADER
(int)
|
Un array de encabezados HTTP personalizados como string a enviar al proxy. Disponible a partir de PHP 7.0.7 y cURL 7.37.0. |
||||||||||||||||
CURLOPT_PROXYPASSWORD
(int)
|
Establece un string con la contraseña a usar para la autenticación con el proxy. Disponible a partir de cURL 7.19.1. |
||||||||||||||||
CURLOPT_PROXYPORT
(int)
|
Un int con el número de puerto del proxy a usar para la conexión.
Este número de puerto también puede ser establecido en |
||||||||||||||||
CURLOPT_PROXYTYPE
(int)
|
Establece el tipo de proxy a una de las constantes
|
||||||||||||||||
CURLOPT_PROXYUSERNAME
(int)
|
Establece un string con el nombre de usuario a usar para la autenticación con el proxy. Disponible a partir de cURL 7.19.1. |
||||||||||||||||
CURLOPT_PROXYUSERPWD
(int)
|
Un string que contiene un nombre de usuario y una contraseña en el formato
|
||||||||||||||||
CURLOPT_PROXY_CAINFO
(int)
|
La ruta al archivo de certificados de la Autoridad de Certificación (CA) del proxy. Establecer la ruta como un string que nombre un archivo que contenga uno o más certificados para verificar el proxy HTTPS. Esta opción es para conectarse a un proxy HTTPS, no a un servidor HTTPS. El valor por defecto es la ruta del sistema donde se supone que está almacenado el paquete cacert de cURL Disponible a partir de PHP 7.3.0 y cURL 7.52.0. |
||||||||||||||||
CURLOPT_PROXY_CAINFO_BLOB
(int)
|
Un string con el nombre del archivo PEM que contiene uno o más certificados para verificar el proxy HTTPS. Esta opción es para conectarse a un proxy HTTPS, no a un servidor HTTPS. Por defecto, la ruta del sistema donde se supone que está almacenado el paquete cacert de cURL. Disponible a partir de PHP 8.2.0 y cURL 7.77.0. |
||||||||||||||||
CURLOPT_PROXY_CAPATH
(int)
|
Un string con el directorio que contiene varios certificados CA para verificar el proxy HTTPS. Disponible a partir de PHP 7.3.0 y cURL 7.52.0. |
||||||||||||||||
CURLOPT_PROXY_CRLFILE
(int)
|
Establecer en un string con el nombre de archivo que contiene la lista de revocación de certificados (CRL) en formato PEM a usar en la validación del certificado que ocurre durante el intercambio SSL. Disponible a partir de PHP 7.3.0 y cURL 7.52.0. |
||||||||||||||||
CURLOPT_PROXY_ISSUERCERT
(int)
|
El nombre de archivo del certificado SSL del emisor del proxy como string. Disponible a partir de PHP 8.1.0 y cURL 7.71.0. |
||||||||||||||||
CURLOPT_PROXY_ISSUERCERT_BLOB
(int)
|
Un string con el certificado SSL del emisor del proxy a partir del blob de memoria. Disponible a partir de PHP 8.1.0 y cURL 7.71.0. |
||||||||||||||||
CURLOPT_PROXY_KEYPASSWD
(int)
|
Establece el string a usar como contraseña para cargar la clave privada
|
||||||||||||||||
CURLOPT_PROXY_PINNEDPUBLICKEY
(int)
|
Establece la clave pública anclada para el proxy HTTPS.
El string puede ser el nombre de archivo de la clave pública anclada
que debe estar en formato
|
||||||||||||||||
CURLOPT_PROXY_SERVICE_NAME
(int)
|
Un string con el nombre del servicio de autenticación del proxy. Disponible a partir de PHP 7.0.7, cURL 7.43.0 (para proxys HTTP) y cURL 7.49.0 (para proxys SOCKS5). |
||||||||||||||||
CURLOPT_PROXY_SSLCERT
(int)
|
Un string con el nombre de archivo del certificado cliente usado para conectarse al proxy HTTPS.
El formato por defecto es |
||||||||||||||||
CURLOPT_PROXY_SSLCERTTYPE
(int)
|
Un string con el formato del certificado cliente usado al conectarse a un proxy HTTPS.
Los formatos soportados son |
||||||||||||||||
CURLOPT_PROXY_SSLCERT_BLOB
(int)
|
Un string con el certificado cliente SSL del proxy. Disponible a partir de PHP 8.1.0 y cURL 7.71.0. |
||||||||||||||||
CURLOPT_PROXY_SSLKEY
(int)
|
Un string con el nombre de archivo de la clave privada
usada para conectarse al proxy HTTPS.
El formato por defecto es |
||||||||||||||||
CURLOPT_PROXY_SSLKEYTYPE
(int)
|
Un string con el formato de la clave privada.
Los formatos soportados son:
|
||||||||||||||||
CURLOPT_PROXY_SSLKEY_BLOB
(int)
|
Un string con la clave privada usada para conectarse al proxy HTTPS. Disponible a partir de PHP 8.1.0 y cURL 7.71.0. |
||||||||||||||||
CURLOPT_PROXY_SSLVERSION
(int)
|
Establece la versión TLS del proxy HTTPS preferida en una de las constantes
Advertencia
Disponible a partir de PHP 7.3.0 y cURL 7.52.0.
Es preferible no establecer esta opción y dejar el valor por defecto
|
||||||||||||||||
CURLOPT_PROXY_SSL_CIPHER_LIST
(int)
|
Un string con una lista de cifrados separados por dos puntos a usar para la conexión al proxy HTTPS.
Cuando se usa con OpenSSL, comas y espacios también son aceptables como separadores,
y |
||||||||||||||||
CURLOPT_PROXY_SSL_OPTIONS
(int)
|
Establece las opciones de comportamiento SSL del proxy, que es un bitmask de las
constantes
|
||||||||||||||||
CURLOPT_PROXY_SSL_VERIFYHOST
(int)
|
Establecer en |
||||||||||||||||
CURLOPT_PROXY_SSL_VERIFYPEER
(int)
|
Establecer en |
||||||||||||||||
CURLOPT_PROXY_TLS13_CIPHERS
(int)
|
Una string con una lista de cifrados separados por dos puntos para usar en la conexión al proxy a
través de TLS 1.3.
Esta opción se usa actualmente solo cuando cURL está construido para usar OpenSSL 1.1.1 o una versión posterior.
Al usar otro backend SSL, las suites de cifrado TLS 1.3 pueden ser definidas
con la opción |
||||||||||||||||
CURLOPT_PROXY_TLSAUTH_PASSWORD
(int)
|
Una string que contiene la contraseña a usar para el método de autenticación TLS especificado con el
|
||||||||||||||||
CURLOPT_PROXY_TLSAUTH_TYPE
(int)
|
El método de autenticación TLS usado para la conexión HTTPS.
El método soportado es Disponible a partir de PHP 7.3.0 y cURL 7.52.0. |
||||||||||||||||
CURLOPT_PROXY_TLSAUTH_USERNAME
(int)
|
El nombre de usuario a usar para el método de autenticación TLS del proxy HTTPS especificado con la opción
|
||||||||||||||||
CURLOPT_PROXY_TRANSFER_MODE
(int)
|
Establecer en |
||||||||||||||||
CURLOPT_PUT
(int)
|
|
||||||||||||||||
CURLOPT_QUICK_EXIT
(int)
|
Establecer en |
||||||||||||||||
CURLOPT_QUOTE
(int)
|
Un array de comandos FTP para ejecutar en el servidor antes de la solicitud FTP. Disponible a partir de cURL 7.1.0. |
||||||||||||||||
CURLOPT_RANDOM_FILE
(int)
|
Una string con un nombre de archivo para usar para inicializar el generador de números aleatorios para SSL. Disponible a partir de cURL 7.7.0 y obsoleto a partir de cURL 7.84.0. |
||||||||||||||||
CURLOPT_RANGE
(int)
|
Una string con el/los rango(s) de datos a recuperar en formato |
||||||||||||||||
CURLOPT_READDATA
(int)
|
Define un puntero de archivo resource que será usado por la función de lectura de archivo
definida con |
||||||||||||||||
CURLOPT_READFUNCTION
(int)
|
Un callable con la siguiente firma:
fin de archivo.
Disponible a partir de cURL 7.1.0.
|
||||||||||||||||
CURLOPT_REDIR_PROTOCOLS
(int)
|
Una máscara de bits de valores
|
||||||||||||||||
CURLOPT_REDIR_PROTOCOLS_STR
(int)
|
Establecer en una string con una lista separada por comas
de nombres de protocolos insensibles a mayúsculas/minúsculas (esquemas de URL)
para permitir durante una redirección cuando
|
||||||||||||||||
CURLOPT_REFERER
(int)
|
Una string que contiene el contenido del encabezado
|
||||||||||||||||
CURLOPT_REQUEST_TARGET
(int)
|
Una string para usar en la solicitud entrante en lugar de la ruta extraída de la URL. Disponible a partir de PHP 7.3.0 y cURL 7.55.0. |
||||||||||||||||
CURLOPT_RESOLVE
(int)
|
Proporcionar un array de strings separados por dos puntos
con direcciones personalizadas para pares de host y puerto específicos en el siguiente formato:
|
||||||||||||||||
CURLOPT_RESUME_FROM
(int)
|
El desplazamiento, en bytes, para reanudar una transferencia. Esta opción acepta cualquier valor que pueda convertirse en un int válido. Disponible a partir de cURL 7.1.0. |
||||||||||||||||
CURLOPT_RETURNTRANSFER
(int)
|
|
||||||||||||||||
CURLOPT_RTSP_CLIENT_CSEQ
(int)
|
Define un int con el número CSEQ para emitir en la próxima solicitud RTSP.
Usar si la aplicación reanuda una conexión previamente interrumpida.
El CSEQ se incrementa a partir de este nuevo número posteriormente.
Por defecto en |
||||||||||||||||
CURLOPT_RTSP_REQUEST
(int)
|
Define el tipo de solicitud RTSP a realizar.
Debe ser una de las constantes
|
||||||||||||||||
CURLOPT_RTSP_SERVER_CSEQ
(int)
|
Define un int con el número CSEQ para esperar
en la próxima solicitud RTSP del servidor.
Esta funcionalidad (escuchar solicitudes del servidor) no está implementada.
Por defecto en |
||||||||||||||||
CURLOPT_RTSP_SESSION_ID
(int)
|
Define un string con el valor del identificador de la sesión RTSP actual para el manejador.
Una vez que este valor se establece en un valor no- |
||||||||||||||||
CURLOPT_RTSP_STREAM_URI
(int)
|
Define un string con el URI del flujo sobre el que operar.
Si no está definido, cURL define por defecto la operación en las opciones de servidor genéricas
pasando |
||||||||||||||||
CURLOPT_RTSP_TRANSPORT
(int)
|
Define el encabezado |
||||||||||||||||
CURLOPT_SAFE_UPLOAD
(int)
|
Siempre |
||||||||||||||||
CURLOPT_SASL_AUTHZID
(int)
|
La identidad de autorización (authzid) string para la transferencia. Aplicable solo a SASL PLAIN donde es opcional. Cuando no se especifica, solo la identidad de autenticación (authcid) tal como se especifica por el nombre de usuario será enviada al servidor, con la contraseña. El servidor deducirá el authzid del authcid cuando no se proporcione, que luego usará internamente. Disponible a partir de PHP 8.2.0 y cURL 7.66.0. |
||||||||||||||||
CURLOPT_SASL_IR
(int)
|
|
||||||||||||||||
CURLOPT_SERVICE_NAME
(int)
|
Un string con el nombre del servicio de autenticación. Disponible a partir de PHP 7.0.7 y cURL 7.43.0. |
||||||||||||||||
CURLOPT_SHARE
(int)
|
Un resultado de curl_share_init(). Hace que el manejador cURL use los datos del manejador compartido. Disponible a partir de cURL 7.10. |
||||||||||||||||
CURLOPT_SOCKS5_AUTH
(int)
|
|
||||||||||||||||
CURLOPT_SOCKS5_GSSAPI_NEC
(int)
|
Establecer en |
||||||||||||||||
CURLOPT_SOCKS5_GSSAPI_SERVICE
(int)
|
Define un string que contiene el nombre del servicio SOCKSS.
Por defecto en |
||||||||||||||||
CURLOPT_SSH_AUTH_TYPES
(int)
|
Una máscara de bits compuesta por una o más de las siguientes constantes:
|
||||||||||||||||
CURLOPT_SSH_COMPRESSION
(int)
|
|
||||||||||||||||
CURLOPT_SSH_HOSTKEYFUNCTION
(int)
|
Un callable que será llamado cuando la verificación de la clave del host SSH sea necesaria. La devolución de llamada debe tener la siguiente firma:
CURLOPT_SSH_KNOWNHOSTS.
Disponible a partir de PHP 8.3.0 y cURL 7.84.0.
|
||||||||||||||||
CURLOPT_SSH_HOST_PUBLIC_KEY_MD5
(int)
|
Una string que contiene 32 dígitos hexadecimales que deben contener el checksum MD5 de la clave pública del host remoto, y cURL rechazará la conexión al host a menos que las sumas de control md5 coincidan. Esta opción es únicamente para transferencias SCP y SFTP. Disponible a partir de cURL 7.17.1. |
||||||||||||||||
CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256
(int)
|
Una string con el hash SHA256 codificado en base64 de la clave pública del host remoto. La transferencia fallará si el hash proporcionado no coincide con el hash proporcionado por el host remoto. Disponible a partir de PHP 8.2.0 y cURL 7.80.0. |
||||||||||||||||
CURLOPT_SSH_KNOWNHOSTS
(int)
|
Define el nombre del archivo known_host a utilizar que debería usar el formato de archivo OpenSSH soportado por libssh2. Disponible a partir de cURL 7.19.6. |
||||||||||||||||
CURLOPT_SSH_PRIVATE_KEYFILE
(int)
|
El nombre del archivo de su clave privada. Si no se usa, cURL usa por omisión
$HOME/.ssh/id_dsa
si la variable de entorno HOME está definida,
y solo |
||||||||||||||||
CURLOPT_SSH_PUBLIC_KEYFILE
(int)
|
El nombre del archivo de su clave pública. Si no se usa, cURL usa por omisión
$HOME/.ssh/id_dsa.pub
si la variable de entorno HOME está definida,
y solo |
||||||||||||||||
CURLOPT_SSLCERT
(int)
|
El nombre de un archivo que contiene un certificado en formato PEM. Disponible a partir de cURL 7.1.0. |
||||||||||||||||
CURLOPT_SSLCERTPASSWD
(int)
|
La contraseña requerida para usar el certificado
|
||||||||||||||||
CURLOPT_SSLCERTTYPE
(int)
|
Una string con el formato del certificado. Los formatos soportados son :
|
||||||||||||||||
CURLOPT_SSLCERT_BLOB
(int)
|
Una string con el certificado SSL del cliente. Disponible a partir de PHP 8.1.0 y cURL 7.71.0. |
||||||||||||||||
CURLOPT_SSLENGINE
(int)
|
El identificador string para el motor criptográfico de la clave SSL privada
especificada en |
||||||||||||||||
CURLOPT_SSLENGINE_DEFAULT
(int)
|
El identificador del motor de criptografía usado para las operaciones de criptografía asimétrica. |
||||||||||||||||
CURLOPT_SSLKEY
(int)
|
El nombre de un archivo que contiene una clave privada SSL. Disponible a partir de cURL 7.9.3. |
||||||||||||||||
CURLOPT_SSLKEYPASSWD
(int)
|
La contraseña requerida para usar la clave privada SSL
especificada en Disponible a partir de cURL 7.9.3 y desaconsejado a partir de cURL 7.17.0. |
||||||||||||||||
CURLOPT_SSLKEYTYPE
(int)
|
El tipo de clave privada SSL especificada en
|
||||||||||||||||
CURLOPT_SSLKEY_BLOB
(int)
|
Una string clave privada para el certificado del cliente. Disponible a partir de PHP 8.1.0 y cURL 7.71.0. |
||||||||||||||||
CURLOPT_SSLVERSION
(int)
|
Una de
las constantes siguientes
Advertencia
Por omisión, es
Es preferible no definir esta opción y dejar los valores por omisión.
Definir esta opción a
CURL_SSLVERSION_DEFAULT.
Disponible a partir de cURL 7.1.0.
|
||||||||||||||||
CURLOPT_SSL_CIPHER_LIST
(int)
|
Una string separada por dos puntos de los cifrados a usar para la conexión TLS 1.2 (1.1, 1.0). Disponible a partir de cURL 7.9. |
||||||||||||||||
CURLOPT_SSL_EC_CURVES
(int)
|
Una lista de curvas elípticas delimitadas por dos puntos. Por ejemplo,
|
||||||||||||||||
CURLOPT_SSL_ENABLE_ALPN
(int)
|
|
||||||||||||||||
CURLOPT_SSL_ENABLE_NPN
(int)
|
|
||||||||||||||||
CURLOPT_SSL_FALSESTART
(int)
|
|
||||||||||||||||
CURLOPT_SSL_OPTIONS
(int)
|
Definir las opciones de comportamiento SSL, que son una máscara de bits de las
constantes
|
||||||||||||||||
CURLOPT_SSL_SESSIONID_CACHE
(int)
|
Definir a |
||||||||||||||||
CURLOPT_SSL_VERIFYHOST
(int)
|
|
||||||||||||||||
CURLOPT_SSL_VERIFYPEER
(int)
|
|
||||||||||||||||
CURLOPT_SSL_VERIFYSTATUS
(int)
|
|
||||||||||||||||
CURLOPT_STDERR
(int)
|
Acepta un descriptor de archivo resource que apunta hacia
una ubicación alternativa para enviar errores en lugar de
|
||||||||||||||||
CURLOPT_STREAM_WEIGHT
(int)
|
Definir el peso numérico del flujo (un número entre |
||||||||||||||||
CURLOPT_SUPPRESS_CONNECT_HEADERS
(int)
|
|
||||||||||||||||
CURLOPT_TCP_FASTOPEN
(int)
|
|
||||||||||||||||
CURLOPT_TCP_KEEPALIVE
(int)
|
Si se define a |
||||||||||||||||
CURLOPT_TCP_KEEPIDLE
(int)
|
Define el intervalo, en segundos, que el sistema operativo esperará mientras la conexión está
inutilizada antes de enviar sondas de mantenimiento de conexión, si |
||||||||||||||||
CURLOPT_TCP_KEEPINTVL
(int)
|
Define el intervalo, en segundos, que el sistema operativo esperará entre el envío
de sondas de mantenimiento de conexión, si |
||||||||||||||||
CURLOPT_TCP_KEEPCNT
(int)
|
Define el número máximo de sondas de mantenimiento de conexión TCP.
El valor por omisión es |
||||||||||||||||
CURLOPT_TCP_NODELAY
(int)
|
|
||||||||||||||||
CURLOPT_TELNETOPTIONS
(int)
|
Define un array de strings a pasar a las negociaciones telnet.
Estas variables deben estar en el formato |
||||||||||||||||
CURLOPT_TFTP_BLKSIZE
(int)
|
Define el tamaño de bloque a usar para la transmisión de datos TFTP.
El rango válido es de |
||||||||||||||||
CURLOPT_TFTP_NO_OPTIONS
(int)
|
|
||||||||||||||||
CURLOPT_TIMECONDITION
(int)
|
Definir cómo |
||||||||||||||||
CURLOPT_TIMEOUT
(int)
|
El número máximo de segundos a esperar para las funciones cURL.
Por omisión, es |
||||||||||||||||
CURLOPT_TIMEOUT_MS
(int)
|
El número máximo de milisegundos a esperar para las funciones cURL
se ejecutan.
Si cURL está compilado para usar el resolutor de nombres estándar del sistema,
esta parte de la conexión siempre usará una resolución de segundo completo
para los tiempos de espera con un mínimo permitido de un segundo.
Por omisión, es |
||||||||||||||||
CURLOPT_TIMEVALUE
(int)
|
El tiempo en segundos desde el 1 de enero de 1970. El tiempo será usado
por |
||||||||||||||||
CURLOPT_TIMEVALUE_LARGE
(int)
|
El tiempo en segundos desde el 1 de enero de 1970. El tiempo será usado
por |
||||||||||||||||
CURLOPT_TLS13_CIPHERS
(int)
|
Una string con una lista de cifrados separados por dos puntos
a usar para la conexión TLS 1.3.
Esta opción actualmente solo se usa cuando cURL está compilado con OpenSSL 1.1.1 o versión posterior.
Al usar otro backend SSL, las suites de cifrado TLS 1.3 pueden ser definidas
con la opción |
||||||||||||||||
CURLOPT_TLSAUTH_PASSWORD
(int)
|
El tiempo de espera para las respuestas |
||||||||||||||||
CURLOPT_TLSAUTH_TYPE
(int)
|
Define una string con el método de autenticación TLS.
El método soportado es
|
||||||||||||||||
CURLOPT_TLSAUTH_USERNAME
(int)
|
Define un string con el nombre de usuario a utilizar para el método de autenticación TLS
especificado con la opción |
||||||||||||||||
CURLOPT_TRANSFER_ENCODING
(int)
|
Define a |
||||||||||||||||
CURLOPT_TRANSFERTEXT
(int)
|
|
||||||||||||||||
CURLOPT_UNIX_SOCKET_PATH
(int)
|
Activa el uso de sockets de dominio Unix como punto de conexión y
define la ruta del string dado.
Definir en |
||||||||||||||||
CURLOPT_UNRESTRICTED_AUTH
(int)
|
|
||||||||||||||||
CURLOPT_UPKEEP_INTERVAL_MS
(int)
|
Algunos protocolos tienen mecanismos de "mantenimiento de la conexión". Estos mecanismos generalmente envían
tráfico en las conexiones existentes para mantenerlas vivas. Esta opción define el intervalo de mantenimiento de la
conexión.
Actualmente, el único protocolo con un mecanismo de mantenimiento de la conexión es HTTP/2. Cuando el intervalo de
mantenimiento de la
conexión es excedido, un marco PING HTTP/2 es enviado en la conexión.
Por omisión, es
|
||||||||||||||||
CURLOPT_UPLOAD
(int)
|
|
||||||||||||||||
CURLOPT_UPLOAD_BUFFERSIZE
(int)
|
El tamaño de búfer preferido en bytes para la subida cURL. El tamaño de búfer de subida por omisión es de 64 kilobytes. El tamaño máximo de búfer permitido a ser definido es de 2 megabytes. El tamaño mínimo de búfer permitido a ser definido es de 16 kilobytes. Disponible a partir de PHP 8.2.0 y cURL 7.62.0. |
||||||||||||||||
CURLOPT_URL
(int)
|
La URL a recuperar. Esto también puede ser definido durante la inicialización de una sesión con curl_init(). Disponible a partir de cURL 7.1.0. |
||||||||||||||||
CURLOPT_USE_SSL
(int)
|
Define el nivel de SSL/TLS deseado para la transferencia
al utilizar FTP, SMTP, POP3, IMAP, etc.
Estos son todos protocolos que comienzan en texto claro
y son "mejorados" en SSL utilizando el comando STARTTLS.
Definir en una de las constantes
|
||||||||||||||||
CURLOPT_USERAGENT
(int)
|
El contenido del encabezado |
||||||||||||||||
CURLOPT_USERNAME
(int)
|
El nombre de usuario a utilizar en la autenticación. Disponible a partir de cURL 7.19.1. |
||||||||||||||||
CURLOPT_USERPWD
(int)
|
El nombre de usuario y la contraseña en la forma
|
||||||||||||||||
CURLOPT_VERBOSE
(int)
|
|
||||||||||||||||
CURLOPT_WILDCARDMATCH
(int)
|
Definir en |
||||||||||||||||
CURLOPT_WRITEFUNCTION
(int)
|
Un callable con la siguiente firma:
|
||||||||||||||||
CURLOPT_WRITEHEADER
(int)
|
Acepta un manejador de archivo resource hacia el archivo en el cual la parte de encabezado de la transferencia es escrita. Disponible a partir de cURL 7.1.0. |
||||||||||||||||
CURLOPT_WS_OPTIONS
(int)
|
Acepta una máscara de bits para definir las opciones de comportamiento WebSocket.
La única opción disponible es |
||||||||||||||||
CURLOPT_XFERINFOFUNCTION
(int)
|
Un callable con la siguiente firma:
callback
(
resource $curlHandle
,int $bytesToDownload
,int $bytesDownloaded
,int $bytesToUpload
,int $bytesUploaded
): int
1 para cancelar la transferencia
y establecer un error CURLE_ABORTED_BY_CALLBACK.
Disponible a partir de PHP 8.2.0 y cURL 7.32.0.
|
||||||||||||||||
CURLOPT_SERVER_RESPONSE_TIMEOUT
(int)
|
Un tiempo de espera en segundos que cURL esperará para una respuesta de un
servidor FTP, SFTP, IMAP,
SCP, SMTP, o un servidor POP3.
Esta opción reemplaza la opción existente
|
||||||||||||||||
CURLOPT_XOAUTH2_BEARER
(int)
|
Especifica el token de acceso OAuth 2.0.
Definir en |
||||||||||||||||
CURLOPT_PREREQFUNCTION
(int)
|
Un callable con la siguiente firma que es llamada después de establecer la conexión, pero antes de que la carga útil de la solicitud (por ejemplo, la solicitud GET/POST/DELETE de una conexión HTTP) sea enviada, y que puede ser utilizada para cancelar o autorizar la conexión en función de la dirección IP de origen y los números de puerto de origen y destino:
callback
(
CurlHandle $curlHandle
,string $destination_ip
,string $local_ip
,int $destination_port
,int $local_port
): int
CURL_PREREQFUNC_OK para autorizar la solicitud, o
CURL_PREREQFUNC_ABORT
para cancelar la transferencia.
Disponible a partir de PHP 8.4.0 y cURL 7.80.0.
|
||||||||||||||||
CURLOPT_DEBUGFUNCTION
(int)
|
Disponible a partir de PHP 8.4.0.
Esta opción requiere la opción
|
| Constantes | Descripción |
|---|---|
CURL_LOCK_DATA_CONNECT
(int)
|
Comparte/descomparte la conexión. Disponible a partir de PHP 7.3.0 y cURL 7.10.3. |
CURL_LOCK_DATA_COOKIE
(int)
|
Comparte/descomparte los datos de cookie. Disponible a partir de cURL 7.10.3. |
CURL_LOCK_DATA_DNS
(int)
|
Comparte/descomparte la caché DNS. Es de notar que cuando se utilizan múltiples gestores cURL, todos los gestores añadidos al gestor múltiple compartirán la caché DNS por omisión. Disponible a partir de cURL 7.10.3. |
CURL_LOCK_DATA_PSL
(int)
|
Comparte/descomparte la lista de sufijos públicos. Disponible a partir de PHP 7.3.0 y cURL 7.61.0. |
CURL_LOCK_DATA_SSL_SESSION
(int)
|
Comparte/descomparte los identificadores de sesión SSL, reduciendo el tiempo pasado en la gestión SSL al reconectar al mismo servidor. Es de notar que los identificadores de sesión SSL son reutilizados en el mismo gestor por omisión. Disponible a partir de cURL 7.10.3. |
CURLSHOPT_NONE
(int)
|
Disponible a partir de cURL 7.10.3. |
CURLSHOPT_SHARE
(int)
|
Especifica un tipo de datos a compartir. Disponible a partir de cURL 7.10.3. |
CURLSHOPT_UNSHARE
(int)
|
Especifica un tipo de datos que ya no será compartido. Disponible a partir de cURL 7.10.3. |
| Constantes | Descripción |
|---|---|
CURLINFO_APPCONNECT_TIME
(int)
|
El tiempo en segundos que ha sido necesario para establecer la conexión SSL/SSH con el host remoto. |
CURLINFO_APPCONNECT_TIME_T
(int)
|
El tiempo en microsegundos que ha sido necesario para establecer la conexión SSL/SSH con el host remoto. Disponible a partir de PHP 7.3.0 y cURL 7.61.0 |
CURLINFO_CAINFO
(int)
|
Ruta nativa del certificado CA. Disponible a partir de PHP 8.3.0 y cURL 7.84.0 |
CURLINFO_CAPATH
(int)
|
Ruta nativa del CA. Disponible a partir de PHP 8.3.0 y cURL 7.84.0 |
CURLINFO_CERTINFO
(int)
|
La cadena del certificado TLS. TLS certificate chain |
CURLINFO_CONDITION_UNMET
(int)
|
Información sobre la condición temporal no cumplida. |
CURLINFO_CONNECT_TIME
(int)
|
El tiempo en segundos que ha sido necesario para establecer la conexión. |
CURLINFO_CONNECT_TIME_T
(int)
|
El tiempo total, en microsegundos, desde el inicio hasta que la conexión con el host remoto (o el proxy) se haya completado. Disponible a partir de PHP 7.3.0 y cURL 7.61.0 |
CURLINFO_CONTENT_LENGTH_DOWNLOAD
(int)
|
La longitud del contenido descargado, leída desde el campo Content-Length: |
CURLINFO_CONTENT_LENGTH_DOWNLOAD_T
(int)
|
El contenido de la longitud de la descarga. Es el valor leído desde el campo Content-Length:. -1 si el tamaño no es conocido. Disponible a partir de PHP 7.3.0 y cURL 7.55.0 |
CURLINFO_CONTENT_LENGTH_UPLOAD
(int)
|
El tamaño especificado del envío. |
CURLINFO_CONTENT_LENGTH_UPLOAD_T
(int)
|
El tamaño especificado del envío. -1 si el tamaño no es conocido. Disponible a partir de PHP 7.3.0 y cURL 7.55.0 |
CURLINFO_CONTENT_TYPE
(int)
|
El Content-Type: del documento solicitado.
NULL indica que el servidor no ha enviado un encabezado Content-Type: válido.
|
CURLINFO_COOKIELIST
(int)
|
Las cookies conocidas. |
CURLINFO_EFFECTIVE_METHOD
(int)
|
Devuelve el último método HTTP utilizado. |
CURLINFO_EFFECTIVE_URL
(int)
|
La última URL efectiva. |
CURLINFO_FILETIME
(int)
|
El tiempo remoto del documento recuperado, con CURLOPT_FILETIME activado; si -1 es devuelto, el tiempo del documento es desconocido.
|
CURLINFO_FILETIME_T
(int)
|
El tiempo remoto del documento recuperado (como un timestamp Unix), una alternativa a CURLINFO_FILETIME para permitir a los sistemas con variables largas de 32 bits extraer fechas fuera del rango de tiempo de 32 bits.
Disponible a partir de PHP 7.3.0 y cURL 7.59.0
|
CURLINFO_FTP_ENTRY_PATH
(int)
|
La ruta de entrada en el servidor FTP. |
CURLINFO_HEADER_OUT
(int)
|
La cadena de solicitud enviada. Para que esto funcione, añada la opción CURLINFO_HEADER_OUT al manejador llamando a curl_setopt().
|
CURLINFO_HEADER_SIZE
(int)
|
El tamaño total de todos los encabezados recibidos. |
CURLINFO_HTTPAUTH_AVAIL
(int)
|
La máscara de bits que indica el método de autenticación disponible(s) según la respuesta anterior. |
CURLINFO_HTTP_CODE
(int)
|
El último código de respuesta.
A partir de cURL 7.10.8, es un alias heredado de CURLINFO_RESPONSE_CODE.
|
CURLINFO_HTTP_CONNECTCODE
(int)
|
El código de respuesta CONNECT. |
CURLINFO_HTTP_VERSION
(int)
|
La versión utilizada en la última conexión HTTP. El valor de retorno será una de las constantes CURL_HTTP_VERSION_* definidas o 0 si la versión no puede ser determinada.
Disponible a partir de PHP 7.3.0 y cURL 7.50.0
|
CURLINFO_LASTONE
(int)
|
El último valor de enumeración en la enumeración CURLINFO subyacente en libcurl.
|
CURLINFO_LOCAL_IP
(int)
|
La dirección IP local (fuente) de la última conexión. |
CURLINFO_LOCAL_PORT
(int)
|
El puerto local (fuente) de la última conexión. |
CURLINFO_NAMELOOKUP_TIME
(int)
|
El tiempo en segundos hasta que la resolución del nombre esté completa. |
CURLINFO_NAMELOOKUP_TIME_T
(int)
|
El tiempo en microsegundos hasta que la resolución del nombre esté completa. Disponible a partir de PHP 7.3.0 y cURL 7.61.0 |
CURLINFO_NUM_CONNECTS
(int)
|
El número de conexiones que curl ha tenido que crear para realizar la transferencia anterior. |
CURLINFO_OS_ERRNO
(int)
|
El número de error del fallo de conexión. El número es específico del sistema operativo y del sistema. |
CURLINFO_PRETRANSFER_TIME
(int)
|
El tiempo en segundos desde el inicio hasta justo antes de que la transferencia de fichero comience. |
CURLINFO_PRETRANSFER_TIME_T
(int)
|
El tiempo transcurrido desde el inicio hasta que la transferencia de fichero comience, en microsegundos. Disponible a partir de PHP 7.3.0 y cURL 7.61.0 |
CURLINFO_PRIMARY_IP
(int)
|
La dirección IP de la última conexión. |
CURLINFO_PRIMARY_PORT
(int)
|
El puerto de destino de la última conexión. |
CURLINFO_PRIVATE
(int)
|
Los datos privados asociados a esta conexión cURL, previamente definidos con la opción CURLOPT_PRIVATE de curl_setopt().
|
CURLINFO_PROTOCOL
(int)
|
El protocolo utilizado en la última conexión HTTP. El valor de retorno será exactamente uno de los valores CURLPROTO_*.
Disponible a partir de PHP 7.3.0 y cURL 7.52.0
|
CURLINFO_PROXYAUTH_AVAIL
(int)
|
La máscara de bits que indica el método de autenticación de proxy disponible según la respuesta anterior. |
CURLINFO_PROXY_ERROR
(int)
|
El detalle del código de error (SOCKS) proxy cuando la última transferencia ha devuelto un error CURLE_PROXY. El valor devuelto será exactamente uno de los valores CURLPX_*. El código de error será CURLPX_OK si ningún código de respuesta estaba disponible.
Disponible a partir de PHP 8.2.0 y cURL 7.73.0
|
CURLINFO_PROXY_SSL_VERIFYRESULT
(int)
|
El resultado de la verificación del certificado que ha sido solicitada (usando la opción CURLOPT_PROXY_SSL_VERIFYPEER). Utilizado únicamente para proxies HTTPS.
Disponible a partir de PHP 7.3.0 y cURL 7.52.0
|
CURLINFO_REDIRECT_COUNT
(int)
|
El número de redirecciones, con la opción CURLOPT_FOLLOWLOCATION activada.
|
CURLINFO_REDIRECT_TIME
(int)
|
El tiempo en segundos de todas las etapas de redirección antes de que la transacción final comience, con la opción CURLOPT_FOLLOWLOCATION activada.
|
CURLINFO_REDIRECT_TIME_T
(int)
|
El tiempo total, en microsegundos, que ha sido necesario para todas las etapas de redirección, incluyendo la resolución de nombre, la conexión, el pre-transferencia y la transferencia antes de que la transacción final comience. Disponible a partir de PHP 7.3.0 y cURL 7.61.0 |
CURLINFO_REDIRECT_URL
(int)
|
Con la opción CURLOPT_FOLLOWLOCATION desactivada: URL de redirección encontrada en la última transacción, que debería ser solicitada manualmente después. Con la opción CURLOPT_FOLLOWLOCATION activada: está vacía. La URL de redirección en este caso está disponible en CURLINFO_EFFECTIVE_URL.
|
CURLINFO_REFERER
(int)
|
El encabezado Referer.
Disponible a partir de PHP 8.2.0 y cURL 7.76.0
|
CURLINFO_REQUEST_SIZE
(int)
|
El tamaño total de las solicitudes emitidas, actualmente únicamente para las solicitudes HTTP. |
CURLINFO_RESPONSE_CODE
(int)
|
El último código de respuesta. Disponible a partir de cURL 7.10.8 |
CURLINFO_RETRY_AFTER
(int)
|
La información del encabezado Retry-After, o cero si no había un encabezado válido.
Disponible a partir de PHP 8.2.0 y cURL 7.66.0
|
CURLINFO_RTSP_CLIENT_CSEQ
(int)
|
La próxima secuencia CSeq del cliente RTSP. |
CURLINFO_RTSP_CSEQ_RECV
(int)
|
La recepción CSeq RTSP reciente. |
CURLINFO_RTSP_SERVER_CSEQ
(int)
|
La próxima secuencia CSeq del servidor RTSP. |
CURLINFO_RTSP_SESSION_ID
(int)
|
El ID de sesión RTSP. |
CURLINFO_SCHEME
(int)
|
El esquema de URL utilizado para la última conexión. Disponible a partir de PHP 7.3.0 y cURL 7.52.0 |
CURLINFO_SIZE_DOWNLOAD
(int)
|
El número total de octetos descargados. |
CURLINFO_SIZE_DOWNLOAD_T
(int)
|
El número total de octetos descargados. El número es únicamente para la última transferencia y será reiniciado para cada nueva transferencia. Disponible a partir de PHP 7.3.0 y cURL 7.50.0 |
CURLINFO_SIZE_UPLOAD
(int)
|
El número total de octetos subidos. |
CURLINFO_SIZE_UPLOAD_T
(int)
|
El número total de octetos subidos. Disponible a partir de PHP 7.3.0 y cURL 7.50.0 |
CURLINFO_SPEED_DOWNLOAD
(int)
|
La velocidad media de descarga. |
CURLINFO_SPEED_DOWNLOAD_T
(int)
|
La velocidad media de descarga en octetos/segundo que curl ha medido para la descarga completa. Disponible a partir de PHP 7.3.0 y cURL 7.50.0 |
CURLINFO_SPEED_UPLOAD
(int)
|
La velocidad media de subida. |
CURLINFO_SPEED_UPLOAD_T
(int)
|
La velocidad media de subida en octetos/segundo que curl ha medido para la subida completa. Disponible a partir de PHP 7.3.0 y cURL 7.50.0 |
CURLINFO_SSL_ENGINES
(int)
|
Los motores de criptografía OpenSSL soportados. |
CURLINFO_SSL_VERIFYRESULT
(int)
|
El resultado de la verificación del certificado SSL solicitada definiendo CURLOPT_SSL_VERIFYPEER.
|
CURLINFO_STARTTRANSFER_TIME
(int)
|
El tiempo en segundos hasta que el primer octeto esté a punto de ser transferido. |
CURLINFO_STARTTRANSFER_TIME_T
(int)
|
El tiempo, en microsegundos, que ha sido necesario desde el inicio hasta que el primer octeto sea recibido. Disponible a partir de PHP 7.3.0 y cURL 7.61.0 |
CURLINFO_TOTAL_TIME
(int)
|
El tiempo total en segundos para la última transferencia. |
CURLINFO_TOTAL_TIME_T
(int)
|
El tiempo total en microsegundos para la última transferencia, incluyendo la resolución de nombre, la conexión TCP, etc. Disponible a partir de PHP 7.3.0 y cURL 7.61.0 |
CURLINFO_POSTTRANSFER_TIME_T
(int)
|
Tiempo transcurrido desde el inicio hasta el envío del último octeto, en microsegundos. Disponible a partir de PHP 8.4.0 y cURL 8.10.0. |
| Constantes | Descripción |
|---|---|
CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE
(int)
|
Especifica el umbral de longitud de fragmento para el pipelining en bytes. Disponible a partir de PHP 7.0.7 y cURL 7.30.0 |
CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE
(int)
|
Especifica el umbral de tamaño de penalización de pipelining en bytes. Disponible a partir de PHP 7.0.7 y cURL 7.30.0 |
CURLMOPT_MAXCONNECTS
(int)
|
Especifica la cantidad máxima de conexiones abiertas simultáneamente que libcurl puede almacenar en caché. Por omisión, el tamaño se ampliará para contener cuatro veces el número de gestores añadidos a través de curl_multi_add_handle(). Cuando la caché está llena, cURL cierra la más antigua en la caché para evitar que el número de conexiones abiertas aumente. Disponible a partir de cURL 7.16.3. |
CURLMOPT_MAX_CONCURRENT_STREAMS
(int)
|
Especifica el número máximo de streams simultáneos para las conexiones
que cURL debería soportar en conexiones que utilizan HTTP/2.
Los valores válidos van de 1
a 2147483647 (2^31 - 1).
El valor pasado aquí será respetado
en función de otras propiedades de los recursos del sistema.
Por omisión, es 100.
Disponible a partir de PHP 8.2.0 y cURL 7.67.0.
|
CURLMOPT_MAX_HOST_CONNECTIONS
(int)
|
Especifica el número máximo de conexiones a un solo host. Disponible a partir de PHP 7.0.7 y cURL 7.30.0 |
CURLMOPT_MAX_PIPELINE_LENGTH
(int)
|
Especifica el número máximo de solicitudes en un pipeline. Disponible a partir de PHP 7.0.7 y cURL 7.30.0 |
CURLMOPT_MAX_TOTAL_CONNECTIONS
(int)
|
Especifica el número máximo de conexiones abiertas simultáneamente. Disponible a partir de PHP 7.0.7 y cURL 7.30.0 |
CURLMOPT_PIPELINING
(int)
|
Pasar 1 para activar o 0 para desactivar. Activar el pipelining en un gestor múltiple hará que intente realizar el pipelining HTTP tanto como sea posible para las transferencias que utilizan este gestor. Esto significa que añadir una segunda solicitud que puede utilizar una conexión ya existente "pipe" la segunda solicitud en la misma conexión. A partir de cURL 7.43.0, el valor es una máscara de bits, y pasar 2 intentará multiplexar el nuevo transferencia en una conexión HTTP/2 existente. Pasar 3 indica a cURL solicitar el pipelining y el multiplexado independientemente uno del otro. A partir de cURL 7.62.0, establecer el bit de pipelining no tiene ningún efecto. En lugar de literales enteros, las constantes CURLPIPE_* también pueden ser utilizadas. Disponible a partir de cURL 7.16.0. |
CURLMOPT_PUSHFUNCTION
(int)
|
Pasar una fermeture que será registrada para gestionar las poussées del servidor y debe tener la siguiente firma:
CURL_PUSH_OK si puede gestionar la poussée, o
CURL_PUSH_DENY para rechazarla.
Disponible a partir de PHP 7.1.0 y cURL 7.44.0
|
| Constantes | Descripción |
|---|---|
CURLPROTO_ALL
(int)
|
Disponible a partir de cURL 7.19.4. |
CURLPROTO_DICT
(int)
|
Disponible a partir de cURL 7.19.4. |
CURLPROTO_FILE
(int)
|
Disponible a partir de cURL 7.19.4. |
CURLPROTO_FTP
(int)
|
Disponible a partir de cURL 7.19.4. |
CURLPROTO_FTPS
(int)
|
Disponible a partir de cURL 7.19.4. |
CURLPROTO_GOPHER
(int)
|
Disponible a partir de cURL 7.21.2. |
CURLPROTO_HTTP
(int)
|
Disponible a partir de cURL 7.19.4. |
CURLPROTO_HTTPS
(int)
|
Disponible a partir de cURL 7.19.4. |
CURLPROTO_IMAP
(int)
|
Disponible a partir de cURL 7.20.0. |
CURLPROTO_IMAPS
(int)
|
Disponible a partir de cURL 7.20.0. |
CURLPROTO_LDAP
(int)
|
Disponible a partir de cURL 7.19.4. |
CURLPROTO_LDAPS
(int)
|
Disponible a partir de cURL 7.19.4. |
CURLPROTO_MQTT
(int)
|
Disponible a partir de PHP 8.2.0 y cURL 7.71.0. |
CURLPROTO_POP3
(int)
|
Disponible a partir de cURL 7.20.0. |
CURLPROTO_POP3S
(int)
|
Disponible a partir de cURL 7.20.0. |
CURLPROTO_RTMP
(int)
|
Disponible a partir de cURL 7.21.0. |
CURLPROTO_RTMPE
(int)
|
Disponible a partir de cURL 7.21.0. |
CURLPROTO_RTMPS
(int)
|
Disponible a partir de cURL 7.21.0. |
CURLPROTO_RTMPT
(int)
|
Disponible a partir de cURL 7.21.0. |
CURLPROTO_RTMPTE
(int)
|
Disponible a partir de cURL 7.21.0. |
CURLPROTO_RTMPTS
(int)
|
Disponible a partir de cURL 7.21.0. |
CURLPROTO_RTSP
(int)
|
Disponible a partir de cURL 7.20.0. |
CURLPROTO_SCP
(int)
|
Disponible a partir de cURL 7.19.4. |
CURLPROTO_SFTP
(int)
|
Disponible a partir de cURL 7.19.4. |
CURLPROTO_SMB
(int)
|
Disponible a partir de PHP 7.0.7 y cURL 7.40.0. |
CURLPROTO_SMBS
(int)
|
Disponible a partir de PHP 7.0.7 y cURL 7.40.0. |
CURLPROTO_SMTP
(int)
|
Disponible a partir de cURL 7.20.0. |
CURLPROTO_SMTPS
(int)
|
Disponible a partir de cURL 7.20.0. |
CURLPROTO_TELNET
(int)
|
Disponible a partir de cURL 7.19.4. |
CURLPROTO_TFTP
(int)
|
Disponible a partir de cURL 7.19.4. |
| Constantes | Descripción |
|---|---|
CURLE_ABORTED_BY_CALLBACK
(int)
|
Abandonado por la función de retrollamada. Una función de retrollamada ha devuelto "abort" a libcurl. |
CURLE_BAD_CALLING_ORDER
(int)
|
|
CURLE_BAD_CONTENT_ENCODING
(int)
|
Codificación de contenido no reconocida. |
CURLE_BAD_DOWNLOAD_RESUME
(int)
|
La descarga no pudo ser reanudada porque el desplazamiento especificado estaba fuera de los límites del fichero. |
CURLE_BAD_FUNCTION_ARGUMENT
(int)
|
Una función fue llamada con un argumento incorrecto. |
CURLE_BAD_PASSWORD_ENTERED
(int)
|
|
CURLE_COULDNT_CONNECT
(int)
|
Fallo en la conexión al host o al proxy. |
CURLE_COULDNT_RESOLVE_HOST
(int)
|
Resolución del host imposible. El host remoto no pudo ser resuelto. |
CURLE_COULDNT_RESOLVE_PROXY
(int)
|
Resolución del proxy imposible. El proxy dado no pudo ser resuelto. |
CURLE_FAILED_INIT
(int)
|
El código de inicialización ha fallado. Probablemente se trate de un error interno o de un problema de recursos donde algo fundamental no pudo ser hecho al momento de la inicialización. |
CURLE_FILESIZE_EXCEEDED
(int)
|
Se ha superado el tamaño máximo del fichero. |
CURLE_FILE_COULDNT_READ_FILE
(int)
|
Un fichero dado con FILE:// no pudo ser abierto. Lo más probable es que la ruta del fichero no corresponda a un fichero existente o debido a la falta de permisos de fichero adecuados. |
CURLE_FTP_ACCESS_DENIED
(int)
|
|
CURLE_FTP_BAD_DOWNLOAD_RESUME
(int)
|
|
CURLE_FTP_CANT_GET_HOST
(int)
|
Se ha producido un error interno al buscar el host utilizado para la nueva conexión. |
CURLE_FTP_CANT_RECONNECT
(int)
|
|
CURLE_FTP_COULDNT_GET_SIZE
(int)
|
|
CURLE_FTP_COULDNT_RETR_FILE
(int)
|
Esto fue una respuesta inesperada a una orden 'RETR' o una transferencia de cero octetos completa. |
CURLE_FTP_COULDNT_SET_ASCII
(int)
|
|
CURLE_FTP_COULDNT_SET_BINARY
(int)
|
|
CURLE_FTP_COULDNT_STOR_FILE
(int)
|
|
CURLE_FTP_COULDNT_USE_REST
(int)
|
La orden FTP REST ha devuelto un error. Esto no debería ocurrir nunca si el servidor está sano. |
CURLE_FTP_PARTIAL_FILE
(int)
|
|
CURLE_FTP_PORT_FAILED
(int)
|
La orden FTP PORT ha devuelto un error.
Esto ocurre principalmente cuando la dirección especificada para libcurl no es suficientemente buena.
Ver CURLOPT_FTPPORT.
|
CURLE_FTP_QUOTE_ERROR
(int)
|
|
CURLE_FTP_SSL_FAILED
(int)
|
|
CURLE_FTP_USER_PASSWORD_INCORRECT
(int)
|
|
CURLE_FTP_WEIRD_227_FORMAT
(int)
|
Los servidores FTP devuelven una línea 227 en respuesta a una orden PASV. Si libcurl falla al analizar esta línea, este código de retorno es devuelto. |
CURLE_FTP_WEIRD_PASS_REPLY
(int)
|
Después de enviar la contraseña FTP al servidor, libcurl espera una respuesta apropiada. Este código de error indica que se ha devuelto un código inesperado. |
CURLE_FTP_WEIRD_PASV_REPLY
(int)
|
Libcurl no ha podido obtener un resultado sensato del servidor en respuesta a una orden PASV o EPSV. El servidor es defectuoso. |
CURLE_FTP_WEIRD_SERVER_REPLY
(int)
|
El servidor ha devuelto datos que libcurl no ha podido analizar.
Este código de error es conocido como CURLE_WEIRD_SERVER_REPLY
a partir de cURL 7.51.0.
|
CURLE_FTP_WEIRD_USER_REPLY
(int)
|
|
CURLE_FTP_WRITE_ERROR
(int)
|
|
CURLE_FUNCTION_NOT_FOUND
(int)
|
La función no ha sido encontrada. Una función zlib requerida no ha sido encontrada. |
CURLE_GOT_NOTHING
(int)
|
Nada ha sido devuelto por el servidor, y en las circunstancias, no recibir nada es considerado como un error. |
CURLE_HTTP_NOT_FOUND
(int)
|
|
CURLE_HTTP_PORT_FAILED
(int)
|
|
CURLE_HTTP_POST_ERROR
(int)
|
Es un error extraño que ocurre principalmente debido a una confusión interna. |
CURLE_HTTP_RANGE_ERROR
(int)
|
|
CURLE_HTTP_RETURNED_ERROR
(int)
|
Esto se devuelve si CURLOPT_FAILONERROR está definido a true
y que el servidor HTTP devuelve un código de error superior o igual a 400.
|
CURLE_LDAP_CANNOT_BIND
(int)
|
LDAP no puede enlazarse. La operación de enlace LDAP ha fallado. |
CURLE_LDAP_INVALID_URL
(int)
|
|
CURLE_LDAP_SEARCH_FAILED
(int)
|
La búsqueda LDAP ha fallado. |
CURLE_LIBRARY_NOT_FOUND
(int)
|
|
CURLE_MALFORMAT_USER
(int)
|
|
CURLE_OBSOLETE
(int)
|
|
CURLE_OK
(int)
|
Todo está bien. Proceda como de costumbre. |
CURLE_OPERATION_TIMEDOUT
(int)
|
Operación expirada. El período de tiempo especificado ha sido alcanzado según las condiciones. |
CURLE_OPERATION_TIMEOUTED
(int)
|
|
CURLE_OUT_OF_MEMORY
(int)
|
Una solicitud de asignación de memoria ha fallado. |
CURLE_PARTIAL_FILE
(int)
|
Una transferencia de fichero ha sido más corta o más larga de lo esperado. Esto ocurre cuando el servidor señala primero un tamaño de transferencia esperado, y luego proporciona datos que no coinciden con el tamaño dado anteriormente. |
CURLE_PROXY
(int)
|
Error de conexión al proxy.
CURLINFO_PROXY_ERROR proporciona detalles adicionales sobre el problema específico.
Disponible a partir de PHP 8.2.0 y cURL 7.73.0
|
CURLE_READ_ERROR
(int)
|
Hubo un problema al leer un fichero local o un error devuelto por la función de retrollamada de lectura. |
CURLE_RECV_ERROR
(int)
|
Fallo en la recepción de los datos de red. |
CURLE_SEND_ERROR
(int)
|
Fallo en el envío de los datos de red. |
CURLE_SHARE_IN_USE
(int)
|
|
CURLE_SSH
(int)
|
Se ha producido un error no especificado durante la sesión SSH. Disponible a partir de cURL 7.16.1. |
CURLE_SSL_CACERT
(int)
|
|
CURLE_SSL_CACERT_BADFILE
(int)
|
Problema de lectura del certificado SSL CA. |
CURLE_SSL_CERTPROBLEM
(int)
|
Problema con el cliente de certificado local. |
CURLE_SSL_CIPHER
(int)
|
Imposible utilizar el cifrado especificado. |
CURLE_SSL_CONNECT_ERROR
(int)
|
Se ha producido un problema en algún lugar de la gestión SSL/TLS. La lectura del mensaje en el búfer de error proporciona más detalles sobre el problema. Podría ser de certificados (formatos de ficheros, rutas, permisos), contraseñas y otros. |
CURLE_SSL_ENGINE_NOTFOUND
(int)
|
El motor de cifrado especificado no ha sido encontrado. |
CURLE_SSL_ENGINE_SETFAILED
(int)
|
Fallo en la definición del motor de cifrado seleccionado como motor por defecto. |
CURLE_SSL_PEER_CERTIFICATE
(int)
|
|
CURLE_SSL_PINNEDPUBKEYNOTMATCH
(int)
|
Fallo en la coincidencia de la clave pública especificada con
CURLOPT_PINNEDPUBLICKEY.
|
CURLE_TELNET_OPTION_SYNTAX
(int)
|
|
CURLE_TOO_MANY_REDIRECTS
(int)
|
Demasiadas redirecciones. Al seguir las redirecciones, libcurl ha alcanzado el número máximo.
El límite puede ser definido con CURLOPT_MAXREDIRS.
|
CURLE_UNKNOWN_TELNET_OPTION
(int)
|
|
CURLE_UNSUPPORTED_PROTOCOL
(int)
|
La URL pasada a libcurl utilizó un protocolo que libcurl no soporta. El problema podría ser una opción de compilación que no ha sido utilizada, una cadena de protocolo mal escrita o simplemente un protocolo para el cual libcurl no tiene código. |
CURLE_URL_MALFORMAT
(int)
|
La URL no estaba correctamente formateada. |
CURLE_URL_MALFORMAT_USER
(int)
|
|
CURLE_WEIRD_SERVER_REPLY
(int)
|
El servidor ha devuelto datos que libcurl no ha podido analizar.
Este código de error era conocido como CURLE_FTP_WEIRD_SERVER_REPLY
antes de cURL 7.51.0.
Disponible a partir de PHP 7.3.0 y cURL 7.51.0
|
CURLE_WRITE_ERROR
(int)
|
Se ha producido un error al escribir los datos recibidos en un fichero local, o un error ha sido devuelto a libcurl desde una función de retrollamada de escritura. |
| Constantes | Descripción |
|---|---|
CURLM_ADDED_ALREADY
(int)
|
Un gestor fácil ya añadido a un gestor múltiple ha sido intentado ser añadido una segunda vez. Disponible a partir de cURL 7.32.1. |
CURLM_BAD_EASY_HANDLE
(int)
|
Un gestor fácil no era bueno/válido. Esto podría significar que no se trata de un gestor fácil en absoluto, o eventualmente que el gestor ya está siendo utilizado por este o por otro gestor múltiple. Disponible a partir de cURL 7.9.6. |
CURLM_BAD_HANDLE
(int)
|
El gestor pasado no es un gestor múltiple válido. Disponible a partir de cURL 7.9.6. |
CURLM_CALL_MULTI_PERFORM
(int)
|
Desde cURL 7.20.0, esta constante no se utiliza. Antes de cURL 7.20.0, este estado podía ser devuelto por curl_multi_exec() cuando curl_multi_select() o una función similar era llamada antes de que devolviera otra constante. Disponible a partir de cURL 7.9.6. |
CURLM_INTERNAL_ERROR
(int)
|
Error interno de libcurl.
|
CURLM_OK
(int)
|
Ningún error. Disponible a partir de cURL 7.9.6. |
CURLM_OUT_OF_MEMORY
(int)
|
No hay suficiente memoria al procesar los gestores múltiples. Disponible a partir de cURL 7.9.6. |
| Constantes | Descripción |
|---|---|
CURLPAUSE_ALL
(int)
|
Pone en pausa el envío y la recepción de datos. Disponible a partir de cURL 7.18.0. |
CURLPAUSE_CONT
(int)
|
Reanuda el envío y la recepción de datos. Disponible a partir de cURL 7.18.0. |
CURLPAUSE_RECV
(int)
|
Pone en pausa la recepción de datos. Disponible a partir de cURL 7.18.0. |
CURLPAUSE_RECV_CONT
(int)
|
Reanuda la recepción de datos. Disponible a partir de cURL 7.18.0. |
CURLPAUSE_SEND
(int)
|
Pone en pausa el envío de datos. Disponible a partir de cURL 7.18.0. |
CURLPAUSE_SEND_CONT
(int)
|
Reanuda el envío de datos. Disponible a partir de cURL 7.18.0. |