PHP Wiki - internals:windows

bugs2discuss

Anonymous (anonymous@undisclosed.example.com) — 2025-04-03T13:08:43+00:00

2008/05/21 19:48		current
Line 1:		Line 1:
	====== Failed Tests on Windows ======		====== Failed Tests on Windows ======
		+

	===== ext/standard/tests/dir/ =====		===== ext/standard/tests/dir/ =====
Line 6:		Line 7:
	ext/standard/tests/dir/closedir_variaton3.phpt		ext/standard/tests/dir/closedir_variaton3.phpt

		+	Something is broken in debug mode (has to be tested in normal mode). Doing readdir($fp); outputs some random buffer.

	===== ext/standard/file =====		===== ext/standard/file =====

buildv2

Anonymous (anonymous@undisclosed.example.com) — 2025-04-03T13:08:43+00:00

2016/11/21 03:18		current
Line 42:		Line 42:
	+- ...		+- ...
	</code>		</code>
		+
		+	===== Extension Config Load Order =====
		+
		+	On the Unix build system, the config.m4 files allows a numeric order to be loaded in, this is done by adding a suffix to "config" with a value of 0-9 followed by the file extension, such as "config9.m4". The Windows build system does not offer such, and there are no plans to implement such in this proposal.

	===== Multi Compiler Support =====		===== Multi Compiler Support =====
Line 294:		Line 298:
	</code>		</code>

