<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.openssl.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'fr',
  ),
  'this' => 
  array (
    0 => 'function.openssl-pkey-get-details.php',
    1 => 'openssl_pkey_get_details',
    2 => 'Retourne un tableau contenant les d&eacute;tails de la cl&eacute;',
  ),
  'up' => 
  array (
    0 => 'ref.openssl.php',
    1 => 'Fonctions OpenSSL',
  ),
  'prev' => 
  array (
    0 => 'function.openssl-pkey-free.php',
    1 => 'openssl_pkey_free',
  ),
  'next' => 
  array (
    0 => 'function.openssl-pkey-get-private.php',
    1 => 'openssl_pkey_get_private',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'fr',
    'path' => 'reference/openssl/functions/openssl-pkey-get-details.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.openssl-pkey-get-details" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">openssl_pkey_get_details</h1>
  <p class="verinfo">(PHP 5 &gt;= 5.2.0, PHP 7, PHP 8)</p><p class="refpurpose"><span class="refname">openssl_pkey_get_details</span> &mdash; <span class="dc-title">Retourne un tableau contenant les détails de la clé</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.openssl-pkey-get-details-description">
  <h3 class="title">Description</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>openssl_pkey_get_details</strong></span>(<span class="methodparam"><span class="type"><a href="class.opensslasymmetrickey.php" class="type OpenSSLAsymmetricKey">OpenSSLAsymmetricKey</a></span> <code class="parameter">$key</code></span>): <span class="type"><span class="type"><a href="language.types.array.php" class="type array">array</a></span>|<span class="type"><a href="language.types.singleton.php" class="type false">false</a></span></span></div>

  <p class="para rdfs-comment">
   Cette fonction retourne les détails de la clé (bits, key, type).
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.openssl-pkey-get-details-parameters">
  <h3 class="title">Liste de paramètres</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">key</code></dt>
     <dd>
      <p class="para">
       Ressource contenant la clé.
      </p>
     </dd>
    
   </dl>
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.openssl-pkey-get-details-returnvalues">
  <h3 class="title">Valeurs de retour</h3>
  <p class="para">
   Retourne un tableau avec les détails de la clé en cas de succès,
   ou <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> en cas d&#039;échec.
   Le tableau retourné contient les index <code class="literal">bits</code> (nombre de bits),
   <code class="literal">key</code> (représentation sous forme de <a href="language.types.string.php" class="link">chaîne de caractères</a> de la clé publique)
   et <code class="literal">type</code> (type de clé qui est l&#039;un de
   <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-rsa">OPENSSL_KEYTYPE_RSA</a></code></strong>,
   <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-dsa">OPENSSL_KEYTYPE_DSA</a></code></strong>,
   <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-dh">OPENSSL_KEYTYPE_DH</a></code></strong>,
   <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-ec">OPENSSL_KEYTYPE_EC</a></code></strong>,
   <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-x25519">OPENSSL_KEYTYPE_X25519</a></code></strong>,
   <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-ed25519">OPENSSL_KEYTYPE_ED25519</a></code></strong>,
   <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-x448">OPENSSL_KEYTYPE_X448</a></code></strong>,
   <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-ed448">OPENSSL_KEYTYPE_ED448</a></code></strong>,
   ou <code class="literal">-1</code> signifiant inconnu).
  </p>
  <p class="para">
   En fonction du type de clés utilisées, des détails supplémentaires peuvent être retournés.
   Il est à noter que quelques éléments peuvent ne pas être toujours disponibles.
  </p>
  <ul class="itemizedlist">
   <li class="listitem">
    <span class="simpara">
     <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-rsa">OPENSSL_KEYTYPE_RSA</a></code></strong>, une clé de tableau additionnelle appelée <code class="literal">&quot;rsa&quot;</code>, 
     contenant la donnée de clé est retournée
    </span>
     <table class="doctable informaltable">
      
       <thead>
        <tr>
         <th>Key</th>
         <th>Description</th>
        </tr>

       </thead>

       <tbody class="tbody">
        <tr>
         <td><code class="literal">&quot;n&quot;</code></td>
         <td>modulo</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;e&quot;</code></td>
         <td>exposant public</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;d&quot;</code></td>
         <td>exposant privé</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;p&quot;</code></td>
         <td>nombre premier 1</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;q&quot;</code></td>
         <td>nombre premier 2</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;dmp1&quot;</code></td>
         <td>exponent1, d mod (p-1)</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;dmq1&quot;</code></td>
         <td>exponent2, d mod (q-1)</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;iqmp&quot;</code></td>
         <td>coefficient, (inverse de q) mod p</td>
        </tr>

       </tbody>
      
     </table>

   </li>
   <li class="listitem">
    <span class="simpara">
     <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-dsa">OPENSSL_KEYTYPE_DSA</a></code></strong>, une clé de tableau additionnelle appelée <code class="literal">&quot;dsa&quot;</code>, 
     contenant la donnée de clé est retournée
    </span>
     <table class="doctable informaltable">
      
       <thead>
        <tr>
         <th>Key</th>
         <th>Description</th>
        </tr>

       </thead>

       <tbody class="tbody">
        <tr>
         <td><code class="literal">&quot;p&quot;</code></td>
         <td>nombre premier (public)</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;q&quot;</code></td>
         <td>160-bit nombre sous-prime, q | p-1 (public)</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;g&quot;</code></td>
         <td>générateur du sous-groupe (publique)</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;priv_key&quot;</code></td>
         <td>clé privée x</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;pub_key&quot;</code></td>
         <td>clé publique y = g^x</td>
        </tr>

       </tbody>
      
     </table>

   </li>
   <li class="listitem">
    <span class="simpara">
     <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-dh">OPENSSL_KEYTYPE_DH</a></code></strong>, une clé de tableau additionnelle appelée <code class="literal">&quot;dh&quot;</code>, 
     contenant la donnée de clé est retournée.
    </span>
     <table class="doctable informaltable">
      
       <thead>
        <tr>
         <th>Key</th>
         <th>Description</th>
        </tr>

       </thead>

       <tbody class="tbody">
        <tr>
         <td><code class="literal">&quot;p&quot;</code></td>
         <td>nombre premier (partagé)</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;g&quot;</code></td>
         <td>générateur de Z_p (partagé)</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;priv_key&quot;</code></td>
         <td>valeur privée DH x</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;pub_key&quot;</code></td>
         <td>valeur publique DH g^x</td>
        </tr>

       </tbody>
      
     </table>

   </li>
   <li class="listitem">
    <span class="simpara">
     <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-x25519">OPENSSL_KEYTYPE_X25519</a></code></strong>,
     <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-ed25519">OPENSSL_KEYTYPE_ED25519</a></code></strong>,
     <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-x448">OPENSSL_KEYTYPE_X448</a></code></strong>,
     ou <strong><code><a href="openssl.key-types.php#constant.openssl-keytype-ed448">OPENSSL_KEYTYPE_ED448</a></code></strong>
     une clé supplémentaire dans le tableau nommée
     <code class="literal">&quot;x25519&quot;</code>,
     <code class="literal">&quot;ed25519&quot;</code>,
     <code class="literal">&quot;x448&quot;</code>,
     ou <code class="literal">&quot;ed448&quot;</code> respectivement,
     est retournée, contenant les données de la clé.
    </span>
     <table class="doctable informaltable">
      
       <thead>
        <tr>
         <th>Key</th>
         <th>Description</th>
        </tr>

       </thead>

       <tbody class="tbody">
        <tr>
         <td><code class="literal">&quot;priv_key&quot;</code></td>
         <td>clé privée</td>
        </tr>

        <tr>
         <td><code class="literal">&quot;pub_key&quot;</code></td>
         <td>clé publique</td>
        </tr>

       </tbody>
      
     </table>

   </li>
  </ul>
 </div>


 <div class="refsect1 changelog" id="refsect1-function.openssl-pkey-get-details-changelog">
  <h3 class="title">Historique</h3>
  <table class="doctable informaltable">
   
    <thead>
     <tr>
      <th>Version</th>
      <th>Description</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>8.4.0</td>
      <td>
       Ajout de la prise en charge des clés basées sur Curve25519 et Curve448.
       Plus précisément, les champs <code class="literal">x25519</code>, <code class="literal">ed25519</code>,
       <code class="literal">x448</code> et <code class="literal">ed448</code> ont été introduits.
      </td>
     </tr>

     <tr>
      <td>8.0.0</td>
      <td>
       <code class="parameter">key</code> accepte désormais une instance de
       <span class="classname"><a href="class.opensslasymmetrickey.php" class="classname">OpenSSLAsymmetricKey</a></span> ;
       auparavant, une <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> de type <code class="literal">OpenSSL key</code> était acceptée.
      </td>
     </tr>

    </tbody>
   
  </table>

 </div>

</div><?php manual_footer($setup); ?>