added openssl applink shim note to UPGRADING.INTERNALS

diff --git a/UPGRADING.INTERNALS b/UPGRADING.INTERNALS
index 8437b0b341cad45613244ec07d68aa6c97fbb3ac..c264e1b214d924cf3d3284858567a3f2f75fe2d9 100644 (file)
--- a/UPGRADING.INTERNALS
+++ b/UPGRADING.INTERNALS
@@ -275,3 +275,14 @@ changes. See: https://wiki.php.net/phpng-upgrading
     - More documentation can be found in ext/session/mod_files.c as comments.
       mod_files.c may be used as reference implementation.
  
+  Openssl:
+    - several ext/openssl functions require the inclusion of the applink shim
+      as documented in the OpenSSL FAQ https://www.openssl.org/support/faq.html#PROG2
+      to properly work on Windows. While this primarily affects the OpenSSL
+      functionality, the shim needs to be included into the executable file
+      which loads the extension DLL, not into the extension DLL itself. Thus, this
+      primarily affects any WAMP or other redistributions bundling the official
+      PHP releaze zipballs or building from sources. The applink shim is already
+      integrated with all the PHP executables from the official distribution
+      starting with 7.0.0beta1.
+