Index: phpdoc/en/reference/openssl/configure.xml
diff -u phpdoc/en/reference/openssl/configure.xml:1.1 phpdoc/en/reference/openssl/configure.xml:1.2
--- phpdoc/en/reference/openssl/configure.xml:1.1 Sun Dec 1 12:10:14 2002
+++ phpdoc/en/reference/openssl/configure.xml Wed Dec 11 10:50:47 2002
@@ -1,5 +1,5 @@
-
+
&reftitle.install;
@@ -13,6 +13,50 @@
libeay32.dll from the DLL folder of the PHP/Win32 binary
package to the SYSTEM32 folder of your windows machine. (Ex: C:\WINNT\SYSTEM32
or C:\WINDOWS\SYSTEM32)
+
+
+ Additionally, if you are planning to use the key generation and certificate
+ signing functions, you will need to install a valid
+ openssl.cnf on your system. As of PHP 4.3.0, we
+ include a sample configuration file in the openssl of
+ our win32 binary distribution. If you are using PHP 4.2.0 or later and are
+ missing the file, you can obtain it from the
+ OpenSSL home page or by downloading the PHP 4.3.0 release and using
+ the configuration file from there.
+
+
+ PHP will search for the openssl.cnf using the
+ following logic:
+
+
+ the OPENSSL_CONF environmental variable, if
+ set, will be used as the path (including filename) of the configuration
+ file.
+
+
+
+ the SSLEAY_CONF environmental variable, if
+ set, will be used as the path (including filename) of the configuration
+ file.
+
+
+
+ The file openssl.cnf will be assumed to be
+ found in the default certificate area, as configured at the time that
+ the openssl DLL was compiled. This is usually means that the default
+ filename is c:\usr\local\ssl\openssl.cnf.
+
+
+
+
+
+ In your installation, you need to decide whether to install the
+ configuration file at c:\usr\local\ssl\openssl.cnf or
+ whether to install it someplace else and use environmental variables
+ (possibly on a per-virtual-host basis) to locate the configuration file.
+ Note that it is possible to override the default path from the script using
+ the configargs of the functions that require a
+ configuration file.
Index: phpdoc/en/reference/openssl/functions/openssl-csr-new.xml
diff -u phpdoc/en/reference/openssl/functions/openssl-csr-new.xml:1.4 phpdoc/en/reference/openssl/functions/openssl-csr-new.xml:1.5
--- phpdoc/en/reference/openssl/functions/openssl-csr-new.xml:1.4 Tue Dec 10 14:13:48 2002
+++ phpdoc/en/reference/openssl/functions/openssl-csr-new.xml Wed Dec 11 10:50:47 2002
@@ -1,5 +1,5 @@
-
+
@@ -33,6 +33,7 @@
extraattribs are associative arrays whose keys are
converted to OIDs and applied to the relevant part of the request.
+ &reference.openssl.note-openssl-cnf;
By default, the information in your system openssl.conf
is used to initialize the request; you can specify a configuration file
@@ -109,7 +110,8 @@
- <function>openssl_csr_new</function> example
+ <function>openssl_csr_new</function> example - creating a
+ self-signed-certificate
-
+
@@ -33,6 +33,43 @@
Returns an x509 certificate resource on success, &false; on failure.
+ &reference.openssl.note-openssl-cnf;
+
+
+ <function>openssl_csr_sign</function> example - signing a
+ CSR (how to implement your own CA)
+
+
+
+
+
+
Index: phpdoc/en/reference/openssl/functions/openssl-pkey-export-to-file.xml
diff -u phpdoc/en/reference/openssl/functions/openssl-pkey-export-to-file.xml:1.3 phpdoc/en/reference/openssl/functions/openssl-pkey-export-to-file.xml:1.4
--- phpdoc/en/reference/openssl/functions/openssl-pkey-export-to-file.xml:1.3 Tue Dec 10 14:13:48 2002
+++ phpdoc/en/reference/openssl/functions/openssl-pkey-export-to-file.xml Wed Dec 11 10:50:47 2002
@@ -1,5 +1,5 @@
-
+
@@ -26,6 +26,7 @@
information about configargs.
&return.success;
+ &reference.openssl.note-openssl-cnf;
Index: phpdoc/en/reference/openssl/functions/openssl-pkey-export.xml
diff -u phpdoc/en/reference/openssl/functions/openssl-pkey-export.xml:1.3 phpdoc/en/reference/openssl/functions/openssl-pkey-export.xml:1.4
--- phpdoc/en/reference/openssl/functions/openssl-pkey-export.xml:1.3 Tue Dec 10 14:13:48 2002
+++ phpdoc/en/reference/openssl/functions/openssl-pkey-export.xml Wed Dec 11 10:50:47 2002
@@ -1,5 +1,5 @@
-
+
@@ -26,6 +26,7 @@
information about configargs.
&return.success;
+ &reference.openssl.note-openssl-cnf;
Index: phpdoc/en/reference/openssl/functions/openssl-pkey-new.xml
diff -u phpdoc/en/reference/openssl/functions/openssl-pkey-new.xml:1.3 phpdoc/en/reference/openssl/functions/openssl-pkey-new.xml:1.4
--- phpdoc/en/reference/openssl/functions/openssl-pkey-new.xml:1.3 Tue Dec 10 14:13:48 2002
+++ phpdoc/en/reference/openssl/functions/openssl-pkey-new.xml Wed Dec 11 10:50:47 2002
@@ -1,5 +1,5 @@
-
+
@@ -21,6 +21,7 @@
openssl_csr_new for more information about
configargs.
+ &reference.openssl.note-openssl-cnf;
Index: phpdoc/en/reference/openssl/note-openssl-cnf.xml
+++ phpdoc/en/reference/openssl/note-openssl-cnf.xml
You need to have a valid openssl.cnf installed for
this function to operate correctly.
See the notes under for more
information.
