&reftitle.install;
Pour utiliser le support OpenSSL de PHP, vous devez aussi compiler PHP avec l'option
de configuration .
La bibliothèque OpenSSL possède aussi des dépendances à l'exécution. Par exemple,
OpenSSL a besoin d'accéder à un générateur de nombres pseudo-aléatoires; sur la
plupart des plateformes Unix (incluant donc Linux), elle doit avoir accès au
périphérique /dev/urandom ou /dev/random.
L'option de configuration
est disponible
qui fait que PHP utilise la liste de chiffrement système au lieu des valeurs
par défaut codé en dur.
Note aux utilisateurs Win32
&ext.windows.path.dll;
libeay32.dll,
ou, à partir de OpenSSL 1.1, libcrypto-*.dll
De plus, si vous avez prévu d'utiliser les fonctions relatives à la génération
de clés et aux certificats, vous devez installer un fichier
openssl.cnf valide sur votre système.
Un fichier de configuration de base est inclus dans les distributions de PHP
pour win32 dans le dossier extras/openssl.
PHP va rechercher le fichier openssl.cnf suivant la
tactique suivante :
La variable d'environnement OPENSSL_CONF, si elle est
définie, sera utilisée comme chemin (comprenant le fichier) vers le
fichier de configuration.
La variable d'environnement SSLEAY_CONF, si elle est
définie, sera utilisée comme chemin (comprenant le fichier) vers le
fichier de configuration.
Le fichier openssl.cnf sera supposé se trouver dans
le dossier des certificats, tel que configuré lors de la compilation
de la bibliothèque openssl. Cela signifie généralement C:\Program Files\Common Files\SSL\openssl.cnf (x64)
or C:\Program Files (x86)\Common Files\SSL\openssl.cnf (x86), ou,
avant PHP 7.4.0,
c:\usr\local\ssl\openssl.cnf.
Dans votre installation, vous devrez décider si vous allez installer le fichier
de configuration dans le chemin par défaut ou si vous allez
le faire ailleurs et configurer une variable d'environnement (possiblement
par site virtuel). Notez qu'il est possible de remplacer le chemin par
défaut en utilisant le paramètre options des fonctions
qui requièrent un fichier de configuration.
Veiller à ce que les utilisateurs non privilégiés ne soient pas autorisés à
modifier openssl.cnf.
&reftitle.changelog;
&Version;&Description;7.4.0
Le chemin de configuration par défaut d'OpenSSL a été modifié de C:\usr\local\ssl
à C:\Program Files\Common Files\SSL et
C:\Program Files (x86)\Common Files\SSL, respectivement.