Documentación offline PHP master

openssl_pkey_derive

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

openssl_pkey_derive

Calcula el secreto compartido para el valor público de la clave DH o ECDH remota y local

Descripción#

#[\SensitiveParameter] openssl_pkey_derive(OpenSSLAsymmetricKey $public_key, OpenSSLAsymmetricKey $private_key, [int $key_length]): string
```php

`openssl_pkey_derive` toma un conjunto de `public_key` y `private_key` y deriva un secreto compartido, para claves DH o EC.

## Parámetros

`public_key`  
`public_key` es la clave pública para la derivación. Consulte [Parámetros de clave/certificado](#openssl.certparams) para una lista de valores válidos.

`private_key`  
`private_key` es la clave privada para la derivación. Consulte [Parámetros de clave pública/privada](#openssl.certparams) para una lista de valores válidos.

`key_length`  
Si no es nulo, intentará establecer la longitud deseada del secreto derivado.

> [!CAUTION]
> Este parámetro está obsoleto y no debe utilizarse, ya que no funciona como se espera. Nunca devuelve un secreto más largo que el tamaño del primero Si la longitud deseada es menor que el tamaño del primero, trunca la longitud solo para las claves ECDH, pero falla para las claves DH.

## Valores devueltos

El secreto derivado en caso de éxito o `false` si ocurre un error.

## Historial de cambios

| Versión | Descripción                                    |
|---------|------------------------------------------------|
| 8.5.0   | El parámetro `key_length` ahora está obsoleto. |

## Ejemplos

Ejemplo de `openssl_pkey_derive`