Usage troubles under Windows

[West14]

Hello!

I'm trying to use your library under Windows 10, but there are few problems that I can't figure out how to solve.

1. "The printf check" fails. It can't find printf function.

An exception occurred: [FFI\Exception] Failed resolving C function 'printf' in src\addons\Bubuni\LibVips\vendor\jcupitt\vips\src\FFI.php on line 208
#0 src\addons\Bubuni\LibVips\vendor\jcupitt\vips\src\FFI.php(208): FFI::cdef('    int printf(...')
#1 src\addons\Bubuni\LibVips\vendor\jcupitt\vips\src\FFI.php(116): Jcupitt\Vips\FFI::init()
#2 src\addons\Bubuni\LibVips\vendor\jcupitt\vips\src\VipsOperation.php(80): Jcupitt\Vips\FFI::vips()
#3 src\addons\Bubuni\LibVips\vendor\jcupitt\vips\src\VipsOperation.php(225): Jcupitt\Vips\VipsOperation::newFromName('black')
#4 src\addons\Bubuni\LibVips\vendor\jcupitt\vips\src\Image.php(1290): Jcupitt\Vips\VipsOperation::callBase('black', NULL, Array)
#5 test.php(28): Jcupitt\Vips\Image::__callStatic('black', Array)
#6 {main}

When I comment it, things start to work.

I also want to ask: what is the latest supported libvips version? When i try 8.14. I get errors like this.

I tried 8.13, but it does not give the expected result (I'll attach reproduce example if needed).
libvips 8.9 seems to be fine.

PHP version:

PHP 7.4.27 (cli) (built: Dec 14 2021 19:52:13) ( ZTS Visual C++ 2017 x64 )
Copyright (c) The PHP Group
Zend Engine v3.4.0, Copyright (c) Zend Technologies
    with Xdebug v3.1.6, Copyright (c) 2002-2022, by Derick Rethans

[jcupitt]

Hi @West14,

Thanks for reporting this. That's odd, I'd expect ffi to find printf in your C runtime. I have a win10 VM here, I'll fire it up and try it.

[jcupitt]

When i try 8.14. I get errors like this.

I tried here and it seems to work. I downloaded:

https://github.com/libvips/build-win64-mxe/releases/download/v8.14.1/vips-dev-w64-web-8.14.1.zip

Then:

jcupi@DESKTOP-HGI6HBR MINGW64 /f/Downloads
$ unzip -qq vips-dev-w64-web-8.14.1.zip

jcupi@DESKTOP-HGI6HBR MINGW64 /f/Downloads
$ cd vips-dev-8.14/bin/

jcupi@DESKTOP-HGI6HBR MINGW64 /f/Downloads/vips-dev-8.14/bin
$ ./vips.exe black x.png 10 10

jcupi@DESKTOP-HGI6HBR MINGW64 /f/Downloads/vips-dev-8.14/bin
$

What did you download and how did you install it?

[West14]

./vips.exe black x.png 10 10

Problems occur when using PHP bindings. The CLI utility works fine and I have no issues with it.

[jcupitt]

So therefore I think it must be problem with the way you've installed libvips under php. You must have several different versions of eg. libglib-2.0.dll on your PATH, with an older one overriding the more recent version that libvips needs. It's quite a common library, so I expect you have installed some other package that also bundles it.

[jcupitt]

I had a read around and I agree, I think the printf test won't work on Windows. I thought with no lib it'd search the C runtime (most ffis work like this), but it seems on php it'll search the running php executable itself, but only if the platform supports backlinking (which win does not, since it's missing a run-time linker).

I'll put an if(PHP_OS_FAMILY !== "Windows"){} around that.

I removed that test and it then worked for me. Here's what I did:

Install php

I installed this php:

https://windows.php.net/downloads/releases/php-8.2.1-Win32-vs16-x64.zip

I put it in /c/php to make config simple.

I made a copy of php.ini-development with these changes:

diff --git a/php.ini-development b/php.ini
index 70c6b00..8c29d74 100644
--- a/php.ini-development
+++ b/php.ini
@@ -920,7 +920,7 @@ default_socket_timeout = 60
 ;extension=ldap

 ;extension=curl
-;extension=ffi
+extension=ffi
 ;extension=ftp
 ;extension=fileinfo
 ;extension=gd
@@ -1955,7 +1955,7 @@ ldap.max_links = -1
 ; "preload" - enabled in CLI scripts and preloaded files (default)
 ; "false"   - always disabled
 ; "true"    - always enabled
