English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

PHP 基础教程

PHP 高级教程

PHP & MySQL

PHP 参考手册

PHP openssl_pkey_new() 函数用法及示例

دليل الوظائف OpenSSL PHP

openssl_pkey_new()()函数用于生成一个新的私钥。

定义和用法

openssl_pkey_new() 生成一个新的私钥和公钥对。通过 openssl_pkey_get_public() 函数获取该密钥的公共组件。

函数openssl_pkey_new()返回资源标识符。您可以使用 openssl_pkey_get_details() 函数获取生成的密钥的所有详细信息。密钥(公用/专用对)稍后与其他openssl函数(例如openssl_sign(),openssl_csr_new())一起使用-获得CSR证书,该证书有助于创建加密数字签名。

语法

openssl_pkey_new ([ array $configargs ] ) : resource

参数

序号参数描述
1

configargs

你可以使用configargs参数微调密钥的生成(比如指定位数)。查看openssl_csr_new()获取更多关于configargs的信息。

配置参数

默认情况下,openssl_pkey_new( )使用 openssl.cnf 中存在的配置详细信息。但是使用configargs可以覆盖它们。配置详细信息如下:

configargs类型openssl.conf中使用的密钥描述
digest_algالخطdefault_md您从openssl_get_md_methods()获得的摘要方法。
x509_extensionsالخطx509_extensions创建x509证书时使用的扩展名。
req_extensionsالخطreq_extensions创建CSR时使用的扩展名。
private_key_bitsعددdefault_bitsتحديد عدد الأرقام التي سيتم استخدامها أثناء إنشاء المفتاح الخاص.
private_key_typeعددلا شيءنوع المفتاح الخاص الذي سيتم إنشاؤه. يمكن أن يكون هذا OPENSSL_KEYTYPE_DSA، OPENSSL_KEYTYPE_DH، OPENSSL_KEYTYPE_RSA أو OPENSSL_KEYTYPE_EC من بينهم. القيمة الافتراضية هي OPENSSL_KEYTYPE_RSA.
encrypt_keyقيمة بوليةencrypt_keyهل تم تشفير المفتاح المصدور؟
encrypt_key_cipherعددلا شيءمستويات سرية، مثل OPENSSL_CIPHER_RC2_40 (عدد)، OPENSSL_CIPHER_RC2_128 (عدد)، OPENSSL_CIPHER_RC2_64 (عدد)، OPENSSL_CIPHER_DES (عدد)، OPENSSL_CIPHER_3DES (عدد) وما إلى ذلك.
curve_nameالخطلا شيءأحد أسماء السلاسل التي تعودها دالة openssl_get_curve_names().
تكوينالخطN/Aيمكنك تغيير التكوين في openssl.conf حسب الحاجة، وتقديم مسارها هنا.

القيمة المعدة

إذا لم يكن هناك خطأ، فإن دالة PHP openssl_pkey_new() ستعود رمز المصدر. إذا فشل إنشاء المفتاح، فإنها ستعود قيمة false.

إصدار PHP

هذا الدالة ستعمل من إصدار PHP أكبر من 5.0.0.

مثال1

عمل openssl_pkey_new():

<?php
   //生成新的私钥(和公钥)对
   $privkey = openssl_pkey_new(array(
      "digest_alg" => 'md5',
      "private_key_bits" => 2048,
      "private_key_type" => OPENSSL_KEYTYPE_RSA,
   ));
	var_dump($privkey);
?>

هذا سينتج النتيجة التالية:

المورد(2) من نوع (مفتاح OpenSSL)

مثال2

openssl_pkey_new() و openssl_pkey_get_details العمل:

<?php
   //生成新的私钥(和公钥)对
   $privkey = openssl_pkey_new(array(
      "digest_alg" => 'md5',
      "private_key_bits" => 2048,
      "private_key_type" => OPENSSL_KEYTYPE_RSA,
   ));
   $key_details = openssl_pkey_get_details($privkey);
   print_r($key_details);
?>

هذا سينتج النتيجة التالية:

