Doc #76649 [Ver]: cURL module requires libssh2.dll

From: Date: Mon, 23 Jul 2018 14:00:30 +0000
Subject: Doc #76649 [Ver]: cURL module requires libssh2.dll
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-15924@lists.php.net to get a copy of this message 
Edit report at https://bugs.php.net/bug.php?id=76649&edit=1

 ID:                 76649
 Updated by:         requinix@php.net
 Reported by:        laucomm at gmail dot com
 Summary:            cURL module requires libssh2.dll
 Status:             Verified
 Type:               Documentation Problem
 Package:            cURL related
 Operating System:   Windows
 PHP Version:        7.2.8
 Block user comment: N
 Private report:     N

 New Comment:

I just downloaded PHP from that earlier link you posted,
> https://windows.php.net/downloads/releases/php-7.2.8-Win32-VC15-x64.zip)
and it still has the three DLL files required for php_curl.dll to work: libcrypto-1_1-x64.dll,
libssl-1_1-x64.dll, libssh2.dll. Just like it did yesterday when I downloaded it then.

I also just now went to the Apache Lounge to get their files. Again. Their VC15 also has libcrypto
and libssl too but it does not have libssh2.

My answer about copying the libssh2 file was not some random guess: I reproduced your problem,
identified the cause as the missing dependency, copied the file like I said, and it worked.
I don't know what files you're getting from where, but you're doing something wrong.


Previous Comments:
------------------------------------------------------------------------
[2018-07-23 13:28:27] ab@php.net

@laucomm thanks for the report. @requinix already has pointed to the right solution - either the
DLLs need to be copied or at least be on teh path. That was your initial issue, as cli showed curl
loaded on your side.

With regard to openssl - PHP 7.2 is shipped with OpenSSL 1.1.0 by default. If you need to use PHP as
Apache module, then Apache needs to be linked with same OpenSSL version and same CRT. Apache Lounge
are recommended Apache builds.

Perhaps it needs to be documented, whereby i'm not sure what exactly. With the DLL names -
it's an implementation detail, the constellation can change in future. Perhaps one should
document, if it isn't done already, that the PHP dir needs to be ensured to be on the path if
used as Apache module.

Thanks.

------------------------------------------------------------------------
[2018-07-23 12:25:55] laucomm at gmail dot com

So here is the full deal:

cURL is not just an independent extension but depends on the 3 libraries libeay32, ssleay32 and
libssh2 as described in the note and comments section of it's current doc:
https://secure.php.net/manual/en/curl.installation.php

Because the extension depends on external libraries being available to the web server, the
distribution of those libraries with either the web server (Apache) or PHP is necessary. If the 3
libraries are alread being shipped with Apache, no steps are needed and cURL should just work fine.
If any one of the libraries is missing, the cURL module will not work.

The official Apache site lists the folling links as the first two recommendended download locations
for Apache binaries compiled for windows:
https://www.apachehaus.com/cgi-bin/download.plx
https://www.apachelounge.com/download/

The official binaries of PHP 7.2.8 for Windows are compiled against VC15.
The first location "ApacheHaus" does not provide VC15 compiled binaries, but
"ApacheLounge" (the second location) does.
In the VC14 compiled distribution of both Apache binary providers, the 2 libraries libeay32 and
ssleay32 are included, thus copying the missing libssh2.dll from the PHP distribution to the Apache
bin/ folder will successfully load the cURL extension.

The VC15 compiled Apache distribution (only available from "ApacheLounge") does not
include any of the needed 3 libraries. The older PHP distributions like PHP 7.1.9 did include all 3
needed libraries and made it possible to copy them to the Apache's bin/ folder. But the current
PHP 7.2.8 distribution does just include 1 of the needed libraries (libssh2.dll).

So because neither Apache 2.4. x64 (VC15) nor PHP 7.2.8 x64 (VC15) are being shipped with the
necessary libraries, they cannot be copied to Apache's bin/ folder.

This is not a simple documentation issue. PHP is not shipping all necessary libraries for cURL to
work under current conditions anymore.

------------------------------------------------------------------------
[2018-07-23 04:01:34] requinix@php.net

I was able to reproduce that cURL was not loaded, but copying libssh2.dll fixed it.

Did you do what I said about enabling logging? Did you check the Apache error log to see that PHP
complained about "module not found" when trying to load the extension?

And phpinfo() will show a section for cURL, even if its INI settings aren't included.

------------------------------------------------------------------------
[2018-07-22 19:34:47] laucomm at gmail dot com

I did read the following comments:
https://php.net/manual/en/curl.installation.php#122314

Though they appear to be out of date, I did try them out and copied the only one actually available
of the three suggested files (libssh2.dll) to the Apache bin/ folder and also tried loading it with
LoadFile (of course I restarted the service in between).

The function "curl_init()" is still undefined.

---

By the way, I guess because of the following fix to the PHP source, the INI settings of the loaded
cURL module might not be displayed in the phpinfo() output of PHP 7.2.8:

https://github.com/php/php-src/commit/b585f043cb0078d01e982ff034d64421a97d8e8f#diff-ac978e3de205f1d14eb960e0eb15ef24

---

Also, I have cURL running fine on the same machine with a PHP 7.1.9.

Is there anybody with a windows machine, Apache 2.4 x64 and PHP 7.2.8 x64 that can confirm this
issue?

------------------------------------------------------------------------
[2018-07-22 18:14:17] requinix@php.net

Oh. When in doubt with problems like this, make sure you have error logging enabled (including
display_startup_errors) and that you've checked the appropriate error logs.

------------------------------------------------------------------------


The remainder of the comments for this report are too long. To view
the rest of the comments, please view the bug report online at

    https://bugs.php.net/bug.php?id=76649


--
Edit this bug report at https://bugs.php.net/bug.php?id=76649&edit=1

Thread (12 messages)

« previous php.doc.bugs (#15924) next »