-;ffi.enable=preload
+ffi.enable=true

 ; List of headers files to preload, wildcard patterns allowed.
 ;ffi.preload=

Install libvips

I installed this libvips:

https://github.com/libvips/build-win64-mxe/releases/download/v8.14.1/vips-dev-w64-web-8.14.1.zip

Then copied the contents of the bin/ directory to bin in my windows home directory. I chose this location because it was on my PATH, though I don't know how it got there heh.

jcupi@DESKTOP-HGI6HBR MINGW64 /c/php
$ ls ~/bin
libaom.dll*               libgobject-2.0-0.dll*     libspng-0.dll*
libc++.dll*               libgsf-1-114.dll*         libtiff-6.dll*
libcairo-2.dll*           libharfbuzz-0.dll*        libunwind.dll*
libcgif-0.dll*            libheif.dll*              libvips-42.dll*
libexif-12.dll*           libimagequant.dll*        libvips-cpp-42.dll*
libexpat-1.dll*           libjpeg-62.dll*           libwebp-7.dll*
libffi-8.dll*             liblcms2-2.dll*           libwebpdemux-2.dll*
libfontconfig-1.dll*      liborc-0.4-0.dll*         libwebpmux-3.dll*
libfreetype-6.dll*        libpango-1.0-0.dll*       libxml2-2.dll*
libfribidi-0.dll*         libpangocairo-1.0-0.dll*  libz1.dll*
libgdk_pixbuf-2.0-0.dll*  libpangoft2-1.0-0.dll*    vips.exe*
libgio-2.0-0.dll*         libpixman-1-0.dll*        vipsedit.exe*
libglib-2.0-0.dll*        libpng16-16.dll*          vipsheader.exe*
libgmodule-2.0-0.dll*     librsvg-2-2.dll*          vipsthumbnail.exe*

This is a dangerous thing to do -- adding dlls to your main PATH is asking for trouble. I'd find a better way to handle this if I was trying to do this properly. I'll remove these dlls again ASAP.

Install php-vips

I downloaded a copy of php-vips-master, then went to the examples/ directory. I took a copy of the vendor/ directory from a working php-vips install I had under linux (simpler than getting composer running under win).

Then tried php-vips like this:

jcupi@DESKTOP-HGI6HBR MINGW64 /f/GIT/php-vips-master/examples
$ /c/php/php.exe watermark-text.php /f/Downloads/download.jpg x.png hello

jcupi@DESKTOP-HGI6HBR MINGW64 /f/GIT/php-vips-master/examples
$

And it made this:

So all working, I think.

[jcupitt]

Ah it looks like php-vips 2.1.0 is missing the printf() test, you could try that.

[jcupitt]

I added the platform check to php-vips master.

I tried 8.13, but it does not give the expected result (I'll attach reproduce example if needed).

Yes please, it'd be interesting to see what failed.

[West14]

So therefore I think it must be problem with the way you've installed libvips under php. You must have several different versions of eg. libglib-2.0.dll on your PATH, with an older one overriding the more recent version that libvips needs. It's quite a common library, so I expect you have installed some other package that also bundles it.

Thanks for the hint. Thats it!
My web-server software uses separate PATH and there was one libglib-2.0-0.dll in the nginx package.

Thank you very much!

Yes please, it'd be interesting to see what failed.

I will check it again and post here. Now I'm not sure I did the test right.

[West14]

I'll put an if(PHP_OS_FAMILY !== "Windows"){} around that.

Maybe ini_get and extension_loaded can be used?
It seems OK.

So we can just do the check like this:

extension_loaded('ffi') && strtolower(ini_get('ffi.enable')) == 'true'

[jcupitt]

Oh nice! I've added that and credited you.

[jcupitt]

Though I see:

$ php -r "var_dump(ini_get('ffi.enable'));"
string(1) "1"
$ php --version
PHP 8.1.7-1ubuntu3.1 (cli) (built: Nov  2 2022 13:39:03) (NTS)

Which is curious.

[West14]

I'm trying to find out a way how to check it easily.

This is how PHP determines if INI value is true, so perhaps a similar check could be implemented in the library?
https://github.com/php/php-src/blob/ec23f28ea8549f5c4ddbcb9c48728e82d5219ba8/Zend/zend_ini.c#L573-L583

And, of course, we must not forget about the "preload" option, which is currently not supported as far as I know.

[West14]

Also, we can simply check for the existence of the FFI class.
i.e.

class_exists('FFI')

This can only be used to check if an extension is loaded. The ffi.enable value has no effect on the existence of the class.