PHP 基礎チュートリアル

PHP 高級チュートリアル

PHP & MySQL

PHP リファレンスマニュアル

PHP CURL 函数 PHP OpenSSL 函数

PHP openssl_pkey_new() 処理の使用法と例

PHP OpenSSL ファンクションマニュアル

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	整数	none	作成するプライベートキーのタイプです。OPENSSL_KEYTYPE_DSA、OPENSSL_KEYTYPE_DH、OPENSSL_KEYTYPE_RSA、OPENSSL_KEYTYPE_ECのいずれかができます。デフォルト値はOPENSSL_KEYTYPE_RSAです。
encrypt_key	ブール値	encrypt_key	エクスポートされたキーが暗号化されているかどうか？
encrypt_key_cipher	整数	none	パスワード定数、例えばOPENSSL_CIPHER_RC2_40（整数），OPENSSL_CIPHER_RC2_128（整数），OPENSSL_CIPHER_RC2_64（整数），OPENSSL_CIPHER_DES（整数），OPENSSL_CIPHER_3DES（整数）など。
curve_name	文字列	none	この関数openssl_get_curve_names()が返す曲線名の1つです。
config	文字列	N/A	必要に応じてopenssl.confで設定を変更し、ここにそのパスを提供することができます。

返り値

エラーがなければ、PHP openssl_pkey_new()関数はリソース識別子を返します。キー生成に失敗すると、falseを返します。

PHPバージョン

この関数は、5.0.0のPHPバージョンから動作を開始します。

例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);
?>

これにより以下の結果が得られます：

resource(2) of type (OpenSSL key)

例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
-----END PUBLIC KEY-----
　　　　[rsa]　=>　Array
　　　　　　　　(
　　　　　　　　　　　　[n]　=>　ԁ��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	
　　　　　　　　　　　　[e]　=>　
　　　　　　　　　　　　[d]　=>　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
　　　　　　　　　　　　[p]　=>　�>u)��1現在K�r���pHE��k���LBE����y�'�3-�/��Pd���jeFV1����?�.O�����:�bl2�z�U�{��{��*��A���<�}m4��J�Y�'���f@�����
　　　　　　　　　　　　[q]　=>　ߦ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',　'ようこそw3codebox');
?>

これにより以下の結果が得られます：

例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の内容は：

PHP OpenSSL ファンクションマニュアル

PHP CURL 函数 PHP OpenSSL 函数