curl_share_init_persistent

curl_share_init_persistent(array $share_options): CurlSharePersistentHandle
```php

Inicializa un gestor cURL "share" **persistente** con las opciones de compartición dadas. A diferencia de `curl_share_init`, los gestores creados por esta función no serán destruidos al final de la petición PHP. Si se encuentra un gestor de compartición persistente con el mismo conjunto de `share_options`, será reutilizado.

## Parámetros

`share_options`  
Un array no vacío de constantes `CURL_LOCK_DATA_*`.

> [!NOTE]
> `CURL_LOCK_DATA_COOKIE` no está permitido y, si se especifica, esta función lanzará una ValueError. La compartición de cookies entre las peticiones PHP puede llevar a una mezcla involuntaria de cookies sensibles entre los usuarios.

## Valores devueltos

Devuelve un `CurlSharePersistentHandle`.

## Errores/Excepciones

- Si `share_options` está vacío, esta función lanza una ValueError.

- Si `share_options` contiene un valor que no corresponde a una `CURL_LOCK_DATA_*`, esta función lanza una `ValueError`.

- Si `share_options` contiene `CURL_LOCK_DATA_COOKIE`, esta función lanza una ValueError.

- Si `share_options` contiene un valor no entero, esta función lanza una TypeError.

## Ejemplos

Ejemplo de `curl_share_init_persistent`

Este ejemplo creará un gestor cURL "share" persistente y demostrará la compartición de conexiones entre ellos. Si se ejecuta en un SAPI PHP de larga duración, `$sh` sobrevivirá entre las peticiones SAPI.