Sync gd 2 4 by pierrejoye · Pull Request #22532 · php/php-src

pierrejoye · 2026-07-01T11:19:38Z

Sync php's libgd to current GD's master, which will be 2.4.0

New APIs

2D vector graphic APIs using FT raster (standalone version)
- Feature/vector2d 2.4 libgd/libgd#1015
Share compisitions with existing gd's functions
optionally allow to replace exising composition OPs to be replace by the new accurate ones.
ad gdImageRead* APIs, to read an image from a file/stream, codec selected using known binary signature
Codecs Added:
QOI full support (bundled/no dep)
#796 Initial QOI support, read and write libgd/libgd#1005
JXL + JXL animation
Webp animation and full formats support
Full animated WebP read/write support libgd/libgd#1001
Full TIFF support
Initial TIFF multiple pages support libgd/libgd#1010
GIF animations read and write + Full GIF support
BMP All formats but OS/2
Feature/bmpfullsupport libgd/libgd#999
AVIF animation read and write
UltraHDR support, using libultrahdr, read and write as standalone, or read SD image as gdImage
Feature/ultrahdr libgd/libgd#1003
for formats supporting it, raw metadata read/write APIs. can be then be processed and pushed back)
- Feature/metadata libgd/libgd#1002

Updated/Fixed

Color Match improvement using Lab* + Delta-E and actual % as input
Fix and improve freetype rendering and merge both php's libgd + libgd "new encoding"
. Fix RAMQ rendering
All codecs with conformance tests (upstream, C)
Perceptual difference (upstream C, will be exposed so php's tests can rely on it

WIP:

This is the 1st phase, to ensure it builds correctly in php's CI. And hopefully the new deps will be added as well.

The next phases is to expose the new APIs in php's.

…d color map

…ns (90% rewrite). update reference images (buggy before) for tests

…ns usuable, using linear RGBA instead of previous weird squared distance

…p's config. also move it to the right place

This reverts commit add1983. wrong changes. only pkg config needed

edorian · 2026-07-07T23:38:27Z

Great. All public feedback processed. Let me know if there is anything I can help with still @bukka. You're also on /cc for the other discussion.

So 👍 from my side so far

TimWolla

please refrain yourself to slip in changes not related to the topic at hand. Adding you as code owner could be done in a separate PR.

@pierrejoye I agree with David here. Can you commit the CODEOWNER change (and any other change that is not purely related to the GD sync) separately, please?

pierrejoye · 2026-07-09T06:14:02Z

please refrain yourself to slip in changes not related to the topic at hand. Adding you as code owner could be done in a separate PR.

@pierrejoye I agree with David here. Can you commit the CODEOWNER change (and any other change that is not purely related to the GD sync) separately, please?

reverted.

Resolved

TimWolla · 2026-07-09T10:39:28Z

Thanks.

As for the sync itself: Is it possible to automate the sync with a script similar to https://github.com/php/php-src/blob/master/ext/lexbor/patches/update-lexbor.sh?

This would make verification and future synchronization much easier. The sync should then also happen in a single commit, since individual commits for individual components will result in an inconsistent state for intermediate commits.

TimWolla · 2026-07-09T10:40:10Z

+	/* Keep PHP's historical PNG warning text while bundled gd_png.c stays
+	 * identical to upstream libgd. */
+	if (strcmp(format, "gd-png: fatal libpng error: %s\n") == 0) {
+		format = "gd-png:  fatal libpng error: %s";
+	} else if (strncmp(format, "gd-png error: setjmp returns error condition",
+			sizeof("gd-png error: setjmp returns error condition") - 1) == 0) {
+		format = "gd-png error: setjmp returns error condition";
+	}


I don't think this logic is necessary, there is explicitly no BC guarantee for error messages in PHP.

Right, but some phpt rely on those. So I keep them the same so tests don't need updates.

pierrejoye · 2026-07-10T03:40:13Z

Thanks.

As for the sync itself: Is it possible to automate the sync with a script similar to https://github.com/php/php-src/blob/master/ext/lexbor/patches/update-lexbor.sh?

This would make verification and future synchronization much easier. The sync should then also happen in a single commit, since individual commits for individual components will result in an inconsistent state for intermediate commits.

Not totally yet. There are a few things I like to change in ext/gd/libgd first to make it possible. The target is to do not need any script at all. Anything that needs to be specific to php will be separate files.

The issue now is that we include php's config and other similar headers as well in ext/gd/libgd/, for the php's versions of various libc functions etc. That makes automatic sync more tricky, especially for the APIs transferring memory ownership f.e., or having slighly different signatures. Some uses different types as well, making build not warning free or may affect behaviors in some edge cases.

But now, to achieve this will be significantly easier. Adding specific defines, or thin wrappers for those, upstream using the standard libc and php's use php's ones. But that is not the scope of this PR. This PR is soleny about having 2.4 synced here, tests and audits green.

I (desperately) wait for this PR to be approved, while it is approved by the last reviewer on internals, by Ilia, and indeed myself lol ;-)

