From 805d487bacc09abce4c74943096a613521b47f8d Mon Sep 17 00:00:00 2001 From: James Titcumb Date: Mon, 18 Aug 2025 08:14:16 +0100 Subject: [PATCH] Clarify normalisation of Windows architecture values --- docs/extension-maintainers.md | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/docs/extension-maintainers.md b/docs/extension-maintainers.md index ac818004..34934da6 100644 --- a/docs/extension-maintainers.md +++ b/docs/extension-maintainers.md @@ -331,9 +331,20 @@ The descriptions of these items: 'PHP Extension Build' flags in `php -i` * `ts|nts` - Thread-safe or non-thread safe. * `arch` - for example `x86_64`. - * Windows: `Architecture` from `php -i` + * Windows: use a hint from `Architecture` from `php -i` (see below) * non-Windows: check `PHP_INT_SIZE` - 4 for 32-bit, 8 for 64-bit. +Note the architecture name will likely need normalising, since different +platforms name architectures differently. PIE expects the following normalised +architectures: + + * `x86_64` (normalised from `x64`, `x86_64`, `AMD64`) + * `arm64` (normalised from `arm64`) + * `x86` (any other value) + +For the latest map (in case documentation is not up to date), check out +`\Php\Pie\Platform\Architecture::parseArchitecture`. + #### Contents of the Windows ZIP The pre-built ZIP should contain at minimum a DLL named in the same way as the