php/archived-doc-en
1
0
Fork 0
mirror of https://github.com/php/doc-en.git synced 2026-03-24 15:52:15 +01:00
Code Issues Packages Projects Releases Wiki Activity

Fix GH-2655: add PEM, PKCS, CSR and DER acronyms (#2659)

Browse Source
This commit is contained in:
Alexandre Daubois
2023-09-03 21:28:51 +02:00
committed by GitHub
parent ba36a88377
commit 497c40ac16
36 changed files with 91 additions and 84 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
appendices/migration56/openssl.xml
View File

@@ -313,8 +313,8 @@ array(8) {
<function>openssl_spki_verify</function>,
<function>openssl_spki_export_challenge</function>, and
<function>openssl_spki_export</function> have been added to create, verify
export PEM public key and associated challenge from SPKAC's generated from
a <literal>KeyGen</literal> HTML5 element.
export <acronym>PEM</acronym> public key and associated challenge from
SPKAC's generated from a <literal>KeyGen</literal> HTML5 element.
</para>
<variablelist>
@@ -404,7 +404,7 @@ challenge string
<term><parameter>openssl_spki_export</parameter></term>
<listitem>
<para>
Exports the PEM formatted RSA public key from SPKAC.
Exports the <acronym>PEM</acronym> formatted RSA public key from SPKAC.
</para>
<informalexample>

5
appendices/migration80/new-features.xml
View File

@@ -344,7 +344,7 @@ class ChildClass extends ParentClass {
<para>
Added Cryptographic Message Syntax (CMS) (<link xlink:href="&url.rfc;5652">RFC 5652</link>)
support composed of functions for encryption, decryption, signing, verifying and reading. The API
is similar to the API for PKCS #7 functions with an addition of new encoding constants:
is similar to the API for <acronym>PKCS</acronym> #7 functions with an addition of new encoding constants:
<constant>OPENSSL_ENCODING_DER</constant>, <constant>OPENSSL_ENCODING_SMIME</constant>
and <constant>OPENSSL_ENCODING_PEM</constant>:
<simplelist>
@@ -357,7 +357,8 @@ class ChildClass extends ParentClass {
the results to the supplied file.
</member>
<member>
<function>openssl_cms_read</function> that exports the CMS file to an array of PEM certificates.
<function>openssl_cms_read</function> that exports the CMS file to an array
of <acronym>PEM</acronym> certificates.
</member>
<member>
<function>openssl_cms_sign</function> that signs the MIME message in the file with a cert and key

2
appendices/migration81/incompatible.xml
View File

@@ -284,7 +284,7 @@ ArgumentCountError - makeyogurt(): Argument #1 ($container) not passed
<title>OpenSSL</title>
<para>
EC private keys will now be exported in PKCS#8 format rather than
EC private keys will now be exported in <acronym>PKCS</acronym>#8 format rather than
traditional format, just like all other keys.
</para>
<para>

6
language/context/ssl.xml
View File

@@ -108,9 +108,9 @@
</term>
<listitem>
<para>
Path to local certificate file on filesystem. It must be a PEM
encoded file which contains your certificate and private key.
It can optionally contain the certificate chain of issuers.
Path to local certificate file on filesystem. It must be a
<acronym>PEM</acronym> encoded file which contains your certificate and
private key. It can optionally contain the certificate chain of issuers.
The private key also may be contained in a separate file specified
by <literal>local_pk</literal>.
</para>

2
reference/event/eventsslcontext.xml
View File

@@ -159,7 +159,7 @@
</term>
<listitem>
<para>
Path to local certificate file on filesystem. It must be a PEM-encoded
Path to local certificate file on filesystem. It must be a <acronym>PEM</acronym>-encoded
file which contains certificate. It can optionally contain the
certificate chain of issuers.
</para>

4
reference/mongodb/mongodb/driver/manager/construct.xml
View File

@@ -1002,7 +1002,7 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][
<entry><type>string</type></entry>
<entry>
<para>
Path to a PEM encoded certificate to use for client authentication.
Path to a <acronym>PEM</acronym> encoded certificate to use for client authentication.
</para>
<para>
This option is a deprecated alias for the
@@ -1015,7 +1015,7 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][
<entry><type>string</type></entry>
<entry>
<para>
Passphrase for the PEM encoded certificate (if applicable).
Passphrase for the <acronym>PEM</acronym> encoded certificate (if applicable).
</para>
<para>
This option is a deprecated alias for the

2
reference/mysqli/mysqli/ssl-set.xml
View File

@@ -70,7 +70,7 @@
<listitem>
<para>
The pathname to a directory that contains trusted SSL CA certificates
in PEM format.
in <acronym>PEM</acronym> format.
</para>
</listitem>
</varlistentry>

16
reference/openssl/certparams.xml
View File

@@ -21,12 +21,13 @@
<listitem>
<simpara>A string having the format
<filename>file://path/to/cert.pem</filename>; the named file must
contain a PEM encoded certificate
contain a <acronym>PEM</acronym> encoded certificate
</simpara>
</listitem>
<listitem>
<simpara>
A string containing the content of a certificate, PEM encoded, may start with -----BEGIN CERTIFICATE-----
A string containing the content of a certificate, <acronym>PEM</acronym>
encoded, may start with <literal>-----BEGIN CERTIFICATE-----</literal>
</simpara>
</listitem>
</orderedlist>
@@ -47,12 +48,13 @@
<listitem>
<simpara>A string having the format
<filename>file://path/to/csr.pem</filename>; the named file must
contain a PEM encoded CSR
contain a <acronym>PEM</acronym> encoded <acronym>CSR</acronym>
</simpara>
</listitem>
<listitem>
<simpara>
A string containing the content of a CSR, PEM encoded, may start with -----BEGIN CERTIFICATE REQUEST-----
A string containing the content of a <acronym>CSR</acronym>, <acronym>PEM</acronym> encoded,
may start with <literal>-----BEGIN CERTIFICATE REQUEST-----</literal>
</simpara>
</listitem>
</orderedlist>
@@ -81,12 +83,14 @@
<listitem>
<simpara>A string having the format
<filename>file://path/to/file.pem</filename> - the named file must
contain a PEM encoded certificate/private key (it may contain both)
contain a <acronym>PEM</acronym> encoded certificate/private key (it may contain both)
</simpara>
</listitem>
<listitem>
<simpara>
A string containing the content of a certificate/key, PEM encoded, may start with -----BEGIN PUBLIC KEY-----
A string containing the content of a certificate/key,
<acronym>PEM</acronym> encoded, may start with
<literal>-----BEGIN PUBLIC KEY-----</literal>
</simpara>
</listitem>
<listitem>

4
reference/openssl/constants.xml
View File

@@ -705,7 +705,7 @@
</term>
<listitem>
<simpara>
Indicates that encoding is DER (Distinguished Encoding Rules).
Indicates that encoding is <acronym>DER</acronym>.
</simpara>
</listitem>
</varlistentry>
@@ -716,7 +716,7 @@
</term>
<listitem>
<simpara>
Indicates that encoding is PEM (Privacy-Enhanced Mail).
Indicates that encoding is <acronym>PEM</acronym>.
</simpara>
</listitem>
</varlistentry>

2
reference/openssl/functions/openssl-cms-decrypt.xml
View File

@@ -53,7 +53,7 @@
<term><parameter>private_key</parameter></term>
<listitem>
<para>
The name of the file containing a PKCS#8 key.
The name of the file containing a <acronym>PKCS</acronym>#8 key.
</para>
</listitem>
</varlistentry>

2
reference/openssl/functions/openssl-cms-read.xml
View File

@@ -4,7 +4,7 @@
<refentry xml:id="function.openssl-cms-read" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>openssl_cms_read</refname>
<refpurpose>Export the CMS file to an array of PEM certificates</refpurpose>
<refpurpose>Export the CMS file to an array of <acronym>PEM</acronym> certificates</refpurpose>
</refnamediv>
<refsect1 role="description">

5
reference/openssl/functions/openssl-csr-export-to-file.xml
View File

@@ -3,7 +3,7 @@
<refentry xml:id="function.openssl-csr-export-to-file" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>openssl_csr_export_to_file</refname>
<refpurpose>Exports a CSR to a file</refpurpose>
<refpurpose>Exports a <acronym>CSR</acronym> to a file</refpurpose>
</refnamediv>
<refsect1 role="description">
@@ -17,7 +17,8 @@
<para>
<function>openssl_csr_export_to_file</function> takes the Certificate
Signing Request represented by <parameter>csr</parameter> and saves it
in PEM format into the file named by <parameter>output_filename</parameter>.
in <acronym>PEM</acronym> format into the file named by
<parameter>output_filename</parameter>.
</para>
</refsect1>

9
reference/openssl/functions/openssl-csr-export.xml
View File

@@ -3,7 +3,7 @@
<refentry xml:id="function.openssl-csr-export" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>openssl_csr_export</refname>
<refpurpose>Exports a CSR as a string</refpurpose>
<refpurpose>Exports a <acronym>CSR</acronym> as a string</refpurpose>
</refnamediv>
<refsect1 role="description">
@@ -16,8 +16,8 @@
</methodsynopsis>
<para>
<function>openssl_csr_export</function> takes the Certificate Signing
Request represented by <parameter>csr</parameter> and stores it in
PEM format in <parameter>output</parameter>, which is passed by
Request represented by <parameter>csr</parameter> and stores it in
<acronym>PEM</acronym> format in <parameter>output</parameter>, which is passed by
reference.
</para>
</refsect1>
@@ -31,7 +31,8 @@
<term><parameter>output</parameter></term>
<listitem>
<para>
on success, this string will contain the PEM encoded CSR
on success, this string will contain the <acronym>PEM</acronym>
encoded <acronym>CSR</acronym>
</para>
</listitem>
</varlistentry>

2
reference/openssl/functions/openssl-csr-get-public-key.xml
View File

@@ -3,7 +3,7 @@
<refentry xml:id="function.openssl-csr-get-public-key" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>openssl_csr_get_public_key</refname>
<refpurpose>Returns the public key of a CSR</refpurpose>
<refpurpose>Returns the public key of a <acronym>CSR</acronym></refpurpose>
</refnamediv>
<refsect1 role="description">

2
reference/openssl/functions/openssl-csr-get-subject.xml
View File

@@ -3,7 +3,7 @@
<refentry xml:id="function.openssl-csr-get-subject" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>openssl_csr_get_subject</refname>
<refpurpose>Returns the subject of a CSR</refpurpose>
<refpurpose>Returns the subject of a <acronym>CSR</acronym></refpurpose>
</refnamediv>
<refsect1 role="description">

12
reference/openssl/functions/openssl-csr-new.xml
View File

@@ -3,7 +3,7 @@
<refentry xml:id="function.openssl-csr-new" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>openssl_csr_new</refname>
<refpurpose>Generates a CSR</refpurpose>
<refpurpose>Generates a <acronym>CSR</acronym></refpurpose>
</refnamediv>
<refsect1 role="description">
@@ -16,7 +16,7 @@
<methodparam choice="opt"><type class="union"><type>array</type><type>null</type></type><parameter>extra_attributes</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<function>openssl_csr_new</function> generates a new CSR (Certificate Signing Request)
<function>openssl_csr_new</function> generates a new <acronym>CSR</acronym>
based on the information provided by <parameter>distinguished_names</parameter>.
</para>
&note.openssl.cnf;
@@ -42,7 +42,7 @@
previously generated by <function>openssl_pkey_new</function> (or
otherwise obtained from the other openssl_pkey family of functions).
The corresponding public portion of the key will be used to sign the
CSR.
<acronym>CSR</acronym>.
</para>
</listitem>
</varlistentry>
@@ -88,7 +88,7 @@
<entry>req_extensions</entry>
<entry><type>string</type></entry>
<entry>req_extensions</entry>
<entry>Selects which extensions should be used when creating a CSR</entry>
<entry>Selects which extensions should be used when creating a <acronym>CSR</acronym></entry>
</row>
<row>
<entry>private_key_bits</entry>
@@ -150,7 +150,7 @@
<listitem>
<para>
<parameter>extra_attributes</parameter> is used to specify additional
configuration options for the CSR. Both <parameter>distinguished_names</parameter> and
configuration options for the <acronym>CSR</acronym>. Both <parameter>distinguished_names</parameter> and
<parameter>extra_attributes</parameter> are associative arrays whose keys are
converted to OIDs and applied to the relevant part of the request.
</para>
@@ -163,7 +163,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns the CSR&return.falseforfailure;.
Returns the <acronym>CSR</acronym>&return.falseforfailure;.
</para>
</refsect1>

12
reference/openssl/functions/openssl-csr-sign.xml
View File

@@ -3,7 +3,7 @@
<refentry xml:id="function.openssl-csr-sign" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>openssl_csr_sign</refname>
<refpurpose>Sign a CSR with another certificate (or itself) and generate a certificate</refpurpose>
<refpurpose>Sign a <acronym>CSR</acronym> with another certificate (or itself) and generate a certificate</refpurpose>
</refnamediv>
<refsect1 role="description">
@@ -18,7 +18,7 @@
<methodparam choice="opt"><type>int</type><parameter>serial</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
<function>openssl_csr_sign</function> generates an x509 certificate from the given CSR.
<function>openssl_csr_sign</function> generates an x509 certificate from the given <acronym>CSR</acronym>.
</para>
&note.openssl.cnf;
</refsect1>
@@ -31,8 +31,8 @@
<term><parameter>csr</parameter></term>
<listitem>
<para>
A CSR previously generated by <function>openssl_csr_new</function>.
It can also be the path to a PEM encoded CSR when specified as
A <acronym>CSR</acronym> previously generated by <function>openssl_csr_new</function>.
It can also be the path to a <acronym>PEM</acronym> encoded <acronym>CSR</acronym> when specified as
<filename>file://path/to/csr</filename> or an exported string generated
by <function>openssl_csr_export</function>.
</para>
@@ -70,7 +70,7 @@
<term><parameter>options</parameter></term>
<listitem>
<para>
You can finetune the CSR signing by <parameter>options</parameter>.
You can finetune the <acronym>CSR</acronym> signing by <parameter>options</parameter>.
See <function>openssl_csr_new</function> for more information about
<parameter>options</parameter>.
</para>
@@ -147,7 +147,7 @@
<para>
<example>
<title><function>openssl_csr_sign</function> example - signing a
CSR (how to implement your own CA)</title>
<acronym>CSR</acronym> (how to implement your own CA)</title>
<programlisting role="php">
<![CDATA[
<?php

10
reference/openssl/functions/openssl-pkcs12-export-to-file.xml
View File

@@ -3,7 +3,7 @@
<refentry xml:id="function.openssl-pkcs12-export-to-file" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>openssl_pkcs12_export_to_file</refname>
<refpurpose>Exports a PKCS#12 Compatible Certificate Store File</refpurpose>
<refpurpose>Exports a <acronym>PKCS</acronym>#12 Compatible Certificate Store File</refpurpose>
</refnamediv>
<refsect1 role="description">
@@ -19,7 +19,7 @@
<para>
<function>openssl_pkcs12_export_to_file</function> stores
<parameter>certificate</parameter> into a file named by
<parameter>output_filename</parameter> in a PKCS#12 file format.
<parameter>output_filename</parameter> in a <acronym>PKCS</acronym>#12 file format.
</para>
</refsect1>
@@ -40,7 +40,7 @@
<term><parameter>private_key</parameter></term>
<listitem>
<para>
Private key component of PKCS#12 file.
Private key component of <acronym>PKCS</acronym>#12 file.
See <link linkend="openssl.certparams">Public/Private Key parameters</link> for a list of valid values.
</para>
</listitem>
@@ -49,7 +49,7 @@
<term><parameter>passphrase</parameter></term>
<listitem>
<para>
Encryption password for unlocking the PKCS#12 file.
Encryption password for unlocking the <acronym>PKCS</acronym>#12 file.
</para>
</listitem>
</varlistentry>
@@ -69,7 +69,7 @@
<tbody>
<row>
<entry><literal>"extracerts"</literal></entry>
<entry>array of extra certificates or a single certificate to be included in the PKCS#12 file.</entry>
<entry>array of extra certificates or a single certificate to be included in the <acronym>PKCS</acronym>#12 file.</entry>
</row>
<row>
<entry><literal>"friendlyname"</literal></entry>

12
reference/openssl/functions/openssl-pkcs12-export.xml
View File

@@ -3,7 +3,7 @@
<refentry xml:id="function.openssl-pkcs12-export" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>openssl_pkcs12_export</refname>
<refpurpose>Exports a PKCS#12 Compatible Certificate Store File to variable</refpurpose>
<refpurpose>Exports a <acronym>PKCS</acronym>#12 Compatible Certificate Store File to variable</refpurpose>
</refnamediv>
<refsect1 role="description">
@@ -19,7 +19,7 @@
<para>
<function>openssl_pkcs12_export</function> stores
<parameter>certificate</parameter> into a string named by
<parameter>output</parameter> in a PKCS#12 file format.
<parameter>output</parameter> in a <acronym>PKCS</acronym>#12 file format.
</para>
</refsect1>
@@ -32,7 +32,7 @@
<term><parameter>output</parameter></term>
<listitem>
<para>
On success, this will hold the PKCS#12.
On success, this will hold the <acronym>PKCS</acronym>#12.
</para>
</listitem>
</varlistentry>
@@ -40,7 +40,7 @@
<term><parameter>private_key</parameter></term>
<listitem>
<para>
Private key component of PKCS#12 file.
Private key component of <acronym>PKCS</acronym>#12 file.
See <link linkend="openssl.certparams">Public/Private Key parameters</link> for a list of valid values.
</para>
</listitem>
@@ -49,7 +49,7 @@
<term><parameter>passphrase</parameter></term>
<listitem>
<para>
Encryption password for unlocking the PKCS#12 file.
Encryption password for unlocking the <acronym>PKCS</acronym>#12 file.
</para>
</listitem>
</varlistentry>
@@ -69,7 +69,7 @@
<tbody>
<row>
<entry><literal>"extracerts"</literal></entry>
<entry>array of extra certificates or a single certificate to be included in the PKCS#12 file.</entry>
<entry>array of extra certificates or a single certificate to be included in the <acronym>PKCS</acronym>#12 file.</entry>
</row>
<row>
<entry><literal>"friendlyname"</literal></entry>

6
reference/openssl/functions/openssl-pkcs12-read.xml
View File

@@ -3,7 +3,7 @@
<refentry xml:id="function.openssl-pkcs12-read" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>openssl_pkcs12_read</refname>
<refpurpose>Parse a PKCS#12 Certificate Store into an array</refpurpose>
<refpurpose>Parse a <acronym>PKCS</acronym>#12 Certificate Store into an array</refpurpose>
</refnamediv>
<refsect1 role="description">
@@ -15,7 +15,7 @@
<methodparam><type>string</type><parameter>passphrase</parameter></methodparam>
</methodsynopsis>
<para>
<function>openssl_pkcs12_read</function> parses the PKCS#12 certificate store supplied by
<function>openssl_pkcs12_read</function> parses the <acronym>PKCS</acronym>#12 certificate store supplied by
<parameter>pkcs12</parameter> into a array named
<parameter>certificates</parameter>.
</para>
@@ -45,7 +45,7 @@
<term><parameter>passphrase</parameter></term>
<listitem>
<para>
Encryption password for unlocking the PKCS#12 file.
Encryption password for unlocking the <acronym>PKCS</acronym>#12 file.
</para>
</listitem>
</varlistentry>

6
reference/openssl/functions/openssl-pkcs7-read.xml
View File

@@ -3,7 +3,7 @@
<refentry xml:id="function.openssl-pkcs7-read" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>openssl_pkcs7_read</refname>
<refpurpose>Export the PKCS7 file to an array of PEM certificates</refpurpose>
<refpurpose>Export the PKCS7 file to an array of <acronym>PEM</acronym> certificates</refpurpose>
</refnamediv>
<refsect1 role="description">
@@ -36,7 +36,7 @@
<term><parameter>certificates</parameter></term>
<listitem>
<para>
The array of PEM certificates from the p7b input data.
The array of <acronym>PEM</acronym> certificates from the p7b input data.
</para>
</listitem>
</varlistentry>
@@ -54,7 +54,7 @@
&reftitle.examples;
<para>
<example>
<title>Get a PEM array from a P7B file</title>
<title>Get a <acronym>PEM</acronym> array from a P7B file</title>
<programlisting role="php">
<![CDATA[
<?php

2
reference/openssl/functions/openssl-pkcs7-verify.xml
View File

@@ -52,7 +52,7 @@
<para>
If the <parameter>signers_certificates_filename</parameter> is specified, it should be a
string holding the name of a file into which the certificates of the
persons that signed the messages will be stored in PEM format.
persons that signed the messages will be stored in <acronym>PEM</acronym> format.
</para>
</listitem>
</varlistentry>

2
reference/openssl/functions/openssl-pkey-export-to-file.xml
View File

@@ -17,7 +17,7 @@
</methodsynopsis>
<para>
<function>openssl_pkey_export_to_file</function> saves an ascii-armoured
(PEM encoded) rendition of <parameter>key</parameter> into the file named
(<acronym>PEM</acronym> encoded) rendition of <parameter>key</parameter> into the file named
by <parameter>output_filename</parameter>.
</para>
&note.openssl.cnf;

2
reference/openssl/functions/openssl-pkey-export.xml
View File

@@ -17,7 +17,7 @@
</methodsynopsis>
<para>
<function>openssl_pkey_export</function> exports
<parameter>key</parameter> as a PEM encoded string and stores it into
<parameter>key</parameter> as a <acronym>PEM</acronym> encoded string and stores it into
<parameter>output</parameter> (which is passed by reference).
</para>
&note.openssl.cnf;

4
reference/openssl/functions/openssl-pkey-get-private.xml
View File

@@ -31,10 +31,10 @@
<orderedlist>
<listitem><simpara>a string having the format
<filename>file://path/to/file.pem</filename>. The named file must
contain a PEM encoded certificate/private key (it may contain both).
contain a <acronym>PEM</acronym> encoded certificate/private key (it may contain both).
</simpara>
</listitem>
<listitem><simpara>A PEM formatted private key.</simpara></listitem>
<listitem><simpara>A <acronym>PEM</acronym> formatted private key.</simpara></listitem>
</orderedlist>
</para>
</listitem>

4
reference/openssl/functions/openssl-pkey-get-public.xml
View File

@@ -32,10 +32,10 @@
<listitem><simpara>an <classname>OpenSSLAsymmetricKey</classname> instance</simpara></listitem>
<listitem><simpara>a string having the format
<filename>file://path/to/file.pem</filename>. The named file must
contain a PEM encoded certificate/public key (it may contain both).
contain a <acronym>PEM</acronym> encoded certificate/public key (it may contain both).
</simpara>
</listitem>
<listitem><simpara>A PEM formatted public key.</simpara></listitem>
<listitem><simpara>A <acronym>PEM</acronym> formatted public key.</simpara></listitem>
</orderedlist>
</para>
</listitem>

2
reference/openssl/functions/openssl-sign.xml
View File

@@ -52,7 +52,7 @@
<classname>OpenSSLAsymmetricKey</classname> - a key, returned by <function>openssl_get_privatekey</function>
</para>
<para>
<type>string</type> - a PEM formatted key
<type>string</type> - a <acronym>PEM</acronym> formatted key
</para>
</listitem>
</varlistentry>

10
reference/openssl/functions/openssl-spki-export.xml
View File

@@ -3,7 +3,7 @@
<refentry xml:id="function.openssl-spki-export" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>openssl_spki_export</refname>
<refpurpose>Exports a valid PEM formatted public key signed public key and challenge</refpurpose>
<refpurpose>Exports a valid <acronym>PEM</acronym> formatted public key signed public key and challenge</refpurpose>
</refnamediv>
<refsect1 role="description">
@@ -13,7 +13,7 @@
<methodparam><type>string</type><parameter>spki</parameter></methodparam>
</methodsynopsis>
<para>
Exports PEM formatted public key from encoded signed public key and challenge
Exports <acronym>PEM</acronym> formatted public key from encoded signed public key and challenge
</para>
</refsect1>
@@ -34,7 +34,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns the associated PEM formatted public key or &false; on failure.
Returns the associated <acronym>PEM</acronym> formatted public key or &false; on failure.
</para>
</refsect1>
@@ -51,7 +51,7 @@
<example xml:id="openssl_spki_export.example.basic">
<title><function>openssl_spki_export</function> example</title>
<para>
Extracts the associated PEM formatted public key or NULL on failure.
Extracts the associated <acronym>PEM</acronym> formatted public key or &null; on failure.
</para>
<programlisting role="php">
<![CDATA[
@@ -70,7 +70,7 @@ if ($pubKey) {
<example xml:id="openssl_spki_export.example.keygen">
<title><function>openssl_spki_export</function> example from &lt;keygen&gt;</title>
<para>
Extracts the associated PEM formatted public key issued from the &lt;keygen&gt; element
Extracts the associated <acronym>PEM</acronym> formatted public key issued from the &lt;keygen&gt; element
</para>
<programlisting role="php">
<![CDATA[

2
reference/openssl/functions/openssl-spki-new.xml
View File

@@ -30,7 +30,7 @@
previously generated by <function>openssl_pkey_new</function> (or
otherwise obtained from the other openssl_pkey family of functions).
The corresponding public portion of the key will be used to sign the
CSR.
<acronym>CSR</acronym>.
</para>
</listitem>
</varlistentry>

4
reference/openssl/functions/openssl-verify.xml
View File

@@ -51,8 +51,8 @@
<classname>OpenSSLAsymmetricKey</classname> - a key, returned by <function>openssl_get_publickey</function>
</para>
<para>
<type>string</type> - a PEM formatted key, example, "-----BEGIN PUBLIC KEY-----
MIIBCgK..."
<type>string</type> - a <acronym>PEM</acronym> formatted key (e.g. <literal>-----BEGIN PUBLIC KEY-----
MIIBCgK...</literal>)
</para>
</listitem>
</varlistentry>

2
reference/openssl/functions/openssl-x509-checkpurpose.xml
View File

@@ -99,7 +99,7 @@
<term><parameter>untrusted_certificates_file</parameter></term>
<listitem>
<para>
If specified, this should be the name of a PEM encoded file holding
If specified, this should be the name of a <acronym>PEM</acronym> encoded file holding
certificates that can be used to help verify the certificate, although
no trust is placed in the certificates that come from that file.
</para>

2
reference/openssl/functions/openssl-x509-export-to-file.xml
View File

@@ -17,7 +17,7 @@
<para>
<function>openssl_x509_export_to_file</function> stores
<parameter>certificate</parameter> into a file named by
<parameter>output_filename</parameter> in a PEM encoded format.
<parameter>output_filename</parameter> in a <acronym>PEM</acronym> encoded format.
</para>
</refsect1>

4
reference/openssl/functions/openssl-x509-export.xml
View File

@@ -17,7 +17,7 @@
<para>
<function>openssl_x509_export</function> stores
<parameter>certificate</parameter> into a string named by
<parameter>output</parameter> in a PEM encoded format.
<parameter>output</parameter> in a <acronym>PEM</acronym> encoded format.
</para>
</refsect1>
@@ -30,7 +30,7 @@
<term><parameter>output</parameter></term>
<listitem>
<para>
On success, this will hold the PEM.
On success, this will hold the <acronym>PEM</acronym>.
</para>
</listitem>
</varlistentry>

4
reference/openssl/functions/openssl-x509-verify.xml
View File

@@ -32,8 +32,8 @@
<classname>OpenSSLAsymmetricKey</classname> - a key, returned by <function>openssl_get_publickey</function>
</para>
<para>
<type>string</type> - a PEM formatted key, example, "-----BEGIN PUBLIC KEY-----
MIIBCgK..."
<type>string</type> - a <acronym>PEM</acronym> formatted key (e.g. <literal>-----BEGIN PUBLIC KEY-----
MIIBCgK...</literal>)
</para>
</listitem>
</varlistentry>

2
reference/pdo_mysql/constants.xml
View File

@@ -190,7 +190,7 @@ foreach ($unbufferedResult as $row) {
<listitem>
<para>
The file path to the directory that contains the trusted SSL
CA certificates, which are stored in PEM format.
CA certificates, which are stored in <acronym>PEM</acronym> format.
</para>
</listitem>
</varlistentry>

2
reference/soap/soapclient/construct.xml
View File

@@ -200,7 +200,7 @@
<listitem>
<para>
Path to a client certificate for use with HTTPS authentication.
It must be a PEM encoded file which contains your certificate
It must be a <acronym>PEM</acronym> encoded file which contains your certificate
and private key.
</para>
<para>