The actual PR for 2.4 additions in PHP is what matters here, see https://wiki.php.net/rfc/ext-gd-2.4. Still drafting it, but it already gives a good idea.

pierrejoye · 2026-07-12T11:06:49Z

just a head up :)

@bukka possible to approve here too? approved on internals but it does make it approved here (I try to stick to the process). All issues reported here or by Volker solved but the sec, or sec-like, ones which will be done using the normal fix only and merge to active branches separately in coordination with the respective RMs.

Alternatively I can merge tomorrow, so I can push the actual 8.6 addition PR then. is that ok? :)

pierrejoye · 2026-07-14T14:52:39Z

ok, missed alpha2..... We have an issue with PRs handling, and security+RMs. I will check out what could work better and propose something to internals

Girgias · 2026-07-17T18:12:22Z

This is breaking the Solaris build:

  /home/runner/work/php-src/php-src/ext/gd/libgd/gdkanji.c:22:15: error: conflicting types for ‘iconv_t’; have ‘void *’
     22 | typedef void *iconv_t;
        |               ^~~~~~~
  In file included from /home/runner/work/php-src/php-src/ext/gd/libgd/gdkanji.c:15:
  /usr/include/iconv.h:73:29: note: previous declaration of ‘iconv_t’ with type ‘iconv_t’ {aka ‘struct _iconv_info *’}
     73 | typedef struct _iconv_info *iconv_t;
        |                             ^~~~~~~

bukka · 2026-07-19T15:23:58Z

@devnexen could you please look into that Solaris issue. It's preventing us to verify the stream changes so it would be great to have it working soon.

Jan-E · 2026-07-28T15:08:36Z

This seems to break VS18 builds (PHP 8.6.0 Alpha 3. x64, both NTS and ZTS) on Windows:

ext\gd\libgd\gd_avif.c(591): error C2440: '=': cannot convert from 'void' to 'avifResult'
ext\gd\libgd\gd_avif.c(591): error C2186: '=': an operand cannot have type 'void'

php-src/ext/gd/libgd/gd_avif.c

Line 591 in 85c26f2

result = avifRGBImageAllocatePixels(&rgb);

// this allocates memory, and sets rgb.rowBytes and rgb.pixels.
    result = avifRGBImageAllocatePixels(&rgb);

Jan-E · 2026-07-28T15:27:31Z

My bad. I had to upgrade the dependency: libavif-1.4.2

orlitzky · 2026-08-01T16:41:40Z