Array
(
    [bits] => 2048
    [key] => -----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA1IGWxnWzICSkjrOVrYkw
9EKpIhcAYbhaymiwQY/ii9d7hnuGhpjjitDxzFftGafL6XOFKOhgbO2yrcpFxRKu
AY3t5wyUcqUJV6CNwV2Hipk90psUcTmK3+pcCzcqCKr7sLWlHI48lse92xane8Sf
CATNNbr9vmqUaTZ9FQqWihm3o/rNGuZTwMSKvcKsVguFpwrEDJaSLP1nt7RSHGc+
PixQSXp3PtQCH+S0CM9jt1jD9NkYXuuAlNbrsPm1fl2zAGR5Vh15evz5765lZ2mH
LIZScfsO/qgai3R6foaBlJM5tiSeiVZgnnQDKFBi5XK2GhzDnKggJe4tdY7awTFm
CQIDAQAB
-----FIN DE LA CLÉ PUBLIQUE-----
    => Array
        (
            => ԁ��u� $������0�B�"a�Z�h�A���{�{�������W����s�(�`l����E������r�	W���]���=қq9���\7*������<�ǽ��{ğ�5���j�i6}
�������S�Ċ�¬V��
،�g��Rg>>,PIzw>���c�X���^뀔����~]�dyVyz���egi�,�Rq����tz~����9�$��V`�t(Pb�r�Ü� %�-u���1f	
            => 
            => F"���3����4��!K�yF��R�lY�9�]Ξ��A��@�f��~�<�YPєG��=���TkTP�rl�Mԓ{�lŮ^��!����q�˂�7�|�f����lE+#�@�.�GIH�tS�R.mbc�U~����7&w�ݥ�P.Fe�ϨU�@��m��X�ECsemjI$@/�$l����)�8�@���c�w�NRo���+!'�.����fvT7�=n")LQ�sdš�%zZ���G��{�{�1A^��v��E
            => �>u)��1bǰK�r���pHE��k���LBE����y�'�3-�/��Pd���jeFV1����?�.O�����:�bl2�z�U�{��{��*��A���<�}m4��J�Y�'���f@�����
            => ߦz\��96�=��V]"k��2w���>�r�袤�6�/�-Z�_�����8!Y��I��L���_3Ym�����.p�֏^����>�I:��oZ��"���=��8���뻢1�����:�
            [dmp1] => z"�TW*��Ƴm�$�HQ�$0���sa��j� #�
P�*�P��Q�G\42�a�26(�5�K�7zj���xj7��@e�$.6��b�Dq]]I}�L�m�d��54)@:���#
            [dmq1] => +����4}��\dc�R�K�Bw�\�E6�ؓ�����%_�m$3蚞9��Fh�D�uz����$�8HPK�ˇԁ^���K�k�]e�g�>ºX�"<ƌ���`ė���&,9E��MS"��¥�)
            [iqmp] => !�����߷�=�z�=ܰ7����V�6q�~���3V��t�P�$��O�kgv��3=W\ѝm���	�J���5^�K��a�t��~������U�.��!�l�v�#��z*���	���r
        )
    [type] => 0
)

مثال 3

لقراءة المفتاح العام من openssl_pkey_new():

<?php
   echo "The hash of Welcome to w3codebox is - ". hash('crc32b', 'Welcome to w3codebox');
?>

هذا سينتج النتيجة التالية:

-----BEGIN PUBLIC KEY----- MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEArAWYwKIaf3uN1bwww4R851ifDPGsreqr9cV3J1gSKC8kaAEsAQaZ/6gQlDBsUGs4nE8zKgOlcdOV/JApgAdz+CwoLJUgmEUkLDxOcWaCIUVuHAiyBGJaRKZ+MASy7wRG8hb+INd0/zoQRGXk3+jfFj6rvSinVg49C4RAkRtkEdNnH0G5s6cedV6ec30DouRTuEQ/Fgizf0qaVtQbAURPn+/LT9V8c4LMaCyID7caTQOXAEjQqD4ooXGkOzmcsp03j2/F+T2mSIQRtI1gGJkZoCMGX/xRxh5uemCcC4jcshn45Ikmb/S7WFqTCOC0e8l8CiTZ5Rr8EKFgtwliMds8pQIDAQAB -----END PUBLIC KEY-----

مثال 4

لحفظ المفتاح العام في ملف باستخدام openssl_pkey_new():

<?php
   // إنتاج زوج جديد من المفتاح الخاص (والمفتاح العام)
   $privkey = openssl_pkey_new(array(
      "digest_alg" => 'md5',
      "private_key_bits" => 2048,
      "private_key_type" => OPENSSL_KEYTYPE_RSA,
   ));
   $keydetails = openssl_pkey_get_details($privkey);
   // لتحديد حفظ المفتاح العام في ملف
   file_put_contents('mypublic.key', $keydetails['key']);
?>

محتويات ملف mypublic.key هي:

-----DEBUT DE LA CLÉ PUBLIQUE-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA3QxA7vWIz+F5t12/fl0H
vyavVy/ZNZFWGK6BID/koYeVA2wKdXx9De3gn0hs4sSrN3aV58ctuxDVx36rKvYd
AjKHfnfh7NmXnCEeUE4SgUUe0UUleoEMtsPP2Q8BC1HUjcC6SyJQKZG0bQqQlnAb
HL7ou2TNsjA/SiJbPD+0OpsLAcW1c/DeoM+TAkZo0JIlgxjcJ5ZlEbJ0Mxv6m9XK
k3bbMYHtKmZl+fzfPNcxCuK8Djnm5mYVR9KX1L86m1jz2kUQT/+wW84QRnZ7G+z8
4rQ77sZvWiIwwO2JmUvIsYeUxEP6/keZbDRuyO/2tWk/VxqQry4+Ktix/M2/iKWo
QQIDAQAB
-----FIN DE LA CLÉ PUBLIQUE-----

دليل الوظائف OpenSSL PHP