-	This makes the libraries much easier to handle and check and it provides the same flexibility as before in a more friendly interface.	+	This makes the libraries much easier to handle and check and it provides the same flexibility as before in a more friendly interface. Above example is just a small illustration of the API that can be used, the full API is described later in this document.
		+
		+	==== Extension dependencies ====
		+
		+	It is common for extensions to depend on others, these can either be optional, required or even semi depended on others, like the ext/curl extension that can depend on ZLib depending on how it was configured.
		+
		+	In the Extension constructor, the following methods are available for dependencies, the following example will use ext/pdo_sqlite:
		+
		+	<code javascript>
		+	public function pdo_sqlite()
		+	{
		+	this.Dependencies(['pdo']);
		+	};
		+	</code>
		+
		+	If the 'pdo' extension was not enabled prior to this, then an exception is thrown from the Dependencies() method, stopping the configure command.
		+
		+	An extension can also optionally depend on another, and if it is available, then an extension can take advantage of its utility:
		+
		+	<code javascript>
		+	public function test_ext()
		+	{
		+	// Works for both static and shared builds
		+	if(this.getExtension('json'))
		+	{
		+	this.Define('HAVE_JSON_SUPPORT', 1);
		+	}
		+
		+	// Or if static json is required
		+	if(this.getExtension('json', this.build_type.StaticBuild))
		+	{
		+	this.Define('HAVE_STATIC_JSON_SUPPORT', 1);
		+	}
		+	};
		+	</code>
		+
		+	==== Extensions that run external programs, such as parsers ====
		+
		+	Some extensions, or SAPIs run external programs before compiling for generating parsers or similar, such is also possible in the new build system:
		+
		+	<code javascript>
		+	public function json()
		+	{
		+	if(!this.FSO.FileExists('ext/json/json_scanner.c'))
		+	{
		+	PHPBuild.ExecuteBinary('re2c', '-t ext/json/php_json_scanner_defs.h --no-generation-date -bci -o ext/json/json_scanner.c ext/json/json_scanner.re');
		+	}
		+
		+	*/ ... /*
		+	};
		+	</code>
		+
		+	==== Extensions that adds additional configure arguments ====
		+
		+	It is very common for extensions to provide additional configurations from arguments, by default each declared extension will be supported by either:
		+
		+	* --with-<ext>
		+	* --enable-<ext>
		+
		+	This type is defined in the Extension.arg_type property to an enum value of either ArgType.WITH or ArgType.ENABLE. However extensions may also add their own, this is done in the property called 'config_args':
		+
		+	<code javascript>
		+	class test_ext extends Extension
		+	{
		+	public const name : string = 'Test Extension';
		+	public const short_name : string = 'test_ext';
		+
		+	public const arg_type : ArgType = ArgType.WITH;
		+	public const config_args : object = {
		+	'test-ext-debug': ArgType.ENABLE
		+	};
		+
		+	public shared : bool;
		+
		+	public const files : array = ['php_test_ext.c'];
		+
		+
		+	public function test_ext()
		+	{
		+	if(this.GetArg('test-ext-debug').isEnabled())
		+	{
		+	this.CFlag('/D HAVE_TEST_EXT_DEBUG');
		+	}
		+	}
		+	}
		+
		+	PHPBuild.AddExtension(new test_ext);
		+	</code>
		+
		+	The GetArg() method returns an 'BuildArgument' object, that contains helper methods, such as isEnabled() to quickly determine the value was turned by a manual --enable-test-ext-debug
		+
		+	==== Extensions that implements multiple build modess in one config file ====
		+
		+	There are some extensions that can be built in multiple ways, one such case is ext/pdo_dblib


	TODO		TODO
	* sapis		* sapis
		+	* consider changing 'new xxx' in calls, as they are executed directly
	* improve arg api for exts		* improve arg api for exts
	* multi build args for an ext		* multi build args for an ext
	* multi extensions per config, like pdo_dblib		* multi extensions per config, like pdo_dblib
-	* configX.m4 support, priority load order
	* talk about task size and target		* talk about task size and target
	* talk about design reasoning		* talk about design reasoning
	* API reference		* API reference
	* implementation stages(?)		* implementation stages(?)

compiler

Anonymous (anonymous@undisclosed.example.com) — 2025-04-03T13:08:43+00:00

2019/03/31 10:42		current
Line 13:		Line 13:
	\| Visual C++ 14.00 (2015) \| No \| No \| No \| No \| No \| Yes \| Yes(%%%%) \| Yes(%%%%) \| No \| No \| Yes \|		\| Visual C++ 14.00 (2015) \| No \| No \| No \| No \| No \| Yes \| Yes(%%%%) \| Yes(%%%%) \| No \| No \| Yes \|
	\| Visual C++ 14.10 (2017) \| No \| No \| No \| No \| No \| Yes(%%%%) \| Yes(%%%%) \| Yes \| Yes \| Yes \| Yes \|		\| Visual C++ 14.10 (2017) \| No \| No \| No \| No \| No \| Yes(%%%%) \| Yes(%%%%) \| Yes \| Yes \| Yes \| Yes \|
-	\| Visual C++ 14.20 (2019) \| No \| No \| No \| No \| No \| Yes(%%%%) \| Yes(%%%%) \| Yes(%%%%) \| Yes(%%%%) \| Yes \| Yes \|	+	\| Visual C++ 14.20 (2019) \| No \| No \| No \| No \| No \| No \| No \| Yes(%%%%) \| Yes(%%%%) \| Yes \| Yes \|

	(*) May be dropped before the final release		(*) May be dropped before the final release

installer

Anonymous (anonymous@undisclosed.example.com) — 2025-04-03T13:08:43+00:00

2008/09/11 19:18		current
Line 17:		Line 17:
	- If you are building the installer for the non-thread-safe binaries, include "nts" ( without the quotes ) as the second argument.		- If you are building the installer for the non-thread-safe binaries, include "nts" ( without the quotes ) as the second argument.

-	Example for building for PHP version 5.2.0	+	Example for building for PHP version 5.2.0; the resulting installer filename will be php-5.2.0-win32-VC6-x86-install.msi.
	<code winbatch>		<code winbatch>
	build.bat 5.2.0		build.bat 5.2.0
	</code>		</code>

-	The script will produce the installer as php-VERSION-win32-install.msi where VERSION is the string passed to the build.bat script.	+	Example for building for PHP version 5.2.5 with non-thread-safe binaries; the resulting installer filename will be php-5.2.5-nts-win32-VC6-x86-install.msi.
-		+
-	Example for building for PHP version 5.2.5 with non-thread-safe binaries	+
	<code winbatch>		<code winbatch>
	build.bat 5.2.0 nts		build.bat 5.2.0 nts
	</code>		</code>
-	Example for building for PHP version 5.3.0beta1 with VC9 binaries	+	Example for building for PHP version 5.3.0beta1 with VC9 binaries; the resulting installer filename will be php-5.3.0beta1-win32-VC9-x86-install.msi.
	<code winbatch>		<code winbatch>
	build.bat 5.3.0beta1 vc9		build.bat 5.3.0beta1 vc9
	</code>		</code>
-	Example for building for PHP version 5.3.0 with non-thread-safe and VC9 built binaries	+	Example for building for PHP version 5.3.0 with non-thread-safe and VC9 built binaries; the resulting installer filename will be php-5.3.0-nts-win32-VC9-x86-install.msi.
	<code winbatch>		<code winbatch>
	build.bat 5.3.0 nts vc9		build.bat 5.3.0 nts vc9
	</code>		</code>
-	Example for building for PHP version 5.3.0 with VC9 x64 built binaries	+	Example for building for PHP version 5.3.0 with VC9 x64 built binaries; the resulting installer filename will be php-5.3.0-win32-VC9-x64-install.msi.
	<code winbatch>		<code winbatch>
	build.bat 5.3.0 x64		build.bat 5.3.0 x64
	</code>		</code>
		+	Example for building for PHP version 5.3.0 for a snapshot build; the resulting installer filename will be php-5.3.0-win32-VC6-x86-install-latest.msi.
		+	<code winbatch>
		+	build.bat 5.3.0 latest
		+	</code>

libs

Anonymous (anonymous@undisclosed.example.com) — 2026-03-19T18:54:36+00:00

2025/04/03 13:08		current
Line 1:		Line 1:
	====== Libraries Needed to Build on Windows ======		====== Libraries Needed to Build on Windows ======

-	Libraries are available for download at http://windows.php.net/downloads/php-sdk/ . The sources prepared to be built for PHP are available under https://github.com/winlibs/	+	Libraries are available for download at https://downloads.php.net/~windows/php-sdk/ . The sources prepared to be built for PHP are available under https://github.com/winlibs/

	===== Mandatory =====		===== Mandatory =====

links

Anonymous (anonymous@undisclosed.example.com) — 2025-04-03T13:08:43+00:00

2008/10/28 16:06		current
Line 1:		Line 1:
-	* [[Download Application Verifier\|http://www.microsoft.com/downloads/details.aspx?FamilyID=bd02c19c-1250-433c-8c1b-2619bd93b3a2&DisplayLang=en]]	+	* [[http://www.microsoft.com/downloads/details.aspx?FamilyID=bd02c19c-1250-433c-8c1b-2619bd93b3a2&DisplayLang=en\|Download Application Verifier]]
-	* [[Using Application Verifier\|http://msdn.microsoft.com/en-us/library/aa480483.aspx]]	+	* [[http://msdn.microsoft.com/en-us/library/aa480483.aspx\|Using Application Verifier]]
-	* [[Debugging Tools For Windows\|http://www.microsoft.com/whdc/devtools/debugging/default.mspx]]	+	* [[http://www.microsoft.com/whdc/devtools/debugging/default.mspx\|Debugging Tools For Windows]]
-	* [[Multiple tabs console\|http://sourceforge.net/projects/console/]]	+	* [[http://sourceforge.net/projects/console/\|Multiple tabs console]]

peclbuilds

Anonymous (anonymous@undisclosed.example.com) — 2025-04-03T13:08:43+00:00

2026/05/13 09:12	current
Line 1:	Line 1:
	+	===== How do I get my PECL extension compiling on Windows? =====
	+
	+	1. Does it require a library?
	+
	+	If your extension links to an external library, you will need at least two builds of the library, one with Visual Studio 6 (VC6) and one with Visual Studio 2008 (VC9). We prefer static libraries, so the library can be embedded in the php extension dll, and windows users don't have to mess with anything to get the extension running immediately.
	+
	+	There is a lot of information about libraries at [[internals:windows:libs\| Windows Library Page]] including some guidelines for building.
	+
	+	2. Does it compile with Visual C++?
	+
	+	First of all, any extension needs a config.w32 to compile on windows. This file looks very similiar to a config.m4 and tells the configure system HOW to build your extension. There are lots of extensions both in core and PECL with config.w32 files you can look at for help.
	+
	+	Secondly, you need to be careful with the code itself. VC can be a strict compiler and doesn't like things like declarations all over the place (they must be first in the block) and sometimes has different ways of doing types (long long doesn't work so well). These kind of issues are easier to find once you actually have a config.w32 and are attempting to actually compile the extension.
	+
	+	3. Does it work properly on Windows?
	+
	+	The only way to figure this out is to have good tests for your extension, so you can see if a different OS changes some of your functionality.
	+
	+

pgobuild

Anonymous (anonymous@undisclosed.example.com) — 2025-04-03T13:08:43+00:00

2011/04/06 10:59		current
Line 14:		Line 14:
	- MySQL In order to run thru the PGO training scenarios, you will need MySQL (either 64 bit or 32 bit should be fine) MySQL Can be found [[http://dev.mysql.com/downloads/mysql/5.1.html#win32\|here]]. You can grab either the .zip file or the installer. If you download the installer, read the notes in the Setup section below.		- MySQL In order to run thru the PGO training scenarios, you will need MySQL (either 64 bit or 32 bit should be fine) MySQL Can be found [[http://dev.mysql.com/downloads/mysql/5.1.html#win32\|here]]. You can grab either the .zip file or the installer. If you download the installer, read the notes in the Setup section below.
	- ActivePerl OpenSSL requires [[http://www.activestate.com/activeperl/\|ActivePerl]] to handle part of it’s compilation process.		- ActivePerl OpenSSL requires [[http://www.activestate.com/activeperl/\|ActivePerl]] to handle part of it’s compilation process.
-	- PHP Binary tools a collection of open source utilities needed to build PHP. The tools can be found [[http://pecl2.php.net/downloads/php-windows-builds/php-libs/binary-tools.zip\|here]]	+	- PHP Binary tools a collection of open source utilities needed to build PHP. The tools can be found [[http://windows.php.net/downloads/php-sdk/\|here]]
	- Optional: [[http://www.oracle.com/technology/software/tech/oci/instantclient/htdocs/winsoft.html\|Oracle SDK]] (10.2 and/or 11.1) – Only needed if you want to build the Oracle database extensions. At the time of writing, the following were the files used: ''instantclient-sdk-win32-10.2.0.3-20061115.zip'' and ''instantclient-sdk-win32-11.1.0.7.0.zip''		- Optional: [[http://www.oracle.com/technology/software/tech/oci/instantclient/htdocs/winsoft.html\|Oracle SDK]] (10.2 and/or 11.1) – Only needed if you want to build the Oracle database extensions. At the time of writing, the following were the files used: ''instantclient-sdk-win32-10.2.0.3-20061115.zip'' and ''instantclient-sdk-win32-11.1.0.7.0.zip''
	- PHP PGO Kit and Dependency Source Libraries the source code for all the dependencies libraries that are needed to build PHP.		- PHP PGO Kit and Dependency Source Libraries the source code for all the dependencies libraries that are needed to build PHP.

php-windows-builder

Anonymous (anonymous@undisclosed.example.com) — 2025-08-15T22:18:26+00:00

2025/08/15 22:16		current
Line 50:		Line 50:
	==== Compile ====		==== Compile ====

-	* To build a specific version, use the Version input. It supports values in major.minor.patch format, e.g., ''%%7.4.25%%'', ''%%8.0.12%%'', etc., or ''%%master%%'' for the master branch of ''%%php-src%%''.	+	* To build a specific version, use the PhpVersion input. It supports values in major.minor.patch format, e.g., ''%%7.4.25%%'', ''%%8.0.12%%'', etc., or ''%%master%%'' for the master branch of ''%%php-src%%''.
	* To build a 32-bit or a 64-bit version, use the Arch input. It supports values ''%%x64%%'' and ''%%x86%%''.		* To build a 32-bit or a 64-bit version, use the Arch input. It supports values ''%%x64%%'' and ''%%x86%%''.
	* To build a thread-safe or non-thread-safe version, use the Ts input. It supports values ''%%ts%%'' and ''%%nts%%''.		* To build a thread-safe or non-thread-safe version, use the Ts input. It supports values ''%%ts%%'' and ''%%nts%%''.

-	* Run the build: <code powershell>Invoke-PhpBuild -Version 8.4.11 -Arch x64 -Ts nts</code>	+	* Run the build: <code powershell>Invoke-PhpBuild -PhpVersion 8.4.11 -Arch x64 -Ts nts</code>

	* To build PHP from a local source, run ''%%Invoke-PhpBuild%%'' from the source directory and omit the ''%%PhpVersion%%'' input: <code powershell>Invoke-PhpBuild -Arch x64 -Ts nts</code>		* To build PHP from a local source, run ''%%Invoke-PhpBuild%%'' from the source directory and omit the ''%%PhpVersion%%'' input: <code powershell>Invoke-PhpBuild -Arch x64 -Ts nts</code>

-	* It should produce the PGO optimized builds for the input PHP version and configuration in a directory named artifacts in the current directory.	+	* It should produce the PGO optimized PHP builds in a directory named artifacts in the current directory.

	===== Building PHP extensions =====		===== Building PHP extensions =====

release

Anonymous (anonymous@undisclosed.example.com) — 2025-04-03T13:08:43+00:00

2008/12/08 21:59		current
Line 25:		Line 25:


-	===== PHP 6 =====	+	===== PHP 5.3.x =====
	==== Thread Safe ====		==== Thread Safe ====
	<code bash>		<code bash>
-	--enable-snapshot-build --enable-debug-pack --without-static-icu --with-pdo-oci=C:\php-sdk\oracle\instantclient10\sdk,shared --with-oci8=C:\php-sdk\oracle\instantclient10\sdk,shared --with-oci8-11g=C:\php-sdk\oracle\instantclient11\sdk,shared	+	configure.bat --enable-snapshot-build --enable-debug-pack --with-pdo-oci=C:\php-sdk\oracle\instantclient10\sdk,shared --with-oci8=C:\php-sdk\oracle\instantclient10\sdk,shared --with-oci8-11g=C:\php-sdk\oracle\instantclient11\sdk,shared
	</code>		</code>

	==== Non Thread Safe ====		==== Non Thread Safe ====
	<code bash>		<code bash>
-	--enable-snapshot-build --enable-debug-pack --without-static-icu --disable-zts --disable-isapi --disable-nsapi --with-pdo-oci=C:\php-sdk\oracle\instantclient10\sdk,shared --with-oci8=C:\php-sdk\oracle\instantclient10\sdk,shared --with-oci8-11g=C:\php-sdk\oracle\instantclient11\sdk,shared	+	configure.bat --enable-snapshot-build --enable-debug-pack --disable-zts --disable-isapi --disable-nsapi --with-pdo-oci=C:\php-sdk\oracle\instantclient10\sdk,shared --with-oci8=C:\php-sdk\oracle\instantclient10\sdk,shared --with-oci8-11g=C:\php-sdk\oracle\instantclient11\sdk,shared
	</code>		</code>

-	===== PHP 5.3.x =====	+	===== PHP 6 =====
	==== Thread Safe ====		==== Thread Safe ====
	<code bash>		<code bash>
-	--enable-snapshot-build --enable-debug-pack --with-pdo-oci=C:\php-sdk\oracle\instantclient10\sdk,shared --with-oci8=C:\php-sdk\oracle\instantclient10\sdk,shared --with-oci8-11g=C:\php-sdk\oracle\instantclient11\sdk,shared	+	configure.bat --enable-snapshot-build --enable-debug-pack --without-static-icu --with-pdo-oci=C:\php-sdk\oracle\instantclient10\sdk,shared --with-oci8=C:\php-sdk\oracle\instantclient10\sdk,shared --with-oci8-11g=C:\php-sdk\oracle\instantclient11\sdk,shared
	</code>		</code>

	==== Non Thread Safe ====		==== Non Thread Safe ====
	<code bash>		<code bash>
-	--enable-snapshot-build --enable-debug-pack --disable-zts --disable-isapi --disable-nsapi --with-pdo-oci=C:\php-sdk\oracle\instantclient10\sdk,shared --with-oci8=C:\php-sdk\oracle\instantclient10\sdk,shared --with-oci8-11g=C:\php-sdk\oracle\instantclient11\sdk,shared	+	configure.bat --enable-snapshot-build --enable-debug-pack --without-static-icu --disable-zts --disable-isapi --disable-nsapi --with-pdo-oci=C:\php-sdk\oracle\instantclient10\sdk,shared --with-oci8=C:\php-sdk\oracle\instantclient10\sdk,shared --with-oci8-11g=C:\php-sdk\oracle\instantclient11\sdk,shared
	</code>		</code>
-	The box is 64 bit - so 64 bit builds are possible in the future.	+

releasenotes

Anonymous (anonymous@undisclosed.example.com) — 2025-04-03T13:08:43+00:00

2008/07/31 21:43		current
Line 11:		Line 11:

	==== New Libraries ====		==== New Libraries ====
-	Many dependent libraries have been updated to their latest versions, which means which means new features (up to the latest available in the unix world), bugfixes and security fixes.	+	Many dependent libraries have been updated to their latest versions, which means new features (up to the latest available in the unix world), bugfixes and security fixes.

	==== New Builds ====		==== New Builds ====

stepbystepbuild_sdk_2

Anonymous (anonymous@undisclosed.example.com) — 2026-03-19T18:52:57+00:00

2025/04/03 13:08		current
Line 19:		Line 19:
	* Visual C++ 15.0 (Visual Studio 2017) for PHP 7.2, PHP 7.3 or PHP 7.4.		* Visual C++ 15.0 (Visual Studio 2017) for PHP 7.2, PHP 7.3 or PHP 7.4.
	* Visual C++ 16.0 (Visual Studio 2019) for PHP 8.0, PHP 8.1, PHP 8.2 or PHP 8.3.		* Visual C++ 16.0 (Visual Studio 2019) for PHP 8.0, PHP 8.1, PHP 8.2 or PHP 8.3.
-	* Visual C++ 17.0 (Visual Studio 2022) for PHP 8.4.	+	* Visual C++ 17.0 (Visual Studio 2022) for PHP 8.4 or PHP 8.5.

	Always keep your installed Visual C++ up to date. Otherwise build errors may occur due to dependencies built with newer versions.		Always keep your installed Visual C++ up to date. Otherwise build errors may occur due to dependencies built with newer versions.
Line 36:		Line 36:
	* If compiling PHP 7.2+:		* If compiling PHP 7.2+:
	* Install Visual Studio 2017		* Install Visual Studio 2017
-	* If compiling **master**:	+	* If compiling **PHP 7.4+**:
	* Install Visual Studio 2019		* Install Visual Studio 2019
		+	* If compiling PHP 8.4+ or master:
		+	* Install Visual Studio 2022

	* Optional tools		* Optional tools
Line 66:		Line 68:

	- Get the PHP source, there are two alternatives:		- Get the PHP source, there are two alternatives:
-	* download a source archive ([[http://windows.php.net/download/\|Stable releases]], [[http://windows.php.net/qa/\|QA releases]])	+	* download a source archive ([[https://www.php.net/downloads?usage=web&os=windows&osvariant=windows-downloads\|Stable releases]], [[https://www.php.net/pre-release-builds.php#windows\|QA releases]])
-	* clone the [[http://git.php.net/\|PHP Git repository]] ([[https://github.com/php/php-src\|GitHub mirror]])	+	* clone the [[https://github.com/php/php-src/\|PHP Git repository]]
	- Get the binary tools:		- Get the binary tools:
	* available from [[https://github.com/php/php-sdk-binary-tools]]		* available from [[https://github.com/php/php-sdk-binary-tools]]
Line 73:		Line 75:
	- Get the libraries on which PHP depends:		- Get the libraries on which PHP depends:
	* use the PHP SDK tools to fetch the suitable dependencies automatically by calling ''phpsdk_deps -u''		* use the PHP SDK tools to fetch the suitable dependencies automatically by calling ''phpsdk_deps -u''
-	* alternatively, download the packaged deps from [[http://windows.php.net/downloads/php-sdk/deps/]] choosing the matching VC++ version and architecture directory. Note the .7z packages are not provided anymore for PHP 7.2 and up.	+	* alternatively, download the packaged deps from [[https://downloads.php.net/~windows/php-sdk/deps/]] choosing the matching VC++ version and architecture directory. Note the .7z packages are not provided anymore for PHP 7.2 and up.
-	* Note: This should include the libraries needed to build most the core extensions. However, some other extensions may need additional libraries, header files and helper apps. See [[internals/windows/libs]], fetch the version you need and extract the archive into the deps directory (see below). Another set of libraries used for the PECL extension builds is available under [[http://windows.php.net/downloads/pecl/deps/\|PECL deps directory]]. If required, they need to be fetched manually.	+	* Note: This should include the libraries needed to build most the core extensions. However, some other extensions may need additional libraries, header files and helper apps. See [[internals/windows/libs]], fetch the version you need and extract the archive into the deps directory (see below). Another set of libraries used for the PECL extension builds is available under [[https://downloads.php.net/~windows/pecl/deps/\|PECL deps directory]]. If required, they need to be fetched manually.

	===== Setup the build directory =====		===== Setup the build directory =====
Line 143:		Line 145:
	Alternatively to the "in-tree" build described above, you can do a "phpize" build, what is mostly useful if you don't need to build PHP from source, but rather use a pre-built PHP binary package.		Alternatively to the "in-tree" build described above, you can do a "phpize" build, what is mostly useful if you don't need to build PHP from source, but rather use a pre-built PHP binary package.

-	- Download and unpack the development package which corresponds to your pre-built PHP version and variant from https://windows.php.net/	+	- Download and unpack the development package which corresponds to your pre-built PHP version and variant from https://www.php.net/downloads.php?os=windows&osvariant=windows-downloads
	- Download and unpack the source of the PECL extension		- Download and unpack the source of the PECL extension
	- Invoke the starter script to automatically setup the environment for the desired build config, e.g. ''c:\php-sdk\phpsdk-vs16-x64.bat''		- Invoke the starter script to automatically setup the environment for the desired build config, e.g. ''c:\php-sdk\phpsdk-vs16-x64.bat''
Line 152:		Line 154:
	* the most important option is the one which enables the extension to be built (e.g. ''--enable-apcu'')		* the most important option is the one which enables the extension to be built (e.g. ''--enable-apcu'')
	* another important options is ''--with-prefix'' which expects the PHP folder to be passed		* another important options is ''--with-prefix'' which expects the PHP folder to be passed
-	* if the extension depends on C libraries, you need to download these and put them either in the ''--with-php-build'' folder, or use the ''--with-extra-includes'' and ''--with-extra-libs'' options; suitable pre-built libraries can be found on https://windows.php.net/downloads/php-sdk/deps/ and https://windows.php.net/downloads/pecl/deps/	+	* if the extension depends on C libraries, you need to download these and put them either in the ''--with-php-build'' folder, or use the ''--with-extra-includes'' and ''--with-extra-libs'' options; suitable pre-built libraries can be found on https://downloads.php.net/~windows/php-sdk/deps/ and https://downloads.php.net/~windows/pecl/deps/
	* there may be further interesting configuration options, e.g. those which allows to configure details of the extension to be built		* there may be further interesting configuration options, e.g. those which allows to configure details of the extension to be built
	- Run ''configure'' with the desired options		- Run ''configure'' with the desired options

stepbystepbuild

Anonymous (anonymous@undisclosed.example.com) — 2025-04-03T13:08:43+00:00

2017/11/20 17:36		current
Line 1:		Line 1:
	====== Build your own PHP on Windows ======		====== Build your own PHP on Windows ======

-	This tutorial concerns building PHP before 7.2. To build PHP 7.2+, please refer to the [[internals:windows:stepbystepbuild_sdk_2\|newer documentation]].	+	> This tutorial concerns building PHP before 7.2. To build PHP 7.2+, please refer to the [[internals:windows:stepbystepbuild_sdk_2\|newer documentation]].

	===== Before you Begin =====		===== Before you Begin =====

todo_bak_0

Anonymous (anonymous@undisclosed.example.com) — 2025-04-03T13:08:43+00:00

2026/05/13 09:12	current
Line 1:	Line 1:
	+	====== Todo ======

	+	NOTE this is an older version of the TODOs, the current TODOs are available under [[https://wiki.php.net/internals/windows/todo]]
	+
	+
	+
	+	===== Library Stuff =====
	+	- Decide if we will distribute, third party but we will build/distribute, and third party we can't touch them
	+	- Build and distribute libs (and source/makefiles/etc)
	+	- Update on a regular basis with new libs
	+	- Keep version information and dates current with new builds
	+	- recruit additional help with building libraries
	+	- Document the process of getting a new library in our build systems (rules, naming, platform support, etc.)
	+
	+
	+
	+
	+
	+	===== Code =====
	+
	+	- Compiler warning killing spree (Kalle)
	+	- lower deprecation to _CRT_SECURE_NO_DEPRECATE _CRT_NONSTDC_NO_DEPRECATE instead of /wd4996 - and kill new warnings
	+	- remove no deprecate warnings and fix core to use new API (probably not until 6.0)
	+	- get 6.0 compiling with unicode flag? (that would be fun)
	+	- Code audit for problem areas (streams/sockets and process control are two that come to mind)
	+
	+	===== Missing function implementations =====
	+	Core/Standard:
	+	- [[http://docs.php.net/proc_nice\| proc_nice]] -- See: http://news.php.net/php.internals.win/633
	+	- [[http://docs.php.net/lchown\| lchown]]
	+	- [[http://docs.php.net/lchgrp\| lchgrp]]
	+	- [[http://docs.php.net/getrusage\| getrusage]]
	+	- [[http://docs.php.net/sys_getloadavg\| sys_getloadavg]]
	+	- [[http://docs.php.net/nl_langinfo\| nl_langinfo]]
	+	- [[http://docs.php.net/money_format\| money_format]]
	+	- [[http://docs.php.net/chroot\| chroot]]
	+	- [[http://docs.php.net/strptime\| strptime]]
	+	- [[http://docs.php.net/ftok\| ftok]]
	+
	+	Extensions:
	+	- (gd) [[http://docs.php.net/imagecreatefromxpm\| imagecreatefromxpm]]
	+
	+	SAPIs:
	+	- (apache) [[http://docs.php.net/apache_child_terminate\| apache_child_terminate]]
	+
	+	===== Compiler warnings =====
	+
	+	=== Linker etc. warnings ===
	+	* ext/gettext: generates a MSIL .netmodule or module compiled with /GL; add /LTCG to the link command line to improve linker performance
	+	* ext/gd: generates a LNK4098 (default lib conflicts with use of other libs)
	+	* ext/iconv: generates a MSIL .netmodule or module compiled with /GL; add /LTCG to the linker command line to improve linker performance
	+	* ext/xmlreader: generates two LNK4049 (locally defined symbol imported)
	+	* sapi/cli: readline generates U4004 (too many rules for target)
	+	* sapi/embed: generates multiple LNK4044 (unrecognized option)
	+
	+	===== Configure system =====
	+	- equivalent of phpize on windows (one extension configure/compile)
	+	- configs for extensions that can be done for windows (ncurses et al)
	+
	+	===== PHP Build Box =====
	+	- create release build system
	+	- move all pecl extension building to pecl (pecl snaps on pecl)
	+
	+	===== PECL Build Box =====
	+
	+	- Get builds going for snaps (SVN versions), release versions, and alpha/beta if applicable
	+
	+	===== Windows GCOV Box =====
	+
	+	- Auto building and testing similar to [[http://gcov.php.net/ \| gcov]], only for windows
	+
	+
	+	===== Documentation =====
	+	- Update the [[http://php.net/install.windows.building\|official Windows build]] documentation
	+	- Update the [[http://php.net/install.pecl.windows.php\|PECL on Windows]] documentation
	+	- Update related FAQs: ([[http://php.net/manual/en/faq.obtaining.php#faq.obtaining.optional\|obtaining libraries]] and [[http://us3.php.net/manual/en/faq.obtaining.php#faq.obtaining.compileNT\|compiling needs]])
	+	- A recent post about [[http://markmail.org/message/c7hz3yycg4mvyje5\|installation doc needs]]

todo

Anonymous (anonymous@undisclosed.example.com) — 2025-04-03T13:08:43+00:00

2020/05/20 09:51		current
Line 12:		Line 12:

	- do necessary ports to streams for more native I/O API usage		- do necessary ports to streams for more native I/O API usage
-	- support multibyte filenames	+	- <del>support multibyte filenames</del>((http://git.php.net/?p=php-src.git;a=commit;h=3d3f11ede4cc7c83d64cc5edaae7c29ce9c6986f))
-	- supports filenames longer than 256 bytes	+	- <del>supports filenames longer than 256 bytes</del>((http://git.php.net/?p=php-src.git;a=commit;h=3d3f11ede4cc7c83d64cc5edaae7c29ce9c6986f))

	===== Missing function implementations =====		===== Missing function implementations =====

todocumentdev

Anonymous (anonymous@undisclosed.example.com) — 2025-04-03T13:08:43+00:00

2012/03/21 21:57		current
Line 75:		Line 75:
	== Building APC ==		== Building APC ==
	= without debug =		= without debug =
-	* download a debug pack from http://windows.php.net/downloads/releases/ , for instance php-devel-pack-5.4.0-Win32-VC9-x86.zip	+	* download a development pack from http://windows.php.net/downloads/releases/ , for instance php-devel-pack-5.4.0-Win32-VC9-x86.zip
	* unpack to c:\php-devel-pack-5.4.0-Win32-VC9-x86		* unpack to c:\php-devel-pack-5.4.0-Win32-VC9-x86
	* checkout APC to c:\apc_trunk		* checkout APC to c:\apc_trunk
Line 87:		Line 87:
	* nmake		* nmake
	= with debug =		= with debug =
-	TODO	+	* TODO
	== Debugging APC ==		== Debugging APC ==
	= without debug =		= without debug =
	* nmake test		* nmake test
	= with debug =		= with debug =
-	TODO	+	* TODO

windowssdk

Anonymous (anonymous@undisclosed.example.com) — 2025-04-03T13:08:43+00:00

2010/01/08 21:11		current
Line 20:		Line 20:

	INSTALL THE FULL SDK IF YOU DO NOT WANT TO RUN IN ALL POSSIBLE ISSUES AFTERWARDS, EVEN IF OTHER DOCS/TUTORIALS/PERSONS RECOMMEND TO ONLY INSTALL PART OF IT. We won't help you if it is not fully installed.		INSTALL THE FULL SDK IF YOU DO NOT WANT TO RUN IN ALL POSSIBLE ISSUES AFTERWARDS, EVEN IF OTHER DOCS/TUTORIALS/PERSONS RECOMMEND TO ONLY INSTALL PART OF IT. We won't help you if it is not fully installed.
		+
		+	==== Note ====
		+
		+	If you are creating your setup from scratch, then please read the following notice and blogs from Microsoft regarding an issue of installing the 6.1 SDK on top of VC9 SP1 :
		+	- [[http://www.microsoft.com/downloads/en/details.aspx?FamilyID=e6e1c3df-a74f-4207-8586-711ebe331cdc&displaylang=en\|Windows SDK for Windows Server 2008 and .NET Framework 3.5]]
		+	- [[http://blogs.msdn.com/b/windowssdk/archive/2009/08/07/windows-sdk-for-server-2008-v6-1-overwrites-vs2008-sp1-crt-files.aspx\|Windows SDK for Server 2008 (v6.1) overwrites VS2008 SP1 CRT files]]
		+	- [[http://blogs.msdn.com/b/windowssdk/archive/2009/08/07/installing-windows-sdk-for-server-2008-v6-1-after-vs2008-sp1-causes-conflicts-with-security-update-kb971092.aspx\|Installing Windows SDK for Server 2008 (v6.1) after VS2008 SP1 causes conflicts with Security Update (KB971092)]]
		+
		+	Installing the 6.1 SDK before installing VC9SP1 is the recommended route. After that, any additional security patches or updates can be applied.
		+

2008/10/28 16:06		current
Line 1:		Line 1:
-	* [[Download Application Verifier\|http://www.microsoft.com/downloads/details.aspx?FamilyID=bd02c19c-1250-433c-8c1b-2619bd93b3a2&DisplayLang=en]]	+	* [[http://www.microsoft.com/downloads/details.aspx?FamilyID=bd02c19c-1250-433c-8c1b-2619bd93b3a2&DisplayLang=en\|Download Application Verifier]]
-	* [[Using Application Verifier\|http://msdn.microsoft.com/en-us/library/aa480483.aspx]]	+	* [[http://msdn.microsoft.com/en-us/library/aa480483.aspx\|Using Application Verifier]]
-	* [[Debugging Tools For Windows\|http://www.microsoft.com/whdc/devtools/debugging/default.mspx]]	+	* [[http://www.microsoft.com/whdc/devtools/debugging/default.mspx\|Debugging Tools For Windows]]
-	* [[Multiple tabs console\|http://sourceforge.net/projects/console/]]	+	* [[http://sourceforge.net/projects/console/\|Multiple tabs console]]

2011/04/06 10:59		current
Line 14:		Line 14:
	- MySQL In order to run thru the PGO training scenarios, you will need MySQL (either 64 bit or 32 bit should be fine) MySQL Can be found [[http://dev.mysql.com/downloads/mysql/5.1.html#win32\|here]]. You can grab either the .zip file or the installer. If you download the installer, read the notes in the Setup section below.		- MySQL In order to run thru the PGO training scenarios, you will need MySQL (either 64 bit or 32 bit should be fine) MySQL Can be found [[http://dev.mysql.com/downloads/mysql/5.1.html#win32\|here]]. You can grab either the .zip file or the installer. If you download the installer, read the notes in the Setup section below.
	- ActivePerl OpenSSL requires [[http://www.activestate.com/activeperl/\|ActivePerl]] to handle part of it’s compilation process.		- ActivePerl OpenSSL requires [[http://www.activestate.com/activeperl/\|ActivePerl]] to handle part of it’s compilation process.
-	- PHP Binary tools a collection of open source utilities needed to build PHP. The tools can be found [[http://pecl2.php.net/downloads/php-windows-builds/php-libs/binary-tools.zip\|here]]	+	- PHP Binary tools a collection of open source utilities needed to build PHP. The tools can be found [[http://windows.php.net/downloads/php-sdk/\|here]]
	- Optional: [[http://www.oracle.com/technology/software/tech/oci/instantclient/htdocs/winsoft.html\|Oracle SDK]] (10.2 and/or 11.1) – Only needed if you want to build the Oracle database extensions. At the time of writing, the following were the files used: ''instantclient-sdk-win32-10.2.0.3-20061115.zip'' and ''instantclient-sdk-win32-11.1.0.7.0.zip''		- Optional: [[http://www.oracle.com/technology/software/tech/oci/instantclient/htdocs/winsoft.html\|Oracle SDK]] (10.2 and/or 11.1) – Only needed if you want to build the Oracle database extensions. At the time of writing, the following were the files used: ''instantclient-sdk-win32-10.2.0.3-20061115.zip'' and ''instantclient-sdk-win32-11.1.0.7.0.zip''
	- PHP PGO Kit and Dependency Source Libraries the source code for all the dependencies libraries that are needed to build PHP.		- PHP PGO Kit and Dependency Source Libraries the source code for all the dependencies libraries that are needed to build PHP.