Will there be a new libgd-2.4.x release before this hits a PHP release? Otherwise the tests that have been updated (e.g. https://github.com/php/php-src/blob/master/ext/gd/tests/bug73291.phpt) will fail with any available external libgd.

(In that example, a SKIPIF could probably fix it, but I'm not sure what the maintainers consider essential behavior of the gd extension.)

1st part of syncing bundled LibGd to ext/gd/libgd # Updated/Fixed - Color Match improvement using Lab* + Delta-E and actual % as input - Fix and improve freetype rendering and merge both php's libgd + libgd "new encoding" - Fix RAMQ rendering - All codecs with conformance tests (upstream, C) - Perceptual difference (upstream C, will be exposed so php's tests can rely on it - libgd codecs include gif, bmp, webp and jxl full support including animation. Tiff read/write multipages. all BMP format supported but OS/2. Many of these additions or changes work already with existing php's apis. 2D vector APIs and all new Codecs or Gd\* APIs will be a separe PR+RFC. See https://wiki.php.net/rfc/ext-gd-2.4

pierrejoye added 30 commits June 29, 2026 20:50

Use advanced PNG options for imagepng

49adc4f

Synchronize bundled PNG implementation with libgd 2.4

9b7f9d0

sync gd_jpeg

30f7bec

add qoi

edf6950

more match between upstream<>php, add no-op BGD_DECLARE

d886dc4

sync gd_webp

483c68c

sync gd_avif

90bce49

sync gd_jxl

2b72144

sync gd_jxl

d0cd0ab

sync gd tga

29491bf

add webmux to config.*. preserve the warnings in php's version. add g…

5a5be00

…d color map

sync gd heif

147a1cb

ws

70b1d07

sync gd wbmp

1430213

sync gd BMP

26c65ed

fix signature, step 1

2a6aa88

sync uhdr, need some other parts in the process. Sync gd interpolatio…

3dfe937

…ns (90% rewrite). update reference images (buggy before) for tests

sync gd rotate

2ea92a0

sync gd_security

3be4900

sync topal, keep BC for image tc to palette

93bcaba

sync gd_crop, this is actually a BC break, or more make these functio…

f7cb0c7

…ns usuable, using linear RGBA instead of previous weird squared distance

sync matrix/transform/filter

2ad8070

sync grouped gd.h, gd2, xbm, tiff

5d58b0a

sync gdPngGetVersionString to libgd, and check for its existing in ph…

02a7e18

…p's config. also move it to the right place

missing that mapping for gdPngGetVersionString

194706a

add gdImageRead*, add BGD_DECLARE to gif in

f9ac483

reorder and add missing in php_compat

1d06062

sync gif in/out, add gd_filename

d49cb93

sync gd_io_dp

c34edb2

sync gd_io_ss

8e07d95

pierrejoye added 3 commits July 7, 2026 10:01

align with 1.x requirement (and config.w32)

add1983

Revert "align with 1.x requirement (and config.w32)"

3fdf781

This reverts commit add1983. wrong changes. only pkg config needed

bump minimum version to 1.0.0

839381b

TimWolla previously requested changes Jul 8, 2026

View reviewed changes

revert... procederal request.

cf75437

TimWolla reviewed Jul 9, 2026

View reviewed changes

pierrejoye merged commit d826d49 into php:master Jul 16, 2026
18 checks passed

shivammathur mentioned this pull request Jul 23, 2026

ext/gd: remove libde265 and x265 checks on Windows #22869

Merged

Uh oh!

Conversation

pierrejoye commented Jul 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Sync php's libgd to current GD's master, which will be 2.4.0

Uh oh!

edorian commented Jul 7, 2026

Uh oh!

TimWolla left a comment

Choose a reason for hiding this comment

Uh oh!

pierrejoye commented Jul 9, 2026

Uh oh!

TimWolla commented Jul 9, 2026

Uh oh!

TimWolla Jul 9, 2026

Choose a reason for hiding this comment

Uh oh!

pierrejoye Jul 10, 2026

Choose a reason for hiding this comment

Uh oh!

pierrejoye commented Jul 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pierrejoye commented Jul 12, 2026

Uh oh!

pierrejoye commented Jul 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Girgias commented Jul 17, 2026

Uh oh!

bukka commented Jul 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Jan-E commented Jul 28, 2026

Uh oh!

Jan-E commented Jul 28, 2026

Uh oh!

orlitzky commented Aug 1, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

9 participants

pierrejoye commented Jul 1, 2026 •

edited

Loading

pierrejoye commented Jul 10, 2026 •

edited

Loading

pierrejoye commented Jul 14, 2026 •

edited

Loading

bukka commented Jul 19, 2026 •

edited

Loading