svn: /phpdoc/ doc-base/trunk/entities/global.ent en/trunk/reference/wincache/book.xml en/trunk/reference/wincache/win32build.xml

From: Date: Fri, 13 Nov 2009 06:43:13 +0000
Subject: svn: /phpdoc/ doc-base/trunk/entities/global.ent en/trunk/reference/wincache/book.xml en/trunk/reference/wincache/win32build.xml
Groups: php.doc.cvs 
Request: Send a blank email to doc-cvs+get-5335@lists.php.net to get a copy of this message
ruslany Fri, 13 Nov 2009 06:43:13 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=290663 Log: Added section about how to build WinCache on Windows. Changed paths: U phpdoc/doc-base/trunk/entities/global.ent U phpdoc/en/trunk/reference/wincache/book.xml A phpdoc/en/trunk/reference/wincache/win32build.xml Modified: phpdoc/doc-base/trunk/entities/global.ent =================================================================== --- phpdoc/doc-base/trunk/entities/global.ent 2009-11-13 06:15:26 UTC (rev 290662) +++ phpdoc/doc-base/trunk/entities/global.ent 2009-11-13 06:43:13 UTC (rev 290663) @@ -374,6 +374,7 @@ <!ENTITY url.php.dochowto "http://doc.php.net/php/dochowto/"> <!ENTITY url.php.downloads "http://www.php.net/downloads.php"> <!ENTITY url.php.win.downloads "http://windows.php.net/download/"> +<!ENTITY url.php.win.build "http://wiki.php.net/internals/windows/stepbystepbuild"> <!ENTITY url.php.echm "http://www.php.net/docs-echm.php"> <!ENTITY url.php.gtk "http://gtk.php.net/"> <!ENTITY url.php.hosts "http://www.php.net/links.php#hosts"> Modified: phpdoc/en/trunk/reference/wincache/book.xml =================================================================== --- phpdoc/en/trunk/reference/wincache/book.xml 2009-11-13 06:15:26 UTC (rev 290662) +++ phpdoc/en/trunk/reference/wincache/book.xml 2009-11-13 06:43:13 UTC (rev 290663) @@ -59,6 +59,7 @@ &reference.wincache.setup; &reference.wincache.constants; &reference.wincache.reference; + &reference.wincache.win32build; </book> Added: phpdoc/en/trunk/reference/wincache/win32build.xml =================================================================== --- phpdoc/en/trunk/reference/wincache/win32build.xml (rev 0) +++ phpdoc/en/trunk/reference/wincache/win32build.xml 2009-11-13 06:43:13 UTC (rev 290663) @@ -0,0 +1,136 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1 $ --> +<appendix xml:id="wincache.win32build" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>Building for Windows</title> + <section xml:id="wincache.win32build.prereq"> + <title>Prerequisites</title> + <para> + Building WinCache extension will require: + </para> + <orderedlist spacing="compact"> + <listitem> + <simpara>PHP source code</simpara> + </listitem> + <listitem> + <simpara>PHP build environment</simpara> + </listitem> + <listitem> + <simpara>WinCache source code</simpara> + </listitem> + </orderedlist> + <para> + For completing first two steps, follow the step-by-step guide for how + to <link xlink:href="&url.php.win.build;">build PHP on Windows</link>. + </para> + <para> + For getting the WinCache source code follow the instructions described in + <link linkend="install.pecl.downloads">Downloading PECL extensions</link>. + </para> + </section> + <section xml:id="wincache.win32build.building"> + <title>Compiling and building</title> + <para> + The following steps describe how to compile and build WinCache on Windows OS: + </para> + <procedure> + <step> + <simpara>Open a command prompt which is used to build PHP</simpara> + </step> + <step> + <simpara>Go to the root folder where PHP sources are present</simpara> + </step> + <step> + <para> + Run the command: + <programlisting role="cmd"> +<![CDATA[ +cscript.exe win32\build\buildconf.js +]]> + </programlisting> + </para> + </step> + <step> + <para> + Run the command: + <programlisting role="cmd"> +<![CDATA[ +configure.bat --help +]]> + </programlisting> + The output will contain a new flag <literal>--enable-wincache</literal>. + </para> + </step> + <step> + <para> + Run the command: + <programlisting role="cmd"> +<![CDATA[ +configure.js [all options used to build PHP] --enable-wincache +]]> + </programlisting> + <literal>--enable-wincache</literal> is the only extra option which is + required to ensure that WinCache extension gets built properly. + This option will build WinCache and will statically link it with PHP dll. + To build WinCache extension as a stand-alone DLL use the option + <literal>--enable-wincache=shared</literal>. + </para> + </step> + <step> + <para> + Run the command: + <programlisting role="cmd"> +<![CDATA[ +nmake +]]> + </programlisting> + </para> + </step> + </procedure> + </section> + <section xml:id="wincache.win32build.verify"> + <title>Verifying the build</title> + <para> + The following steps describe how to verify that WinCache has been built correctly: + </para> + <procedure> + <step> + <simpara> + Go to the folder where the PHP binaries are built + </simpara> + </step> + <step> + <para> + Run the command: + <programlisting role="cmd"> +<![CDATA[ +php.exe -n -d extension=php_wincache.dll -re wincache +]]> + </programlisting> + If WinCache has been built properly, the output of this command will + list the INI directives and functions supported by WinCache. + </para> + </step> + </procedure> + </section> +</appendix> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"~/.phpdoc/manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +-->

« previous php.doc.cvs (#5335) next »