16-11-2026 4 min. de lectura (aproximado)
Tutorial de PHP y ssl/openssl
Índice de contenidos
¿Qué es SSL/TLS y qué tiene que ver con PHP?
SSL , o Secure Sockets Layer , y su sucesor TLS , o Transport Layer Security , son los protocolos que cifran las comunicaciones HTTPS . PHP incluye la extensión OpenSSL , que permite:
Hacer conexiones HTTPS .
Trabajar con certificados.
Cifrar y descifrar datos.
Firmar y verificar firmas digitales .
Generar claves y certificados.
Comprobar que OpenSSL está disponible
if (extension_loaded('openssl')) {
echo "OpenSSL está habilitado\n";
echo "Versión: " . OPENSSL_VERSION_TEXT . "\n";
} else {
die("La extensión OpenSSL no está habilitada");
}
Crear un certificado autofirmado con PHP
Es muy útil para entornos de desarrollo y proyectos autoalojados.
$dn = [
"countryName" => "ES",
"stateOrProvinceName" => "Madrid",
"localityName" => "Madrid",
"organizationName" => "Mi Empresa",
"organizationalUnitName" => "Desarrollo",
"commonName" => "localhost",
"emailAddress" => "admin@localhost"
];
$config = [
"digest_alg" => "sha256",
"private_key_bits" => 4096,
"private_key_type" => OPENSSL_KEYTYPE_RSA,
];
// Generar clave privada
$privateKey = openssl_pkey_new($config);
// Generar CSR
$csr = openssl_csr_new($dn, $privateKey, $config);
// Firmar el certificado (autofirmado) - válido 825 días
$cert = openssl_csr_sign($csr, null, $privateKey, 825, $config);
// Exportar
openssl_pkey_export($privateKey, $privateKeyPem);
openssl_x509_export($cert, $certPem);
file_put_contents('private.key', $privateKeyPem);
file_put_contents('certificate.crt', $certPem);
echo "Certificado autofirmado creado correctamente\n";
Hacer peticiones HTTPS con PHP
Usando cURL (recomendado)
$ch = curl_init('https://api.ejemplo.com/datos');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_SSL_VERIFYPEER => true, // Verificar certificado del servidor
CURLOPT_SSL_VERIFYHOST => 2, // Verificar que el dominio coincida
CURLOPT_TIMEOUT => 30,
]);
$response = curl_exec($ch);
if (curl_errno($ch)) {
echo "Error: " . curl_error($ch);
} else {
echo $response;
}
curl_close($ch);
Usando file_get_contents
$context = stream_context_create([
'ssl' => [
'verify_peer' => true,
'verify_peer_name' => true,
]
]);
$result = file_get_contents('https://api.ejemplo.com', false, $context);
Cifrar y descifrar datos
$data = "Información secreta";
$password = "mi_clave_super_segura";
$method = "AES-256-CBC";
// Generar IV
$iv = openssl_random_pseudo_bytes(openssl_cipher_iv_length($method));
// Cifrar
$encrypted = openssl_encrypt($data, $method, $password, 0, $iv);
$encrypted = base64_encode($iv . $encrypted); // Guardamos IV + datos
echo "Cifrado: " . $encrypted . "\n";
// Descifrar
$data = base64_decode($encrypted);
$ivLength = openssl_cipher_iv_length($method);
$iv = substr($data, 0, $ivLength);
$encrypted = substr($data, $ivLength);
$decrypted = openssl_decrypt($encrypted, $method, $password, 0, $iv);
echo "Descifrado: " . $decrypted . "\n";
Firmar y verificar datos (firmas digitales)
// Generar par de claves
$config = ["private_key_bits" => 2048, "private_key_type" => OPENSSL_KEYTYPE_RSA];
$privateKey = openssl_pkey_new($config);
$publicKeyDetails = openssl_pkey_get_details($privateKey);
$publicKey = $publicKeyDetails['key'];
$data = "Este mensaje debe ser auténtico";
// Firmar
openssl_sign($data, $signature, $privateKey, OPENSSL_ALGO_SHA256);
$signature = base64_encode($signature);
echo "Firma: " . $signature . "\n";
// Verificar
$verified = openssl_verify($data, base64_decode($signature), $publicKey, OPENSSL_ALGO_SHA256);
echo $verified === 1 ? "Firma válida\n" : "Firma NO válida\n";
Leer e inspeccionar un certificado
$certContent = file_get_contents('certificate.crt');
$cert = openssl_x509_parse($certContent);
echo "Dominio (CN): " . $cert['subject']['CN'] . "\n";
echo "Organización: " . $cert['subject']['O'] . "\n";
echo "Válido desde: " . date('Y-m-d', $cert['validFrom_time_t']) . "\n";
echo "Válido hasta: " . date('Y-m-d', $cert['validTo_time_t']) . "\n";
Buenas prácticas
Usar TLS 1.2 o superior - Seguridad
Nunca desactivar "CURLOPT_SSL_VERIFYPEER ! en producción - Evita ataques MITM
Guardar claves privadas fuera del directorio público - Seguridad
Usar "openssl_random_pseudo_bytes() " para IVs y tokens - Aleatoriedad segura
Preferir "AES-256-GCM " cuando sea posible - Más seguro que CBC
En producción usar certificados de Let's Encrypt - Confianza pública
Certificados autofirmados solo para entornos internos o desarrollo - Limitaciones de confianza
Resumen de lo que puedes hacer con PHP y SSL
Crear y gestionar certificados, incluyendo autofirmados.
Realizar conexiones HTTPS seguras.
Cifrar y descifrar información sensible.
Firmar digitalmente datos y verificar firmas.
Implementar autenticación mutua, o mTLS .
Trabajar con claves públicas y privadas.
Mejorar la seguridad de aplicaciones Laravel o PHP nativas.